Method: sellers.adPlays.batchCreate

Crée des lectures d'annonces en série.

  • Le nombre maximum autorisé de lectures d'annonces dans un lot est de 1 000.
  • Renvoie la lecture de l'annonce nouvellement créée si l'opération aboutit.
  • Affiche le code d'erreur INVALID_ARGUMENT si un bloc d'annonces, un ordre, une ligne ou une création non valides sont spécifiés.
  • Renvoie le code d'erreur ALREADY_EXISTS si une annonce en cours de lecture existe déjà pour le même bloc d'annonces, ordre, ligne et création avec la même heure de début.
  • Affiche le code d'erreur NOT_FOUND si aucun bloc d'annonces, ordre, ligne ou asset de création correspondant n'a été trouvé.
  • Renvoie le code d'erreur FAILED_PRECONDITION si la requête contient à la fois un nom de ressource et un ID externe.

Requête HTTP

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource du vendeur. Format: vendeurs/{seller}

Corps de la requête

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

Représentation JSON 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
Champs
requests[]

object (CreateAdPlayRequest)

Obligatoire. L'annonce est diffusée pour être créée.

Le nombre maximum autorisé de lectures d'annonces dans un lot est de 1 000. L'heure de début doit être antérieure à la date actuelle et se situer au plus tard trois jours avant la date de création. L'heure de fin doit être antérieure et postérieure à l'heure de début.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Réponse pour la création de lectures d'annonces de manière groupée.

Représentation JSON 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
Champs
adPlays[]

object (AdPlay)

Lectures d'annonces créées.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/doubleclickbidmanager

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

CreateAdPlayRequest

Message de requête pour AdPlayService.CreateAdPlay.

Représentation JSON 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
Champs
parent

string

Obligatoire. Nom de la ressource du vendeur. Format: vendeurs/{seller}
adPlay

object (AdPlay)

Obligatoire. Lecture de l'annonce à créer.

Le nom de lecture de l'annonce sera généré par le système et ne doit pas être défini. L'heure de début doit être antérieure à la date actuelle et se situer au plus tard trois jours avant la date de création. L'heure de fin doit être antérieure et postérieure à l'heure de début.