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 realizar essas tarefas, recomendamos utilizar a API Cloud Channel.
Neste guia, apresentamos os conceitos básicos da criação de direitos e de clientes 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 a subconta do Cloud Billing do cliente, é necessário começar a usar o endpoint customers.create(), seguido pelo endpoint entitlements.create(), para criar uma nova subconta do Cloud Billing para um cliente.
Para gerenciar os papéis do IAM, você precisa usar os endpoints atuais 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(). Tenha em mãos as seguintes informações do cliente antes de começar.
- Domínio principal
- Nome da organização
- Endereço
- Código postal (se aplicável)
- Código do país
Depois de criar um cliente, é necessário proteger o campo name da resposta, já que ele é um identificador exclusivo do cliente.
Criar um direito
Após 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 a API Cloud Billing e o BigQuery Export.
Criar um direito com uma oferta do Google Cloud também cria uma subconta do Cloud Billing.
Para instruções mais detalhadas sobre a criação de direitos e do cliente, incluindo exemplos de código em várias linguagens, conclua o codelab de provisionamento de ponta a ponta do Google Cloud.