Lister les dossiers GMB d'un compte connecté

Renvoie les dossiers (également appelés groupes ou groupes de comptes) de Google Business Profile auxquels le compte Google connecté peut accéder. GBP utilise les dossiers pour organiser les fiches d'établissements au sein d'un compte ; chacun comporte un folderId, un folderName et, lorsque Google le fournit, un locationCount.

Cas d'utilisation : placer une nouvelle fiche dans le bon dossier. Avant d'appeler l'endpoint create-GMB-listing, listez les dossiers du compte et laissez le client en choisir un. Transmettez le folderId choisi (la chaîne accounts/{id}, utilisée telle quelle) afin que la nouvelle fiche soit créée dans ce dossier plutôt qu'à la racine du compte.

Cas d'utilisation : vérifier la concordance avec la structure GBP d'un client. Les enseignes disposant de plusieurs établissements répartissent fréquemment leurs fiches entre plusieurs dossiers. Récupérez la liste des dossiers pour afficher la hiérarchie GBP réelle du client dans votre interface utilisateur et confirmer que vous synchronisez les fiches dans le dossier attendu. Notez que locationCount peut valoir null lorsque Google ne renvoie pas de décompte pour le dossier ; traitez donc cette donnée comme facultative plutôt que comme une valeur faisant autorité. Cet endpoint nécessite un compte connecté de type Google ; le chemin n'est valide que pour les connexions GoogleAccount.