v1Ressources/Clients/postImporter des établissements Google
Importer des établissements Google
Importer les établissements en cache selon le parcours de l’interface. scope=ids exige fetchedListingIds; scope=folder exige folder, et null signifie sans dossier. account doit être explicite. Exclusions et filtre restreignent la sélection. maxLocations limite un import partiel, y compris à zéro. Le résultat contient ok, refus et quantités de capacité, lignes importées ou en cours, ainsi que batchId et partial le cas échéant. HTTP 200 ne signifie ni ok=true ni import terminé. notifyByEmail utilise l’e-mail de l’utilisateur agissant, jamais un destinataire arbitraire. Aucun gestionnaire interne n’est exposé.
post
clients:write/api/v1/clients/{id}/google/importParamètres de requête
idstringobligatoire
Corps de la requête
connectionIdstringobligatoire
scopestring (ids | folder | account)facultatif
fetchedListingIdsarray of stringfacultatif
folderstringfacultatif
excludeIdsarray of stringfacultatif
maxLocationsintegerfacultatif
filterstringfacultatif
notifyByEmailbooleanfacultatif
Réponse
dataobjectobligatoire
okbooleanfacultatif
reasonstring (nothing_selected | nothing_to_import | no_headroom | over_cap)facultatif
batchIdstringfacultatif
totalintegerfacultatif
alreadyImportedintegerfacultatif
alreadyQueuedintegerfacultatif
partialbooleanfacultatif
importableintegerfacultatif
availableintegerfacultatif
overintegerfacultatif
maxLocationsintegerfacultatif
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.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503Le service est temporairement indisponible. Réessayez l’ajout de crédits avec la même clé d’idempotence.
post/api/v1/clients/{id}/google/import
Votre clé API
id *
Corps de la requête*
{}Guides qui utilisent cette ressource
- 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.
- Create a Location with the Synup APICreate a business location in one POST, with or without a client, get back a locationId, and know which fields matter and which can wait.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- 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 Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.
- 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 Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.