Medienupload

Mit der Funktion zum Media-Upload können Sie Daten speichern, die Sie in Display & Video 360 verwenden können. Sie können Fotos, Videos, ZIP-Dateien und beliebige andere Arten von Daten hochladen.

Uploadoptionen

Über die Display & Video 360 API können Sie bestimmte Typen von Binärdaten oder Medien hochladen. Die Merkmale der Daten, die hochgeladen werden können, sind in der Entwicklerdokumentation für jede Aufgabe beschrieben, für die ein Medienupload erforderlich ist:

• Maximale Upload-Dateigröße: Die maximale Datenmenge, die mit dieser Methode gespeichert werden kann.
• Zulässige Medien-MIME-Typen: Die Typen von Binärdaten, die mit dieser Methode gespeichert werden können.

Uploadanfragen können folgendermaßen gestellt werden. Geben Sie die Methode an, die Sie für den uploadType-Parameter verwenden.

• Einfacher Upload: uploadType=media. Eine schnelle Übertragung für Dateien mit einer Größe von etwa 5 MB oder weniger.
• Mehrteiliger Upload: uploadType=multipart. Eine schnelle Übertragung von Dateien und relevanten Metadaten. Überträgt die Datei und Metadaten in einer einzelnen Anfrage.

Für den Upload von Medien wird ein /upload-URI verwendet. Verwenden Sie diesen URI beim Übertragen der eigentlichen Mediendaten.

Beispiel:

  POST /upload/media/resource-name

Einfacher Upload

Eine einfache Uploadanfrage ist die unkomplizierteste Methode zum Hochladen einer Datei. Das ist eine gute Option, wenn:

• Die Datei ist klein genug, um bei Bedarf noch einmal hochgeladen zu werden.
• Es sind keine Metadaten zum Senden vorhanden. Das kann der Fall sein, wenn Metadaten nicht erforderlich sind oder an anderer Stelle in der Anfrage enthalten sind.

Wenn Sie den einfachen Upload verwenden möchten, stellen Sie eine POST- oder PUT-Anfrage an den /upload-URI der Methode und fügen dabei den Abfrageparameter uploadType=media hinzu. Beispiel:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

Zu den HTTP-Headern, die bei einem einfachen Upload verwendet werden müssen, gehören:

• Content-Type: Muss auf einen der zulässigen Mediendatentypen der Methode festgelegt werden.
• Content-Length. Legen Sie als Wert die Anzahl von Byte fest, die Sie hochladen. Nicht erforderlich bei Verwendung der aufgeteilten Transferverschlüsselung.

Mehrteiliger Upload

Wenn Sie Metadaten zusammen mit den hochzuladenden Daten senden möchten, können Sie eine multipart/related-Anfrage stellen. Das ist eine gute Wahl, wenn die gesendeten Daten klein genug sind, um sie bei Bedarf noch einmal hochzuladen.

Wenn Sie den mehrteiligen Upload verwenden möchten, stellen Sie eine POST- oder PUT-Anfrage an den /upload-URI der Methode und fügen dabei den Abfrageparameter uploadType=multipart hinzu. Beispiel:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

Zu den Top-Level-HTTP-Headern beim Stellen einer mehrteiligen Uploadanfrage gehören:

• Content-Type. Setzen Sie den Wert auf multipart/related und fügen Sie den Grenzstring ein, den Sie zum Identifizieren der Teile der Anfrage verwenden.
• Content-Length. Setzen Sie den Wert auf die Gesamtanzahl von Byte im Anfragetext. Der Medienteil der Anfrage muss kleiner als die maximale Dateigröße sein, die für diese Methode angegeben ist.

Der Text der Anfrage ist als Inhaltstyp multipart/related [RFC2387] formatiert und enthält genau zwei Teile. Die Teile werden durch einen Grenzstring identifiziert und auf den finalen Grenzstring folgen zwei Bindestriche.

Für jeden Teil der mehrteiligen Anfrage ist als zusätzlicher Header Content-Type erforderlich:

1. Metadatenteil: Muss als Erstes angegeben werden und Content-Type muss einem der zulässigen Metadatenformate entsprechen.
2. Medienteil: Muss als Zweites angegeben werden und Content-Type muss einem der zulässigen Medien-MIME-Typen der Methode entsprechen.

Beispiele

Sie laden Media über die Display & Video 360 API hoch, um verschiedene Aufgaben auszuführen. In diesem Abschnitt finden Sie Beispiele als curl-Anfragen.

Creative-Asset hochladen

So laden Sie ein Creative-Asset hoch:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Weitere Informationen und Codebeispiele finden Sie im Leitfaden Creative-Assets hochladen.

Datei mit Script für die benutzerdefinierte Gebotseinstellung hochladen

So laden Sie eine Skriptdatei hoch:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Weitere Informationen und Codebeispiele finden Sie im Leitfaden zum Hochladen von Skripts.