Method: advertisers.sdfuploadtasks.upload

Crea un'attività di caricamento SDF. Restituisce un Operation.

Un'attività di caricamento SDF è un'operazione asincrona di lunga durata. Il tipo metadata di questa operazione è SdfUploadTaskMetadata. Se la richiesta ha esito positivo, il tipo response dell'operazione è SdfUploadTask. La risposta non includerà i file risultanti, che possono essere recuperati utilizzando media.download.

Lo stato dell'operazione può essere recuperato con sdfuploadtask.operations.get.

Eventuali errori sono disponibili in error.message. Tieni presente che error.details dovrebbe essere vuoto.

Richiesta HTTP

  • URI di caricamento per le richieste di caricamento di contenuti multimediali:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI dei metadati, per le richieste solo di metadati:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
advertiserId

string (int64 format)

Obbligatorio. L'ID dell'inserzionista per cui caricare il file SDF.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Campi
filename

string

Obbligatorio. Il nome file della risorsa, inclusa l'estensione del file. Il nome file deve essere codificato in UTF-8 con una dimensione massima di 240 byte.
sdfVersion

enum (SdfVersion)

Obbligatorio. La versione SDF del file caricato. Se impostato su SDF_VERSION_UNSPECIFIED, per impostazione predefinita verrà utilizzata la versione specificata dall'inserzionista identificato. Un inserzionista eredita la versione SDF dal partner, a meno che non venga configurata diversamente.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.