Method: customers.batchJobs.addOperations

Adicione operações à tarefa em lote.

Lista de erros gerados: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
resourceName

string

Obrigatório. O nome do recurso do job em lote.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Campos
sequenceToken

string

Um token usado para aplicar o sequenciamento.

A primeira solicitação batchJobs.addOperations para um job em lote não deve definir sequenceToken. As solicitações subsequentes precisam definir sequênciaToken como o valor de nextSequenceToken recebido na resposta batchJobs.addOperations anterior.
mutateOperations[]

object (MutateOperation)

Obrigatório. A lista de elementos mutate que estão sendo adicionados.

As operações podem usar números inteiros negativos como IDs temporários para indicar dependências entre entidades criadas neste job em lote. Por exemplo, um cliente com ID = 1234 pode criar uma campanha e um grupo de anúncios na mesma campanha. Para isso, ele cria uma campanha na primeira operação com o nome do recurso explicitamente definido como "customers/1234/campaigns/-1" e um grupo de anúncios na segunda operação com o campo "campaign" também definido como "customers/1234/campaigns/-1".

Corpo da resposta

Mensagem de resposta para BatchJobService.AddBatchJobOperations.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Campos
totalOperations

string (int64 format)

O número total de operações adicionadas até agora para esta tarefa em lote.
nextSequenceToken

string

O token de sequência a ser usado ao chamar batchJobs.addOperations novamente se for preciso adicionar mais operações. A próxima solicitação batchJobs.addOperations precisa definir o campo sequenceToken como o valor deste campo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.