Ce tutoriel vous explique comment utiliser les données des comptes. L'API My Business Account Management vous permet d'effectuer les opérations suivantes :
- Lister tous les comptes
- Renvoyer un compte spécifique
- Mettre à jour un compte
Avant de commencer
Avant d'utiliser l'API My Business Account Management, vous devez enregistrer votre application et obtenir des identifiants OAuth 2.0.
Pour savoir comment utiliser les API Business Profile, consultez Configuration de base.
Lister Ltous les comptes
Pour valider les comptes associés à un utilisateur authentifié, nous vous recommandons de lister tous ses comptes. Vous pouvez lister ltous les comptes associés à un utilisateur donné à l'aide de l'API accounts.list
.
Pour lister tous les comptes d'un utilisateur authentifié, utilisez le code suivant :
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Renvoyer un compte spécifique
Vous souhaitez n'afficher que les informations d'un compte spécifique pour un utilisateur authentifié ? Dans ce cas, utilisez l'API accounts.get
pour renvoyer un compte spécifique et consulter d'autres données relatives au compte.
Pour renvoyer un compte spécifique en fonction de son nom, utilisez le code suivant :
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Mettre à jour un compte
Modifier le nom d'un compte constitue une tâche administrative essentielle. Utilisez l'API accounts.update
pour modifier le nom du compte.
Pour mettre à jour un compte spécifique en fonction de son nom, utilisez le code suivant :
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId} { "account": { "accountName": "Anne Droyd" }, "languageCode": "en", "validateOnly": "true" }
Restrictions
- Seul le champ
accountName
peut être modifié pour un compte. Tous les autres champs transmis sont ignorés. - Seuls les comptes de type
BUSINESS
peuvent être mis à jour de cette manière.