Method: customers.billingSetups.mutate

Cria ou cancela uma configuração de faturamento.

Lista de erros gerados: AuthenticationError AuthorizationError BillingSetupError DateError FieldError HeaderError InternalError MutateError QuotaError RequestError

Solicitação HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/billingSetups:mutate

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. ID do cliente ao qual aplicar a operação mutate da configuração de faturamento.

Corpo da solicitação

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

Representação JSON 
{
  "operation": {
    object (BillingSetupOperation)
  }
}
Campos
operation

object (BillingSetupOperation)

Obrigatório. A operação a ser executada.

Corpo da resposta

Mensagem de resposta para uma operação de configuração de faturamento.

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

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

object (MutateBillingSetupResult)

Um resultado que identifica o recurso afetado pela solicitação de mutaçã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.

BillingSetupOperation

Uma única operação em uma configuração de faturamento que descreve o cancelamento de uma configuração de faturamento existente.

Representação JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BillingSetup)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Campos
Campo de união operation. Somente uma dessas operações pode ser definida. As operações de "atualização" não são suportadas. operation pode ser apenas de um dos tipos a seguir:
create

object (BillingSetup)

Cria uma configuração de faturamento Nenhum nome de recurso é esperado para a nova configuração de faturamento.
remove

string

Nome do recurso da configuração de faturamento a ser removida. Não é possível remover uma configuração, a menos que ela esteja em estado pendente ou o horário de início programado esteja no futuro. O nome do recurso é parecido com customers/{customerId}/billingSetups/{billing_id}.

MutateBillingSetupResult

Resultado de uma única modificação na configuração de faturamento.

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

string

Retornado para operações bem-sucedidas.