Desde janeiro de 2021, pode usar a Cloud Channel API para criar clientes, autorizações e subcontas da Cloud Billing. Se usa atualmente a API Cloud Billing para processar estas tarefas, recomendamos que use a API Cloud Channel.
Este guia apresenta as noções básicas da criação de clientes e autorizações através da Cloud Channel API.
Antes de começar
Conclua o codelab da API Google Cloud Channel antes de continuar. Isto garante que o seu ambiente de desenvolvimento está configurado para seguir exemplos de código e outros codelabs.
Resumo das alterações
Se usar atualmente o ponto final da API Cloud Billing
billingAccounts.create
para criar uma subconta do Cloud Billing de um cliente, tem de
começar a usar o ponto final
customers.create(), seguido do ponto final
entitlements.create(), para criar uma nova subconta do Cloud Billing para um cliente.
Para gerir funções do IAM, tem de usar os endpoints da API Cloud Billing existentes.
Criar um cliente
Quando quiser criar um novo cliente com a Cloud Channel API, use o ponto final customers.create(). Certifique-se de que tem as seguintes informações do cliente antes de começar.
- Domínio principal
- Nome da entidade
- Endereço
- Código postal (se aplicável)
- Código do país
Depois de criar um cliente, tem de manter o campo name
da resposta seguro, uma vez que é um identificador exclusivo do cliente.
Criar uma concessão
Depois de criar um cliente, pode aprovisionar autorizações para o mesmo especificando um offer com os pontos finais entitlements.create() e operations.get(). O nome da subconta de faturação do Google Cloud, devolvido como
provisionedService.provisioningId, pode ser usado com a API Cloud Billing
e o BigQuery Export.
A criação de uma concessão com uma Google Cloud oferta também cria uma subconta de faturação do Google Cloud.
Para obter instruções mais detalhadas sobre a criação de clientes e autorizações, incluindo exemplos de código em vários idiomas, conclua o Google Cloud codelab de aprovisionamento completo.