Method: customers.batchJobs.addOperations

Fügen Sie dem Batch-Auftrag Vorgänge hinzu.

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

HTTP-Anfrage

POST https://googleads.googleapis.com/v14/{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 zum Erzwingen der Sequenzierung verwendet wird.

In der ersten BatchJobs.addOperations-Anfrage für einen Batch-Job sollte dieser Wert nicht fürSequenceToken festgelegt werden. Bei nachfolgenden Anfragen muss „sequenzToken“ auf den Wert von „nextSequenceToken“ gesetzt werden, der in der vorherigen BatchJobs.addOperations-Antwort empfangen wurde.
mutateOperations[]

object (MutateOperation)

Erforderlich. Die Liste der hinzugefügten mutate

Vorgänge können negative Ganzzahlen als temporäre IDs verwenden, um Abhängigkeiten zwischen Entitäten zu kennzeichnen, die in diesem Batchjob erstellt wurden. Ein Kunde mit der ID 1234 kann beispielsweise eine Kampagne und eine Anzeigengruppe in derselben Kampagne erstellen, indem er im ersten Vorgang eine Kampagne erstellt, bei der der Ressourcenname explizit auf "customers/1234/campaigns/-1" festgelegt ist, und im zweiten Vorgang eine Anzeigengruppe, in der das Kampagnenfeld ebenfalls auf "customers/1234/campaigns/-1" festgelegt ist.

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 Batch-Auftrag 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 „batchJobs.addOperations“-Anfrage muss das Feld „sequenzToken“ auf den Wert dieses Felds festgelegt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.