Method: customers.batchJobs.addOperations

Fügen Sie dem Batchjob Vorgänge hinzu.

Liste der geworfenen Fehler: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
resourceName

string

Erforderlich. Der Ressourcenname des Batchjobs.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Felder
sequenceToken

string

Ein Token, das zur Erzwingung der Abfolge verwendet wird.

Bei der ersten batchJobs.addOperations-Anfrage für einen Batchjob darf sequenceToken nicht festgelegt werden. Bei nachfolgenden Anfragen muss „sequenceToken“ auf den Wert von „nextSequenceToken“ festgelegt werden, der in der vorherigen Antwort von „batchJobs.addOperations“ empfangen wurde.
mutateOperations[]

object (MutateOperation)

Erforderlich. Die Liste der hinzugefügten Mutationen.

Für Vorgänge können negative Ganzzahlen als temporäre IDs verwendet werden, um Abhängigkeiten zwischen Entitäten anzugeben, die in diesem Batchjob erstellt wurden. Ein Kunde mit der ID 1234 kann beispielsweise eine Kampagne und eine Anzeigengruppe in derselben Kampagne erstellen. Dazu erstellt er im ersten Vorgang eine Kampagne mit dem explizit auf „customers/1234/campaigns/-1“ festgelegten Ressourcennamen und im zweiten Vorgang eine Anzeigengruppe mit dem ebenfalls auf „customers/1234/campaigns/-1“ festgelegten Kampagnenfeld.

Antworttext

Antwortnachricht für BatchJobService.AddBatchJobOperations.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Felder
totalOperations

string (int64 format)

Die Gesamtzahl der bisher für diesen Batchjob hinzugefügten Vorgänge.
nextSequenceToken

string

Das Sequenztoken, das beim erneuten Aufrufen von „batchJobs.addOperations“ verwendet werden soll, wenn weitere Vorgänge hinzugefügt werden müssen. In der nächsten Anfrage vom Typ „batchJobs.addOperations“ muss das Feld „sequenceToken“ auf den Wert dieses Felds festgelegt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.