Hochladen eines Rasterbild-Assets uploading-an-image-asset-or-a-vector-asset

Bevor Sie ein Bild-Asset hochladen können, fordern Sie zunächst einen gemeinsamen geheimen Schlüssel an. Mit diesem gemeinsamen geheimen Schlüssel können Sie ein Upload-Token abrufen. Anschließend verwenden Sie das Upload-Token, um Rasterbild-Assets hochzuladen.

IMPORTANT
Ab dem 1. Mai 2023 stehen UGC-Assets in Dynamic Media bis zu 60 Tage ab dem Datum des Uploads zur Verfügung. Nach 60 Tagen werden die Assets entfernt.
NOTE
Die Unterstützung für neue oder vorhandene UGC-Vektor-Assets in Adobe Dynamic Media Classic wurde am 30. September 2021 eingestellt.

Anfordern eines gemeinsamen geheimen Schlüssels requesting-a-shared-secret-key

Anfordern einer shared-secret key von Verwenden der Admin Console, um einen Support-Fall zu erstellen. Bitten Sie in Ihrem Support-Fall um einen gemeinsam genutzten geheimen Schlüssel.

Geben Sie in der E-Mail-Nachricht den Unternehmensnamen an, den Sie verwenden möchten, um Bild-Assets hochzuladen. Nachdem Sie den Schlüssel von Adobe Dynamic Media Classic erhalten haben, speichern Sie ihn lokal für die zukünftige Verwendung.

Upload-Token abrufen retrieving-the-upload-token

Das Upload-Token stellt sicher, dass niemand denselben gemeinsamen geheimen Schlüssel zum Hochladen von Assets verwenden kann. Außerdem stellt es sicher, dass der Upload zulässig ist und von einer vertrauenswürdigen Quelle stammt.

Das Upload-Token besteht aus einer alphanumerischen Zeichenfolge, die nur für eine begrenzte Zeitspanne gültig ist. Verwenden Sie die folgenden URLs und ersetzen Sie den gemeinsam genutzten geheimen Schlüssel, damit Sie das Upload-Token abrufen können.

  • Rasterbild
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602In diesem Beispiel lautet der gemeinsame geheime Schlüssel fece4b21-87ee-47fc-9b99-2e29b78b602

Standardmäßig läuft das Upload-Token 5 Minuten (300 Sekunden) nach dem Abrufen ab. Um mehr Zeit anzufordern, schließen Sie expires in der URL und die benötigte Zeit in Sekunden. So wird bei der folgenden URL für ein Beispielbild ein Upload-Token abgerufen, das 1800 Sekunden gültig ist:

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

Die erfolgreiche Antwort für Bilder sieht in etwa wie folgt aus:

<?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>

Speichern Sie das Upload-Token für zukünftige Anfragen lokal.

Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Abrufen eines Upload-Tokens verwenden:

URL-Parameter
Erforderlich oder optional
Wert
op
Erforderlich
get_uploadtoken
shared_secret
Erforderlich
Der gemeinsam genutzte geheime Schlüssel für das Unternehmen, das den Upload durchführt.
expires
Optional
Anzahl der Sekunden, die das Upload-Token gültig ist. Der Standardwert ist 300 Sekunden, wenn nicht spezifiziert.

Beispiel-Rasterbild-URL:

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

Zulässige HTTP-Methoden:
GET und POST

Sie können nun ein Bild-Asset hochladen.

Siehe Bild-Asset hochladen.

Hochladen eines Rasterbild-Assets uploading-an-image-asset

Wenn Sie ein Upload-Token abgerufen haben, das für eine bestimmte Zeitspanne gültig ist, können Sie ein Bild-Asset hochladen. Sie laden das Asset mit der POST-Methode als mehrteilige Formulardaten hoch, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden, wie im nachfolgenden Beispiel gezeigt:

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

Die upload_token und company_name -Felder erforderlich sind.

Siehe Upload-Token abrufen.

Siehe Abrufen eines gemeinsamen geheimen Schlüssels.

Sie können auch andere optionale Werte als URL-Anfragezeichenfolgen senden, wie das nachfolgende Beispiel zeigt:

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

Die file_limit gibt die maximale Dateigröße in Byte an. Die file_exts gibt die Dateinamenerweiterungen an, die hochgeladen werden dürfen. Diese beiden Werte sind optional.

In der Anwendung sind globale Beschränkungen für die maximale Dateigröße und zulässigen Dateierweiterungen festgelegt. Wenn es sich bei der von Ihnen gesendeten Anforderung um eine Untergruppe der globalen Beschränkungen handelt, wird diese berücksichtigt. Die globalen Beschränkungen lauten wie folgt:

Globale Beschränkung
Wert
Dateigröße für alle Clients
20 MB
Unterstützte Bilddateiformate zum Hochladen
BMP, GIF, JPG, PNG, PSD, TIFF

Mit dem folgenden HTML-Formular können Benutzer Assets hochladen. In dem Formular wird der Benutzer aufgefordert, die folgenden Informationen einzugeben:

  • Ein Unternehmensname.
  • Ein Upload-Token.
  • Eine Dateigrößenbeschränkung.
  • Eine Liste der Dateinamenerweiterungen.
  • Gibt an, ob das Farbprofil und der Dateiname des Assets beibehalten werden sollen.
  • Ob Hintergrund aussparen verwendet werden soll. Wenn Sie "Hintergrund aussparen"aktivieren, legen Sie die Methode "Ecke", "Toleranz"und "Füllung"fest.
    Siehe Hintergrund aussparen in Bildoptimierungsoptionen beim Hochladen.
  • Der Name der hochzuladenden Datei.

Sie können den mit dem obigen Formular verknüpften HTML-Quellcode anzeigen, indem Sie https://s7ugc1.scene7.com/ugc/upload.html

Klicken Sie in Firefox mit der rechten Maustaste in das Browserfenster und wählen Sie Seitenquelle anzeigen. Der Code zeigt die entsprechende URL-Abfragezeichenfolge und die POST-Methode an, die ausgeführt werden, wenn der Benutzer Einsenden.

Um die XML-Antwort in Internet Explorer anzuzeigen, navigieren Sie zu Ansicht > Quelle. Um die XML-Antwort in Firefox anzuzeigen, navigieren Sie zu Instrumente > Browser-Tools > Web Developer Tools. Zur Anzeige von XML-Antworten wird Firefox empfohlen.

Hier eine Beispielantwort für einen erfolgreiche 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
Das hochgeladene Asset (JPG, GIF usw.) wird ins PTIFF-Format umgewandelt und mit der Antwort wird eine direkte Verknüpfung zu diesem PTIFF-Asset gesendet.

Das Asset kann wie jede andere Image-Server-Ressource gehandhabt werden; Sie können auch Verarbeitungsanfragen darauf anwenden. Beispielsweise fordert die folgende URL ein Asset an, das bis zur angegebenen Breite und Höhe gestreckt ist.

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

Senden Sie das hochzuladende Asset mit der POST-Methode als mehrteilige Formulardaten, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden. Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Hochladen eines Assets verwenden:

URL-Parameter
Erforderlich oder optional
Wert
op
Erforderlich
Hochladen
upload_token
Erforderlich
Upload-Token für den gemeinsamen geheimen Schlüssel für das Unternehmen.
company_name
Erforderlich
Name des hochladenden Unternehmens.
file_limit
Optional
Maximale Dateigröße (in Byte) für das Asset.
file_exts
Optional
Liste der zulässigen Erweiterungen für die Bild-Asset-Datei.
preserve_colorprofile
Optional
Behält eingebettete Farbprofile bei der Konvertierung der hochgeladenen Datei in das PTIFF-Format bei. Mögliche Werte sind „true“ oder „false“. Der Standardwert ist „false“.
preserve_filename
Optional
Behält den Dateinamen des hochgeladenen Assets bei. Mögliche Werte sind „true“ oder „false“. Der Standardwert ist „false“.
NOTE
Das hochzuladende Asset muss als einziges Feld in einer mehrteiligen POST-Anfrage hochgeladen werden.

Beispiel-URL:

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

Zulässige HTTP-Methode:

POST

Abrufen von Asset-Metadaten für Bilder getting-asset-metadata-for-images

Sie können image_info , um Metadaten für ein hochgeladenes Asset abzurufen, wie im folgenden Beispiel gezeigt:

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

Ein Beispiel für eine erfolgreiche Antwort wird in etwa wie folgt angezeigt:

<?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>

Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Abrufen von Informationen für ein Asset verwenden:

URL-Parameter
Erforderlich oder optional
Wert
op
Erforderlich
image_info
shared_secret
Erforderlich
Der gemeinsame geheime Schlüssel für das Unternehmen.
image_name
Erforderlich
Name des Bildes.

Beispiel-URL:

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

Zulässige HTTP-Methode:

GET und POST

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