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 :

• Répertorier 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.

Répertorier tous les comptes

Pour valider les comptes associés à un utilisateur authentifié, nous vous recommandons de lister tous ses comptes. Vous pouvez répertorier tous les comptes associés à un utilisateur donné à l'aide de l'API accounts.list.

Pour répertorier 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.