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. O status da configuração de faturamento.
`paymentsAccountInfo`	`object (PaymentsAccountInfo)` Imutável. Informações da conta para pagamentos associadas a esta configuração de faturamento. Ao configurar o faturamento, ele é usado para fazer a inscrição em uma nova conta para pagamentos. Depois disso, a conta paymentsAccount não deve ser definida. Ao configurar o faturamento, essa conta e pagamentos serão preenchidos.
`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 esta configuração de faturamento. Os nomes dos recursos para pagamentos têm o seguinte formato: `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` Ao configurar o faturamento, ele é usado para fazer a inscrição com uma conta para pagamentos já existente. Depois disso, o paymentsAccountInfo não deve ser definido. Ao configurar o faturamento, esse campo e paymentsAccountInfo serão preenchidos.
Campo de união `start_time`. É aqui que a configuração deve entrar em vigor quando você cria uma nova configuração de faturamento. 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, esse é o horário de início solicitado. No entanto, se a configuração foi aprovada (veja o status) após o horário de início solicitado, esse é o horário de aprovação. `start_time` pode ser apenas de um dos tipos a seguir:
`startDateTime`	`string` Imutável. A data e hora 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. O horário de início como um tipo. Somente NOW é permitido.
Campo de união `end_time`. Término / finalizado da configuração de faturamento. Este é PARA SEMPRE ou o horário de início da próxima configuração de faturamento programada. `end_time` pode ser apenas de um dos tipos a seguir:
`endDateTime`	`string` Apenas saída. A data e hora 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 BillingSetup.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
`PENDING`	A configuração de faturamento está com aprovação pendente.
`APPROVED_HELD`	A configuração de faturamento foi aprovada, mas o primeiro orçamento correspondente não foi. Isso só pode ocorrer em 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 este 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. Ele 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. Assim, o usuário pode especificar 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. Ele 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 foi feito.