Method: customers.batchJobs.addOperations

Ajouter des opérations au job 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/v14/{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 du job 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 d'une tâche par lot ne doit pas définir séquenceToken. 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 identifiants temporaires pour signifier les dépendances entre les entités créées dans ce job 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 lors de la première opération avec le nom de ressource explicitement défini sur "customers/1234/campagnes/-1", puis en créant un groupe d'annonces lors de la deuxième opération avec le champ "campagne" défini sur "customers/1234/campagnes/-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 à ce jour pour ce job par lot.
nextSequenceToken

string

Jeton de séquence à utiliser lors de l'appel de la méthode "batchJobs.addOperations" 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 la présentation d'OAuth 2.0.