Method: customers.batchJobs.addOperations

Adicionar 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/v14/{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 seguintes precisam definir sequênciaToken para o valor de nextSequenceToken recebido na resposta batchJobs.addOperations anterior.
mutateOperations[]

object (MutateOperation)

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

As operações podem usar números inteiros negativos como códigos temporários para indicar dependências entre entidades criadas neste job em lote. Por exemplo, um cliente com código = 1234 pode criar uma campanha e um grupo de anúncios nessa mesma campanha, criando uma campanha na primeira operação com o nome do recurso explicitamente definido como "customers/1234/campaigns/-1" e criando 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 mais operações precisarem ser adicionadas. A próxima solicitação batchJobs.addOperations precisa definir o campo sequencialToken para o valor desse 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.