Documentatie Dynamic Media Classic Guide

Een rasterafbeeldingselement uploaden

Laatst bijgewerkt: 16 mei 2024

Onderwerpen:
Dynamic Media Classic

Gemaakt voor:

tussenpersoon
Gebruiker

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-middelen in Dynamic Media beschikbaar voor gebruik tot 60 dagen na de uploaddatum. 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

Verzoek om een gedeelde geheime sleutel door het gebruiken van de Admin Console om een steungeval tot stand te brengen. In het geval van de technische steun, verzoek om een gedeelde 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

De uploadtoken zorgt ervoor dat niemand de zelfde gedeelde 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-2e29b78b602In dit voorbeeld is de sleutel voor gedeeld geheim 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 in de URL en de tijd 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.

Voorbeeld van URL van rasterafbeelding:

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

Toegestane HTTP-methoden:
GET en POST

U kunt nu een afbeeldingselement uploaden.

Zie Een afbeeldingselement uploaden.

Een rasterafbeeldingselement uploaden

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 upload_token en company_name velden zijn vereist.

Zie Het uploadtoken ophalen.

Zie Een sleutel van een gedeeld geheim ophalen.

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 file_limit parameter geeft de maximale bestandsgrootte op in bytes. De file_exts parameter geeft de bestandsextensies aan 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 uitnemen in Opties voor het verfijnen van afbeeldingen tijdens het uploaden.
The name of the file to upload.

U kunt de aan het bovenstaande formulier gekoppelde broncode van de HTML weergeven door https://s7ugc1.scene7.com/ugc/upload.html

Klik in Firefox met de rechtermuisknop in het browservenster en selecteer View Page Source. De code toont het overeenkomstige URL vraagkoord en de methode van de POST die in werking wordt gesteld wanneer de gebruiker selecteert Submit.

Ga naar View > Source. Ga naar Tools > Browser Tools > Web Developer Tools. 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 te uploaden element verzenden als het enige veld in een aanvraag voor een multipart-POST.

URL voorbeeld:

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

Toegestane HTTP-methode:

POST

Metagegevens van elementen ophalen voor afbeeldingen

U kunt image_info 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.

URL voorbeeld:

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

Toegestane HTTP-methode:

GET en POST

recommendation-more-help