v1Ressources/Connexions/postObtenir le statut de la création de fiches Google
Obtenir le statut de la création de fiches Google
Renvoie où en est la création de la fiche Google pour chaque établissement, d'après la connexion Google de l'établissement et sa dernière commande de création Google. Appelez-le après create et interrogez-le jusqu'à ce que chaque établissement atteigne created ou failed. Les ids d'établissements auxquels vous n'avez pas accès reviennent dans unavailableIds. Jusqu'à 200 établissements par requête.
post
connections:read/api/v1/connections/google-listing-create/statusCorps de la requête
locationIdsarray of stringobligatoire
Les ids des établissements à traiter, 200 au maximum. Les doublons sont ignorés.
Réponse
dataobjectfacultatif
statusesarray of objectfacultatif
Une entrée par établissement demandé auquel vous avez accès.
locationIdstringfacultatif
L'id de l'établissement.
statestring (none | queued | creating | retrying | failed | created)facultatif
none (aucune création Google pour cet établissement), queued (en attente de démarrage), creating (en cours), retrying (la dernière tentative a échoué et sera relancée), failed (arrêtée, elle n'aboutira pas d'elle-même) ou created (l'établissement est lié à une fiche Google).
orderItemIdstringfacultatif
La dernière commande de création Google de l'établissement. Absent s'il n'y en a pas.
orderItemStatusstring (PENDING | IN_PROGRESS | COMPLETED | FAILED | CANCELED | AUTO_FAILED | SKIPPED)facultatif
Le statut brut de cette commande. Absent s'il n'y en a pas ou lorsque state vaut created.
issueCategorystringfacultatif
Un code de catégorie pour le problème rencontré lors de la dernière tentative, ou null. Absent lorsque state vaut none ou created.
reasonstringfacultatif
Une explication lisible de l'échec de la dernière tentative, ou null. Absent lorsque state vaut none ou created.
unavailableIdsarray of stringfacultatif
Ids d'établissements demandés introuvables ou auxquels vous n'avez pas accès. Ils sont listés ici au lieu de faire échouer la requête.
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.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/connections/google-listing-create/status
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.