Method: customers.accountBudgetProposals.mutate

Cria, atualiza ou remove propostas de orçamento da conta. Os status da operação são retornados.

Lista de erros gerados: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorRequestErrorRequestErrorStringLengthError

Solicitação HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente.

Corpo da solicitação

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

Representação JSON 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Campos
operation

object (AccountBudgetProposalOperation)

Obrigatório. A operação a ser realizada em uma proposta de orçamento individual no nível da conta.
validateOnly

boolean

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

Corpo da resposta

Mensagem de resposta para operações de mutação de orçamento no nível da conta.

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

Representação JSON 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Campos
result

object (MutateAccountBudgetProposalResult)

Resultado da modificação.

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.

AccountBudgetProposalOperation

Uma única operação para propor a criação de um novo orçamento no nível da conta ou editar/encerrar/remover um atual.

Representação JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Campos
updateMask

string (FieldMask format)

FieldMask que determina quais campos de orçamento são modificados. Embora os orçamentos possam ser modificados, as propostas que propõem essas modificações são finais. Portanto, as operações de atualização não são compatíveis com as propostas.

As propostas que modificam orçamentos são do tipo "atualização". Especificar uma máscara para qualquer outro tipo de proposta é considerado um erro.

Esta é uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
Campo de união operation. A operação de mutação. operation pode ser apenas de um dos tipos a seguir:
create

object (AccountBudgetProposal)

Operação "Criar": uma nova proposta para criar um novo orçamento, editar um orçamento existente, encerrar um orçamento ativo ou remover um orçamento aprovado programado para iniciar no futuro. Nenhum nome de recurso é esperado para a nova proposta.
remove

string

Operação de remoção: é esperado um nome de recurso para a proposta removida, neste formato:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Uma solicitação poderá ser cancelada se estiver pendente.

MutateAccountBudgetProposalResult

Resultado da modificação da proposta de orçamento da conta.

Representação JSON 
{
  "resourceName": string
}
Campos
resourceName

string

É retornado para operações bem-sucedidas.