Creare e gestire gli account dei clienti utilizzando l'API Cloud Channel

Da gennaio 2021, puoi utilizzare l'API Cloud Channel per creare clienti, diritti e subaccount di fatturazione Cloud. Se al momento utilizzi l'API Cloud Billing per gestire queste attività, ti consigliamo di utilizzare l'API Cloud Channel.

Questa guida illustra le nozioni di base per la creazione di clienti e diritti mediante l'API Cloud Channel.

Prima di iniziare

Completa il codelab dell'API Cloud Channel prima di continuare. In questo modo, l'ambiente di sviluppo sarà configurato per seguire gli esempi di codice e altri codelab.

Riepilogo delle modifiche

Se al momento utilizzi l'endpoint billingAccounts.create dell'API Cloud Billing per creare il subaccount di fatturazione Cloud di un cliente, devi iniziare a utilizzare l'endpoint customers.create() followed by theentitlements.create() per creare un nuovo subaccount di fatturazione Cloud per un cliente.

Per gestire i ruoli IAM, devi utilizzare gli endpoint dell'API Cloud Billing esistenti.

Creazione di un cliente

Quando è tutto pronto per creare un nuovo cliente con l'API Cloud Channel, utilizza l'endpointcustomers.create(). Prima di iniziare, assicurati di avere le seguenti informazioni sul cliente.

  • Dominio principale
  • Nome dell'organizzazione
  • Indirizzo
  • Codice postale (se applicabile)
  • Codice paese

Dopo aver creato un cliente, devi mantenere protetto il campo name della risposta, in quanto si tratta di un identificatore univoco del cliente.

Creazione di un diritto

Dopo aver creato un cliente, puoi eseguire il provisioning dei diritti per il cliente specificando un offer con gli endpoint entitlements.create() e operations.get(). Il nome del subaccount di fatturazione Cloud, restituito come provisionedService.provisioningId, può essere utilizzato con l'API Cloud Billing e l'esportazione di BigQuery.

La creazione di un diritto con un' Google Cloud offerta comporterà anche la creazione di un subaccount di fatturazione Cloud.

Per istruzioni più dettagliate sulla creazione di clienti e diritti, inclusi esempi di codice in più lingue, completa il Google Cloud codelab di provisioning end-to-end.