A partire da gennaio 2021, puoi utilizzare l'API Cloud Channel per creare clienti, diritti e subaccount di fatturazione Cloud. Se attualmente utilizzi l'API Cloud Billing per gestire queste attività, ti consigliamo di usare invece l'API Cloud Channel.
Questa guida introduce le nozioni di base sulla creazione di clienti e diritti mediante l'API Cloud Channel.
Prima di iniziare
Completa il codelab dell'API Cloud Channel prima di continuare. Così facendo, avrai la certezza che l'ambiente di sviluppo sia configurato in modo da seguire gli esempi di codice e altri codelab.
Riepilogo delle modifiche
Se attualmente utilizzi l'endpoint dell'API Cloud Billing
billingAccounts.create
per creare un subaccount di fatturazione Cloud di un cliente, devi
iniziare a utilizzare
l'endpoint
customers.create()
e poi
entitlements.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'endpoint customers.create(). Prima di iniziare, assicurati di disporre dei seguenti dati del cliente.
- Dominio principale
- Nome dell'organizzazione
- Indirizzo
- Codice postale (se applicabile)
- Codice paese
Dopo aver creato un cliente, devi proteggere il campo name della risposta, poiché si tratta di un identificatore univoco per il tuo cliente.
Creazione di un diritto
Dopo aver creato un cliente, puoi eseguire il provisioning dei diritti per lui
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 con BigQuery Export.
La creazione di un diritto con un'offerta Google Cloud creerà anche un subaccount di fatturazione Cloud.
Per istruzioni più dettagliate sulla creazione di clienti e diritti, inclusi esempi di codice in più lingue, completa il codelab sul provisioning end-to-end di Google Cloud.