Method: advertisers.sdfuploadtasks.upload

Crée une tâche d'importation SDF. Renvoie un Operation.

Une tâche d'importation SDF est une opération asynchrone de longue durée. Le type metadata de cette opération est SdfUploadTaskMetadata. Si la requête aboutit, le type response de l'opération est SdfUploadTask. La réponse n'inclut pas les fichiers obtenus, qui peuvent ensuite être récupérés à l'aide de media.download.

L'état de l'opération peut être récupéré avec sdfuploadtask.operations.get.

Toutes les erreurs se trouvent dans error.message. Notez que error.details devrait être vide.

Requête HTTP

  • URI d'importation, pour les demandes d'importation de médias:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI de métadonnées, pour les requêtes de métadonnées uniquement:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
advertiserId

string (int64 format)

Obligatoire. ID de l'annonceur pour lequel vous souhaitez importer un fichier SDF.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Champs
filename

string

Obligatoire. Nom du fichier de l'asset, y compris l'extension. Le nom de fichier doit être encodé en UTF-8 et ne pas dépasser 240 octets.
sdfVersion

enum (SdfVersion)

Obligatoire. Version SDF du fichier importé. Si la valeur est SDF_VERSION_UNSPECIFIED, la version spécifiée par l'annonceur identifié est utilisée par défaut. Un annonceur hérite de la version de son fichier SDF de son partenaire, sauf si vous configurez autrement.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.