Desde janeiro de 2021, é possível usar a API Cloud Channel para criar clientes, direitos e subcontas do Cloud Billing. Se você usa a API Cloud Billing para processar essas tarefas, recomendamos usar a API Cloud Channel.
Este guia apresenta os conceitos básicos da criação de clientes e direitos de acesso usando a API Cloud Channel.
Antes de começar
Conclua o codelab da API Cloud Channel antes de continuar. Isso garante que seu ambiente de desenvolvimento esteja configurado para seguir exemplos de código e outros codelabs.
Resumo das mudanças
Se você usa o endpoint billingAccounts.create da API Cloud Billing para criar uma subconta do Cloud Billing de um cliente, comece a usar o endpoint customers.create(), seguido por entitlements.create(), para criar uma nova subconta do Cloud Billing para um cliente.
Para gerenciar papéis do IAM, use os endpoints da API Cloud Billing.
Como criar um cliente
Quando estiver tudo pronto para criar um novo cliente com a API Cloud Channel, use o endpoint
customers.create(). Antes de começar, confira se você tem as seguintes informações do cliente:
- Domínio principal
- Nome da organização
- Endereço
- CEP (se aplicável)
- Código do país
Depois de criar um cliente, é necessário manter o campo name da resposta seguro, porque ele é um identificador exclusivo do cliente.
Criar um direito
Depois de criar um cliente, é possível provisionar direitos para ele
especificando um offer com os endpoints entitlements.create() e
operations.get(). O nome da subconta do Cloud Billing, retornado como
provisionedService.provisioningId, pode ser usado com API Cloud Billing
e a exportação do BigQuery.
A criação de um direito com uma oferta Google Cloud também cria uma subconta do Cloud Billing.
Para instruções mais detalhadas sobre a criação de clientes e direitos, incluindo exemplos de código em várias linguagens, conclua o codelab de Google Cloud provisionamento de ponta a ponta.