À mesure que votre organisation se développe, vous pouvez vous sentir submergé par la gestion de vos établissements et des différentes autorisations. Ce guide présente les bonnes pratiques à suivre pour gérer plusieurs établissements et décrit les types de comptes suivants :
- Compte personnel
- Compte d'organisation
- Compte de groupe d'établissements
- Compte de groupe d'utilisateurs
Types de comptes
Chaque type de compte a un rôle particulier dans la gestion des établissements. Un compte personnel peut gérer un compte d'organisation, puis obtenir des autorisations pour accéder aux groupes d'utilisateurs et d'établissements au sein de l'organisation. Cela lui permet alors de gérer les établissements et les fiches via les groupes d'établissements correspondants.
Compte personnel
Un compte personnel vous est automatiquement proposé lorsque vous créez un compte Google. Un compte personnel peut être propriétaire et administrateur de fiches.
Compte d'organisation
Un compte d'organisation est le compte de niveau supérieur qui représente votre agence. Votre groupe d'établissements et vos groupes d'utilisateurs y sont enregistrés, et tous les membres de l'organisation y ont accès. Les établissements peuvent faire partie de plusieurs organisations.
Avec l'API My Business Account Management, vous pouvez utiliser la méthode accounts.admins.create pour inviter des comptes personnels à gérer le compte d'organisation ou à en être le propriétaire.
Compte de groupe d'établissements
Un groupe d'établissements permet de gérer un ensemble d'établissements individuels. Vous pouvez utiliser un groupe d'établissements pour effectuer des tâches groupées sur plusieurs établissements. Lorsque vous ajoutez des comptes personnels et des groupes d'utilisateurs à un groupe d'établissements, ils héritent des autorisations du groupe d'établissements.
Vous pouvez également créer des groupes d'établissements pour classer les établissements, par exemple par chaîne, région ou catégorie. Un établissement peut appartenir à plusieurs groupes d'établissements à la fois.
Avec l'API My Business Account Management, vous pouvez utiliser la méthode accounts.create pour créer des groupes d'établissements et transférer des établissements vers un groupe d'établissements. Cette API vous permet également d'inviter des comptes personnels à gérer des groupes d'établissements. Les groupes d'utilisateurs peuvent être ajoutés directement aux groupes d'établissements à partir de l'interface Web.
Compte de groupe d'utilisateurs
Pour gérer les autorisations à grande échelle, créez un groupe d'utilisateurs. Vous pouvez ajouter des comptes personnels à un groupe d'utilisateurs. Vous pouvez ensuite accorder au groupe d'utilisateurs des droits d'accès en tant qu'administrateur à plusieurs groupes d'établissements au sein de l'organisation. Désormais, tous les comptes personnels au sein d'un groupe d'utilisateurs peuvent effectuer des actions de niveau administrateur sur les établissements inclus dans les groupes d'établissements.
Par exemple, lorsqu'une nouvelle personne rejoint une équipe chargée des opérations, vous pouvez l'ajouter directement à un groupe d'utilisateurs. Elle aura alors immédiatement accès à tous les établissements auxquels ses collègues ont accès. Accorder des droits d'accès aux utilisateurs à chaque établissement prend plus de temps, ce qui rend la gestion plus difficile.
Avec l'API My Business Account Management, vous pouvez utiliser la méthode accounts.create pour créer des groupes d'utilisateurs. Cette API vous permet également d'inviter des comptes personnels à gérer les administrateurs de comptes et d'établissements.
Utiliser l'API pour appeler une liste de tous les comptes
Pour répertorier tous les comptes auxquels vous avez accès et les types de comptes associés, appelez la méthode accounts.list avec vos identifiants OAuth. La réponse contient une liste de tous les comptes, des ID de compte associés (inclus dans le champ name) et des types de comptes.
Requête
Voici un exemple de requête accounts.list :
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts Authorization: Bearer <access_token>
Réponse
Voici un exemple de réponse accounts.list :
{
"accounts": [
{
"name": "accounts/{accountId}",
"accountName": "John Doe",
"type": "PERSONAL",
"state": {
"status": "UNVERIFIED"
},
"profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
},
{
"name": "accounts/{accountId}",
"accountName": "John Doe’s Location Group",
"type": "LOCATION_GROUP",
"role": "OWNER",
"state": {
"status": "UNVERIFIED"
},
"accountNumber": "{accountNumber}",
"permissionLevel": "OWNER_LEVEL"
}
]
}
Tous les types de comptes détaillés dans ce guide peuvent être inclus dans la réponse à votre requête accounts.list. Examinez la liste des comptes et identifiez celui qui a accès aux établissements que vous souhaitez gérer. Ensuite, appelez accounts.locations.list avec le champ name du compte concerné afin de récupérer la liste des établissements auxquels le compte a accès.
Par exemple, si vous souhaitez récupérer tous les établissements appartenant au "groupe d'établissements Jacques Dupont", exécutez la requête suivante :
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>
La réponse renvoie la liste des établissements auxquels l'utilisateur a accès, comme suit :
{
"locations": [
{
"name": "locations/{locationId}",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId}",
"locationName": "2nd Test Business",
...
}
]
}
Diagramme illustrant la gestion des établissements
Le diagramme ci-dessous illustre les points suivants :
- Une organisation peut contenir plusieurs groupes d'utilisateurs.
- Un groupe d'utilisateurs peut gérer plusieurs groupes d'établissements.
- Un groupe d'établissements peut contenir plusieurs établissements.
- Un établissement peut appartenir à plusieurs groupes d'établissements au sein de différentes organisations.
