Method: customers.batchJobs.addOperations

Ajoutez des opérations à la tâche par lot.

Liste des erreurs générées: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Requête HTTP

POST https://googleads.googleapis.com/v20/{resourceName=customers/*/batchJobs/*}:addOperations

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
resourceName

string

Obligatoire. Nom de ressource de l'ordre par lot.

Corps de la requête

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

Représentation JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Champs
sequenceToken

string

Jeton utilisé pour appliquer le séquençage.

La première requête batchJobs.addOperations pour un job par lot ne doit pas définir sequenceToken. Les requêtes suivantes doivent définir sequenceToken sur la valeur de nextSequenceToken reçue dans la réponse batchJobs.addOperations précédente.
mutateOperations[]

object (MutateOperation)

Obligatoire. Liste des modifications apportées.

Les opérations peuvent utiliser des entiers négatifs comme ID temporaires pour indiquer les dépendances entre les entités créées dans cette tâche par lot. Par exemple, un client dont l'ID est 1234 peut créer une campagne et un groupe d'annonces dans cette même campagne en créant une campagne dans la première opération avec le nom de la ressource défini explicitement sur "customers/1234/campaigns/-1", puis en créant un groupe d'annonces dans la deuxième opération avec le champ de la campagne également défini sur "customers/1234/campaigns/-1".

Corps de la réponse

Message de réponse pour BatchJobService.AddBatchJobOperations.

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

Représentation JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Champs
totalOperations

string (int64 format)

Nombre total d'opérations ajoutées jusqu'à présent pour cette tâche par lot.
nextSequenceToken

string

Jeton de séquence à utiliser lors de l'appel de batchJobs.addOperations à nouveau si d'autres opérations doivent être ajoutées. La prochaine requête batchJobs.addOperations doit définir le champ sequenceToken sur la valeur de ce champ.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.