Depuis janvier 2021, vous pouvez utiliser l'API Cloud Channel pour créer des clients, des droits d'accès et des sous-comptes de facturation Cloud. Si vous utilisez actuellement l'API Cloud Billing pour gérer ces tâches, nous vous recommandons d'utiliser plutôt l'API Cloud Channel.
Ce guide présente les principes de base de la création de clients et d'autorisations à l'aide de l'API Cloud Channel.
Avant de commencer
Terminez l'atelier de programmation sur l'API Cloud Channel avant de continuer. Vous vous assurerez ainsi que votre environnement de développement est configuré pour suivre les exemples de code et les autres ateliers de programmation.
Résumé des modifications
Si vous utilisez actuellement le point de terminaison billingAccounts.create de l'API Cloud Billing pour créer le sous-compte de facturation Cloud Billing d'un client, vous devez commencer à utiliser le point de terminaison customers.create(), suivi du point de terminaison entitlements.create(), pour créer un sous-compte de facturation Cloud Billing pour un client.
Pour gérer les rôles IAM, vous devez utiliser les points de terminaison de l'API Cloud Billing existants.
Créer un client
Lorsque vous êtes prêt à créer un client avec l'API Cloud Channel, utilisez le point de terminaison customers.create(). Avant de commencer, assurez-vous de disposer des informations client suivantes.
- Domaine principal
- Nom de l'organisation
- Adresse
- Code postal (le cas échéant)
- Code pays
Une fois que vous avez créé un client, vous devez sécuriser le champ name de la réponse, car il s'agit d'un identifiant unique de votre client.
Créer un droit
Une fois que vous avez créé un client, vous pouvez lui provisionner des droits d'accès en spécifiant un offer avec les points de terminaison entitlements.create() et operations.get(). Le nom du sous-compte Cloud Billing, renvoyé sous la forme provisionedService.provisioningId, peut être utilisé avec l'API Cloud Billing et l'exportation BigQuery.
Si vous créez un droit d'accès avec une offre Google Cloud , un sous-compte de facturation Cloud est également créé.
Pour obtenir des instructions plus détaillées sur la création de clients et d'autorisations, y compris des exemples de code dans plusieurs langues, suivez l' Google Cloudatelier de programmation sur le provisionnement de bout en bout.