Depuis janvier 2021, vous pouvez utiliser l'API Cloud Channel pour créer des clients, des droits d'accès et des sous-comptes Cloud Billing. 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 de droits d'accès à l'aide de l'API Cloud Channel.
Avant de commencer
Suivez l'atelier de programmation sur l'API Cloud Channel avant de continuer. Vous aurez ainsi la garantie que votre environnement de développement est configuré pour suivre les exemples de code et d'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 Cloud Billing d'un client, vous devez commencer à utiliser le point de terminaison customers.create(), suivi du point de terminaison entitlements.create(), afin de créer un sous-compte Cloud Billing pour un client.
Pour gérer les rôles IAM, vous devez utiliser les points de terminaison existants de l'API Cloud Billing.
Création d'un client
Lorsque vous êtes prêt à créer un client avec l'API Cloud Channel, utilisez le point de terminaison customers.create(). Assurez-vous de disposer des informations client suivantes avant de commencer.
- Domaine principal
- Nom de l'organisation
- Adresse
- Code postal (le cas échéant)
- Code pays
Après avoir créé un client, vous devez sécuriser le champ name de la réponse, car il s'agit d'un identifiant unique pour votre client.
Créer un droit
Après avoir créé un client, vous pouvez lui fournir 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é en tant que provisionedService.provisioningId, peut être utilisé avec l'API Cloud Billing et l'exportation BigQuery.
La création d'un droit avec une offre Google Cloud entraîne également la création d'un sous-compte de facturation Cloud.
Pour obtenir des instructions plus détaillées sur la création de clients et de droits d'accès, y compris des exemples de code dans plusieurs langages, suivez l'atelier de programmation Google Cloud sur le provisionnement de bout en bout.