v1Ressources/Connexions/postLister les groupes Google d'un identifiant
Lister les groupes Google d'un identifiant
Renvoie les groupes Google Business Profile d'un identifiant Google pour les établissements de cette sélection. Utilisez-le après le premier appel à preview, qui liste les identifiants dans accounts, et envoyez le resourceName du groupe choisi comme googleAccountName à preview et à create. L'identifiant doit pouvoir créer pour le client de chaque établissement non exclu de la sélection. Si ce n'est pas le cas, ou si l'identifiant n'existe pas, la réponse est 404. Un identifiant dont l'accès a expiré renvoie 409 jusqu'à ce que quelqu'un le reconnecte. Les groupes sont lus en direct auprès de Google, et un 502 signifie que Google n'a pas répondu. Rien n'est créé ni enregistré.
post
connections:read/api/v1/connections/google-listing-create/destinationsCorps de la requête
locationIdsarray of stringobligatoire
Les ids des établissements à traiter, 200 au maximum. Les doublons sont ignorés.
accountConnectionIdstringobligatoire
Le connectionId de l'identifiant Google sous lequel créer, issu de accounts dans la réponse de preview. Obligatoire pour destinations et create. Facultatif pour preview, où vous l'envoyez avec googleAccountName pour vérifier une destination.
Réponse
dataarray of objectfacultatif
resourceNamestringfacultatif
Le nom de ressource Google du groupe, par exemple accounts/123456789. Envoyez-le comme googleAccountName.
displayNamestringfacultatif
Le nom du groupe chez Google.
labelstringfacultatif
Le nom à afficher dans un sélecteur. Lorsque deux groupes portent le même nom, les derniers caractères de l'id sont ajoutés pour les distinguer. Ne l'envoyez jamais comme googleAccountName.
typestringfacultatif
Le type que Google attribue au groupe, par exemple PERSONAL ou LOCATION_GROUP. ACCOUNT_TYPE_UNSPECIFIED lorsque Google n'en indique aucun.
rolestringfacultatif
Le rôle de l'identifiant dans le groupe, tel que Google l'indique. Absent lorsque Google n'en indique aucun.
verificationStatestringfacultatif
L'état de validation du groupe, tel que Google l'indique. Il ne détermine pas si vous pouvez créer dans le groupe.
creatablebooleanfacultatif
Indique si de nouvelles fiches peuvent être créées dans ce groupe. Seuls les groupes PERSONAL et LOCATION_GROUP sont admis, et pas lorsque le rôle de l'identifiant est SITE_MANAGER.
reasonstring (type_not_supported | insufficient_role)facultatif
Pourquoi le groupe n'est pas utilisable : type_not_supported (ce type de groupe ne peut pas accueillir de nouvelles fiches) ou insufficient_role (le rôle de l'identifiant est trop limité). Absent lorsque creatable vaut true.
locationCountintegerfacultatif
Le nombre approximatif de fiches que le groupe contient déjà, d'après le décompte de Google. Absent lorsqu'il n'a pas pu être lu ou que le groupe n'est pas un LOCATION_GROUP.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409L'accès de l'identifiant Google a expiré. Reconnectez-le, puis réessayez. Le code de la réponse est needs_reconnection.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
502Google n'a pas pu être joint pour lire les groupes de l'identifiant. Réessayez plus tard. Le code de la réponse est provider_unavailable.
post/api/v1/connections/google-listing-create/destinations
Votre clé API
Corps de la requête*
{}Guides qui utilisent cette ressource
- What Is a Business Listings API?A business listings API manages a business's name, address, hours and more across many publishers at once, with sync status and duplicate detection built in.
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Update Business Information Across Google, Apple, Bing and DirectoriesPush one business-information change to Google, Apple, Bing and the directory network through a single API call, and verify it reached each publisher.
- How to Manage Thousands of Business Locations via APIDesign a sync job for thousands of locations on the Synup API with cursor pagination, tags, rate-limit handling, an id map and rollup health checks.
- How Google Business Profile Synchronization WorksGoogle Business Profile sync rests on an owner's OAuth consent, matching a location to the right Google listing, then a write-and-verify loop.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Connect and Manage Google Business Profiles via APIConnect a Google Business Profile to a location, match the account's listings, keep the profile in sync and handle reconnects with the Synup API.
- Building Publisher Integrations Directly vs Using SynupWhat it really costs to integrate Google, Apple, Bing and directories yourself, versus one API, and how to decide between them or combine both.