Method: customers.batchJobs.addOperations

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

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
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

Token, das zum Erzwingen der Sequenzierung verwendet wird.

In der ersten BatchJobs.addOperations-Anfrage für einen Batch-Job sollte dieser Parameter nicht angegeben werden. Für nachfolgende Anfragen musssequenzToken auf den Wert von „nextSequenceToken“ gesetzt werden, der in der vorherigen BatchJobs.addOperations-Antwort empfangen wurde.
mutateOperations[]

object (MutateOperation)

Erforderlich. Die Liste der hinzuzufügenden Änderungen.

Vorgänge können negative Ganzzahlen als temporäre IDs verwenden, um Abhängigkeiten zwischen Entitäten anzugeben, die in diesem Batch-Job 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, wobei der Ressourcenname explizit auf "customers/1234/campaigns/-1" festgelegt ist. Im zweiten Vorgang wird eine Anzeigengruppe erstellt, in der das Kampagnenfeld ebenfalls auf "customers/1234/campaigns/-1" gesetzt 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 „SequenceToken“ 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.