Cuidado: você está vendo a documentação da interface REST da API. A maioria das nossas bibliotecas de cliente oficiais usa o gRPC. Consulte Introdução ao REST para ver mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

BillingSetup

Representação JSON
BillingSetupStatus
PaymentsAccountInfo
- Representação JSON

Uma configuração de faturamento que associa uma conta para pagamentos e um anunciante. Uma configuração de faturamento é específica para um anunciante.

Representação JSON

Representação JSON
{ "resourceName": string, "status": enum (`BillingSetupStatus`), "paymentsAccountInfo": { object (`PaymentsAccountInfo`) }, "id": string, "paymentsAccount": string, // Union field `start_time` can be only one of the following: "startDateTime": string, "startTimeType": enum (`TimeType`) // End of list of possible types for union field `start_time`. // Union field `end_time` can be only one of the following: "endDateTime": string, "endTimeType": enum (`TimeType`) // End of list of possible types for union field `end_time`. }

{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}

Campos
`resourceName`	`string` Imutável. O nome do recurso da configuração de faturamento. Os nomes dos recursos do BillingSetup têm o seguinte formato: `customers/{customerId}/billingSetups/{billing_setup_id}`
`status`	`enum (BillingSetupStatus)` Apenas saída. Status da configuração de faturamento.
`paymentsAccountInfo`	`object (PaymentsAccountInfo)` Imutável. As informações da conta para pagamentos associadas a essa configuração de faturamento. Na configuração do faturamento, ele é usado para se inscrever com uma nova conta para pagamentos (e, depois, paymentsAccount não deve estar definido). Ao gerar uma configuração de faturamento, essa conta e a paymentsAccount serão preenchidas.
`id`	`string (int64 format)` Apenas saída. O ID da configuração de faturamento.
`paymentsAccount`	`string` Imutável. O nome do recurso da conta para pagamentos associada a essa configuração de faturamento. Os nomes dos recursos de pagamentos têm o seguinte formato: `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` Ao configurar o faturamento, ele é usado para se inscrever com uma conta para pagamentos existente. Depois disso, paymentsAccountInfo não deve ser definido. Ao receber uma configuração de faturamento, esses dados e paymentsAccountInfo serão preenchidos.
Campo de união `start_time`. Ao criar uma nova configuração de faturamento, é nesse momento que ela deve entrar em vigor. AGORA é o único horário de início aceitável se o cliente não tiver configurações aprovadas. Ao buscar uma configuração de faturamento existente, esse é o horário de início solicitado. No entanto, se a configuração foi aprovada (consulte o status) após o horário de início solicitado, esse será o horário de aprovação. `start_time` pode ser apenas de um dos tipos a seguir:
`startDateTime`	`string` Imutável. A hora da data de início no formato aaaa-MM-dd ou aaaa-MM-dd HH:mm:ss. Apenas um horário futuro é permitido.
`startTimeType`	`enum (TimeType)` Imutável. A hora de início como um tipo. Somente NOW é permitido.
Campo de união `end_time`. Quando a configuração de faturamento termina / terminou. Esse é SEMPRE ou o horário de início da próxima configuração de faturamento programada. `end_time` só pode ser de um dos seguintes tipos:
`endDateTime`	`string` Apenas saída. A hora da data de término no formato aaaa-MM-dd ou aaaa-MM-dd HH:mm:ss.
`endTimeType`	`enum (TimeType)` Apenas saída. O horário de término como um tipo. O único valor possível é FOREVER.

BillingSetupStatus

Os status possíveis de um BillingConfigurar.

Tipos enumerados
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
`PENDING`	A aprovação da configuração de faturamento está pendente.
`APPROVED_HELD`	A configuração de faturamento foi aprovada, mas o primeiro orçamento correspondente não foi. Isso só pode ocorrer com configurações de faturamento definidas para faturamento mensal.
`APPROVED`	A configuração de faturamento foi aprovada.
`CANCELLED`	A configuração de faturamento foi cancelada pelo usuário antes da aprovação.

PaymentsAccountInfo

Contêiner de informações da conta para pagamentos para esse faturamento.

Representação JSON
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string }

Campos
`paymentsAccountId`	`string` Apenas saída. Um ID de 16 dígitos usado para identificar a conta para pagamentos associada à configuração de faturamento. Precisa ser transmitido como uma string com traços, por exemplo, "1234-5678-9012-3456".
`paymentsAccountName`	`string` Imutável. O nome da conta para pagamentos associada à configuração de faturamento. Isso permite que o usuário especifique um nome significativo para uma conta para pagamentos que ajude na reconciliação de faturas mensais. Esse nome será impresso nas faturas mensais.
`paymentsProfileId`	`string` Imutável. Um ID de 12 dígitos usado para identificar o perfil para pagamentos associado à configuração de faturamento. Precisa ser transmitido como uma string com traços, por exemplo, "1234-5678-9012".
`paymentsProfileName`	`string` Apenas saída. O nome do perfil para pagamentos associado à configuração de faturamento.
`secondaryPaymentsProfileId`	`string` Apenas saída. Um ID do perfil para pagamentos secundário presente em situações incomuns, por exemplo, quando um contrato de responsabilidade sequencial é estabelecido.