Method: advertisers.sdfuploadtasks.upload

Erstellt eine SDF-Uploadaufgabe. Gibt eine Operation zurück.

Ein SDF-Upload-Auftrag ist ein langwieriger, asynchroner Vorgang. Der metadata-Typ dieses Vorgangs ist SdfUploadTaskMetadata. Wenn die Anfrage erfolgreich ist, ist der response-Typ des Vorgangs SdfUploadTask. Die Antwort enthält keine resultierenden Dateien, die dann mit media.download abgerufen werden können.

Der Status des Vorgangs kann mit sdfuploadtask.operations.get abgerufen werden.

Alle Fehler finden Sie in der error.message. error.details ist normalerweise leer.

HTTP-Anfrage

  • Upload-URI für Anfragen zum Hochladen von Medien:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • Metadaten-URI für Anfragen, die nur Metadaten enthalten:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, für den der SDF hochgeladen werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Felder
filename

string

Erforderlich. Der Dateiname des Assets, einschließlich der Dateiendung. Der Dateiname muss UTF-8-codiert sein und darf maximal 240 Byte lang sein.
sdfVersion

enum (SdfVersion)

Erforderlich. Die SDF-Version der hochgeladenen Datei. Wenn „SDF_VERSION_UNSPECIFIED“ festgelegt ist, wird standardmäßig die vom identifizierten Werbetreibenden angegebene Version verwendet. Die SDF-Version eines Werbetreibenden wird von seinem Partner übernommen, sofern nicht anders konfiguriert.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

Weitere Informationen finden Sie unter OAuth 2.0 Overview.