Seit Januar 2021 können Sie die Cloud Channel API verwenden, um Kunden, Berechtigungen und Cloud-Rechnungsunterkonten zu erstellen. Wenn Sie derzeit die Cloud Billing API für diese Aufgaben verwenden, empfehlen wir stattdessen die Verwendung der Cloud Channel API.
In diesem Leitfaden werden die Grundlagen der Erstellung von Kunden und Berechtigungen mit der Cloud Channel API erläutert.
Hinweise
Arbeiten Sie das Codelab zur Cloud Channel API durch, bevor Sie fortfahren. Dadurch wird sichergestellt, dass Ihre Entwicklungsumgebung entsprechend den Codebeispielen und anderen Codelabs eingerichtet ist.
Zusammenfassung der Änderungen
Wenn Sie derzeit den Endpunkt billingAccounts.create der Cloud Billing API verwenden, um das Cloud-Rechnungsunterkonto eines Kunden zu erstellen, müssen Sie zum Erstellen eines neuen Cloud-Rechnungsunterkontos für einen Kunden den Endpunkt customers.create() und dann den Endpunkt entitlements.create() verwenden.
Zum Verwalten von IAM-Rollen müssen Sie vorhandene Cloud Billing API-Endpunkte verwenden.
Kunden erstellen
Wenn Sie bereit sind, einen neuen Kunden mit der Cloud Channel API zu erstellen, verwenden Sie den Endpunkt customers.create(). Halten Sie die folgenden Kundendaten bereit, bevor Sie beginnen.
- Primäre Domain
- Name der Organisation
- Adresse
- Postleitzahl (falls zutreffend)
- Ländercode
Nachdem Sie einen Kunden erstellt haben, muss das Feld name der Antwort sicher sein, da es eine eindeutige Kennung für Ihren Kunden ist.
Berechtigung erstellen
Nachdem du einen Kunden erstellt hast, kannst du Berechtigungen für ihn bereitstellen. Gib dazu eine offer mit den Endpunkten entitlements.create() und operations.get() an. Der als provisionedService.provisioningId zurückgegebene Name des Cloud-Rechnungsunterkontos kann mit der Cloud Billing API und dem BigQuery-Export verwendet werden.
Wenn Sie eine Berechtigung mit einem Google Cloud-Angebot erstellen, wird auch ein Cloud-Rechnungsunterkonto erstellt.
Ausführlichere Anleitungen zum Erstellen von Kunden und Berechtigungen, einschließlich Codebeispielen in mehreren Sprachen, finden Sie im Codelab zur End-to-End-Bereitstellung von Google Cloud.