Utiliser les données des comptes

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 :

HTTP
$ 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 :

HTTP
$ 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 :

HTTP
$ 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.