Method: customers.batchJobs.addOperations

Aggiungi operazioni al job batch.

Elenco degli errori generati: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resourceName

string

obbligatorio. Il nome della risorsa del job batch.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Campi
sequenceToken

string

Un token utilizzato per applicare il sequenziamento.

La prima richiesta batchJobs.addOperations per un job batch non deve impostare sequenceToken. Le richieste successive devono impostare sequenceToken sul valore di nextSequenceToken ricevuto nella precedente risposta batchJobs.addOperations.
mutateOperations[]

object (MutateOperation)

obbligatorio. L'elenco di mutazioni aggiunte.

Le operazioni possono utilizzare numeri interi negativi come ID temporanei per indicare le dipendenze tra le entità create in questo job batch. Ad esempio, un cliente con ID = 1234 può creare una campagna e un gruppo di annunci nella stessa campagna creando una campagna nella prima operazione con il nome della risorsa esplicitamente impostato su "customers/1234/campaigns/-1" e creare un gruppo di annunci nella seconda operazione con il campo della campagna impostato su "customers/1234/campaigns/-1".

Corpo della risposta

Messaggio di risposta per BatchJobService.AddBatchJobOperations.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Campi
totalOperations

string (int64 format)

Il numero totale di operazioni aggiunte finora per questo job batch.
nextSequenceToken

string

Il token di sequenza da utilizzare quando si chiama di nuovo batchJobs.addOperations se è necessario aggiungere altre operazioni. La successiva richiesta batchJobs.addOperations deve impostare il campo sequenceToken sul valore di questo campo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.