Een rasterafbeeldingselement uploaden uploading-an-image-asset-or-a-vector-asset

Voordat u een afbeeldingselement kunt uploaden, vraagt u eerst om een sleutel voor een gedeeld geheim. U gebruikt deze sleutel voor gedeeld geheim om een token voor uploaden op te halen. Vervolgens gebruikt u het token voor uploaden om rasterafbeeldingselementen te uploaden.

IMPORTANT
Vanaf 1 mei 2023 zijn UGC-elementen in Dynamic Media beschikbaar voor gebruik tot 60 dagen na de datum van uploaden. Na 60 dagen worden de middelen verwijderd.
NOTE
De ondersteuning voor nieuwe of bestaande UGC-vectorelementen in Adobe Dynamic Media Classic liep af op 30 september 2021.

Een gedeelde geheime sleutel aanvragen requesting-a-shared-secret-key

Verzoek a gedeelde-geheime sleutel door ​ gebruikend Admin Console om een steungeval tot stand te brengen. In het geval van de technische steun, verzoek een gedeeld-geheime sleutel.

Geef in het e-mailbericht de bedrijfsnaam op die u wilt gebruiken om afbeeldingselementen te uploaden. Nadat u de sleutel van Adobe Dynamic Media Classic ontvangt, bewaar het plaatselijk voor toekomstig gebruik.

Het uploadtoken ophalen retrieving-the-upload-token

Het uploadt teken zorgt ervoor dat niemand de zelfde delen-geheime sleutel kan gebruiken om activa te uploaden. Het zorgt ervoor dat de upload legitiem is en uit een vertrouwde bron komt.

Het uploadtoken is een alfanumerieke tekenreeks die alleen voor een bepaalde hoeveelheid tijd beschikbaar is. Gebruik de volgende URL's, waarbij u de sleutel voor een gedeeld geheim vervangt, zodat u het token voor uploaden kunt ophalen.

  • Rasterafbeelding
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602 In dit voorbeeld, is de gedeelde-geheime sleutel fece4b21-87ee-47fc-9b99-2e29b78b602

Standaard verloopt het uploadtoken vijf minuten (300 seconden) nadat u het hebt opgehaald. Als u meer tijd wilt aanvragen, neemt u expires op in de URL en neemt u de hoeveelheid tijd op die u nodig hebt in seconden. Met de volgende voorbeeld-URL van de afbeelding wordt bijvoorbeeld een uploadtoken opgehaald dat 1800 seconden geldig is:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

De geslaagde reactie voor afbeeldingen ziet er ongeveer als volgt uit:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
        <serviceName>User Generated Content: Images</serviceName>
        <version>1.0.0</version>
        <operationName>get_uploadtoken</operationName>
        <serviceStatus>SUCCESS</serviceStatus>
        <title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
        <message>
            <uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
            <expiration_in_seconds>1800</expiration_in_seconds>
        </message>
        </response>
    </user_generated_content>
</scene7>

Sla het token voor uploaden lokaal op voor gebruik met toekomstige aanvragen.

U kunt de volgende velden in de URL-queryreeks gebruiken om een token voor uploaden op te halen:

URL-parameter
Vereist of optioneel
Waarde
op
Vereist
get_uploadtoken
shared_geheime
Vereist
De sleutel van het gedeelde geheim voor het bedrijf dat uploadt.
verloopt
Optioneel
Aantal seconden dat de uploadtoken geldig is. De standaardwaarde is 300 seconden, indien niet opgegeven.

het roosterbeeld URL van de steekproef:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600

Toegestane methodes van HTTP:
GET en POST

U kunt nu een afbeeldingselement uploaden.

Zie ​ een beeldactiva ​ uploaden.

Een rasterafbeeldingselement uploaden uploading-an-image-asset

Nadat u een uploadtoken hebt opgehaald dat gedurende een bepaalde periode geldig is, kunt u een afbeeldingselement uploaden. U uploadt het element als multipart/form post terwijl het verzenden van de rest waarden als URL vraagkoord, zoals aangetoond in dit voorbeeld:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

De velden upload_token en company_name zijn vereist.

Zie ​ het uploadteken ​ terugwinnen.

Zie ​ een gedeelde-geheime sleutel ​ terugwinnen.

U kunt ook andere optionele waarden verzenden als URL-querytekenreeksen, zoals in dit voorbeeld:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif

De parameter file_limit geeft de maximale bestandsgrootte op in bytes. De parameter file_exts geeft de bestandsextensies op die mogen worden geüpload. Beide waarden zijn optioneel.

Er wordt een algemene limiet ingesteld in de toepassing voor de maximale bestandsgrootte en de toegestane bestandsextensies. Als wat u in het verzoek verzendt een ondergroep van de globale grenzen is, wordt het gehonoreerd. De globale limieten zijn als volgt:

Globale limiet
Waarde
Bestandsgrootte voor alle clients
20 MB
Ondersteunde bestandsindelingen voor afbeeldingen die u wilt uploaden
BMP, GIF, JPG, PNG, PSD, TIFF

Met het volgende HTML-formulier kan een gebruiker een element uploaden. In het formulier wordt de gebruiker gevraagd de volgende gegevens in te voeren:

  • Een bedrijfsnaam.
  • Een token voor uploaden.
  • Een maximale bestandsgrootte.
  • Een lijst met bestandsextensies.
  • Of het kleurprofiel en de bestandsnaam die aan het element zijn gekoppeld, behouden moeten blijven.
  • Of een uitneemachtergrond wordt gebruikt. Als u Achtergrond uitnemen inschakelt, stelt u de Hoek, Tolerantie en Vulmethode in.
    Zie Achtergrond van het Uitnemen in ​ Beeld fijnafstemmen opties bij upload ​.
  • The name of the file to upload.

U kunt de broncode van HTML bekijken verbonden aan de vorm hierboven door ​ https://s7ugc1.scene7.com/ugc/upload.html ​ te selecteren

Klik in Firefox met de rechtermuisknop in het browservenster en selecteer vervolgens View Page Source . De code toont de corresponderende URL-queryreeks en de POST-methode die worden uitgevoerd wanneer de gebruiker Submit selecteert.

Ga naar View > Source om de XML-reactie in Internet Explorer weer te geven. Ga naar Tools > Browser Tools > Web Developer Tools om de XML-reactie in Firefox weer te geven. Firefox wordt aanbevolen voor het weergeven van XML-reacties.

Hier volgt een voorbeeldreactie van een geslaagde upload:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
            <serviceName>User Generated Content: Images</serviceName>
            <version>1.0.0</version>
            <operationName>upload</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>Your file has been uploaded Successfully.</title>
            <message>
            <url>https://s7w2p1.scene7.com/is/image/ </url>
            <path>000Company/ugc/1442564.tif</path>
            <fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
            </message>
        </response>
    </user_generated_content>
</scene7>
NOTE
Het geüploade element (JPG, GIF, enzovoort) wordt geconverteerd naar de PTIFF-indeling en de reactie verstuurt een directe koppeling naar dat PTIFF-element.

Het middel is als om het even welke andere bron ImageServing; u kunt verwerkingsvragen op het toepassen. De volgende URL vraagt bijvoorbeeld om een element dat naar de opgegeven breedte en hoogte wordt uitgerekt.

https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

Verzend het element dat u wilt uploaden als multipart/form-post terwijl u de overige waarden verzendt als een URL-queryreeks. U kunt de volgende velden in de URL-queryreeks gebruiken om een element te uploaden:

URL-parameter
Vereist of optioneel
Waarde
op
Vereist
uploaden
upload_token
Vereist
Upload een token voor de sleutel voor gedeeld geheim die aan het bedrijf is gekoppeld.
company_name
Vereist
Naam van het bedrijf dat de upload uitvoert.
file_limit
Optioneel
Bestandsgroottelimiet, in bytes, voor het element.
file_exts
Optioneel
Lijst met toegestane extensies voor het afbeeldingselementbestand.
preserve_colorprofile
Optioneel
Behoudt een ingesloten kleurprofiel terwijl het geüploade bestand wordt geconverteerd naar PTIFF-indeling. Mogelijke waarden zijn true of false. De standaardwaarde is false.
preserve_filename
Optioneel
De bestandsnaam van het geüploade element blijft behouden. Mogelijke waarden zijn true of false. De standaardwaarde is false.
NOTE
U moet het element dat u wilt uploaden verzenden als het enige veld in een POST-aanvraag met meerdere delen.

Steekproef URL:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

Toegestane methode van HTTP:

POST

Metagegevens van elementen ophalen voor afbeeldingen getting-asset-metadata-for-images

U kunt image_info gebruiken om metagegevens op te halen voor een element dat u hebt geüpload, zoals in het volgende voorbeeld wordt getoond:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Een voorbeeld van een succesvolle reactie lijkt op het volgende:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
            <serviceName>User Generated Content: Images</serviceName>
            <version>1.0.0</version>
            <operationName>image_info</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>More information on 1442564.tif</title>
            <message>
            File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
            <imageFormat>Tiff</imageFormat>
            <colorSpace>Rgb</colorSpace>
            <width>686</width>
            <height>457</height>
            </message>
        </response>
    </user_generated_content>
</scene7>

U kunt de volgende velden in de URL-queryreeks gebruiken om informatie voor een element op te vragen:

URL-parameter
Vereist of optioneel
Waarde
op
Vereist
image_info
shared_secret
Vereist
De sleutel die gedeeld-geheim voor het bedrijf is.
image_name
Vereist
Naam van de afbeelding.

Steekproef URL:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Toegestane methode van HTTP:

GET en POST

recommendation-more-help
ba789e76-bace-4e0e-bd26-52691fb2cb26