Method: customers.keywordPlanCampaignKeywords.mutate

Cria, atualiza ou remove palavras-chave de campanhas do plano de palavras-chave. Os status da operação são retornados.

Lista de erros gerados: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

Solicitação HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords:mutate

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente que tem as palavras-chave da campanha sendo modificadas.

Corpo da solicitação

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

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

object (KeywordPlanCampaignKeywordOperation)

Obrigatório. Lista de operações a serem realizadas em palavras-chave de campanhas do Planejador de palavras-chave.
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 palavra-chave de uma campanha do planejador de palavras-chave.

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

Representação JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanCampaignKeywordResult)
    }
  ]
}
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 (MutateKeywordPlanCampaignKeywordResult)

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.