- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Aggiungi operazioni al job batch.
Elenco degli errori generati: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
Richiesta HTTP
POST https://googleads.googleapis.com/v15/{resourceName=customers/*/batchJobs/*}:addOperations
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
resourceName |
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 ( |
Campi | |
---|---|
sequenceToken |
Token utilizzato per applicare il sequenziamento. La prima richiesta batchJobs.addOperations per un job batch non deve impostare sequenceToken. Le richieste successive devono impostare sequenzaToken sul valore di nextSequenceToken ricevuto nella precedente risposta batchJobs.addOperations. |
mutateOperations[] |
Obbligatorio. L'elenco delle mutazioni in fase di aggiunta. 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 all'interno della stessa campagna creando una campagna nella prima operazione con il nome della risorsa impostato esplicitamente 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 |
Il numero totale di operazioni aggiunte finora per questo job batch. |
nextSequenceToken |
Il token di sequenza da utilizzare quando si richiama batchJobs.addOperations se è necessario aggiungere altre operazioni. La successiva richiesta batchJobs.addOperations deve impostare il campo sequenzaToken sul valore di questo campo. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/adwords
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.