Method: customers.adGroupAdLabels.mutate

Cria e remove rótulos de anúncios de grupos de anúncios. Os status da operação são retornados.

Lista de erros gerados: AuthenticationError AuthorizationError DatabaseError HeaderError InternalError LabelError MutateError NewResourceCreationError QuotaError RequestError

Solicitação HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}/adGroupAdLabels:mutate

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. ID do cliente cujos rótulos de anúncios do grupo de anúncios estão sendo modificados.

Corpo da solicitação

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

Representação JSON 
{
  "operations": [
    {
      object (AdGroupAdLabelOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campos
operations[]

object (AdGroupAdLabelOperation)

Obrigatório. Lista de operações a serem realizadas nos rótulos de anúncios do grupo de anúncios.
partialFailure

boolean

Se for "true", as operações bem-sucedidas serão realizadas e as operações inválidas vão retornar erros. Se for falso, todas as operações serão realizadas em uma transação somente se forem válidas. O padrão é false
validateOnly

boolean

Se for verdadeiro, a solicitação será validada, mas não executada. Somente erros são retornados, não resultados.

Corpo da resposta

Mensagem de resposta para uma mutação de rótulos de anúncios de um grupo de anúncios.

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

Representação JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupAdLabelResult)
    }
  ]
}
Campos
partialFailureError

object (Status)

Erros relacionados a falhas de operação no modo de falha parcial. Retornado apenas quando partialFailure = true e todos os erros ocorrem dentro das operações. Se ocorrerem erros fora das operações (por exemplo, erros de autenticação), retornaremos um erro no nível do RPC.
results[]

object (MutateAdGroupAdLabelResult)

Todos os resultados da modificação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.