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:

• Listez 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 vous lancer avec les API Fiche d'établissement, consultez Configuration de base.

Lister tous les comptes

Un excellent moyen de valider les comptes associés à un utilisateur authentifié consiste à lister tous ses comptes. Utilisez l'API accounts.list pour répertorier tous les comptes associés à un utilisateur.

Pour répertorier tous les comptes d'un utilisateur authentifié, utilisez le code suivant:

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

Renvoyer un compte spécifique

Parfois, vous ne souhaitez afficher que des informations sur un compte spécifique pour un utilisateur authentifié. Utilisez l'API accounts.get pour renvoyer un compte spécifique et consulter des informations supplémentaires sur celui-ci.

Pour renvoyer un compte spécifique en indiquant son nom, utilisez le code suivant:

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

Mettre à jour un compte

Modifier le nom d'un compte est 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 d'un compte peut être modifié. Tous les autres champs transmis sont ignorés.
• Seuls les comptes de type BUSINESS peuvent être mis à jour de cette manière.