v1Recursos/Clients/postImportar ubicaciones de Google
Importar ubicaciones de Google
Importar ubicaciones guardadas como en la interfaz. scope=ids requiere fetchedListingIds; scope=folder requiere folder y null significa sin carpeta. account debe ser explícito. Exclusiones y filtros limitan la selección. maxLocations limita la importación parcial, incluido cero. El resultado incluye ok, motivos y cantidades de capacidad, filas importadas o en curso, y batchId y partial cuando corresponda. HTTP 200 no implica ok=true ni importaciones terminadas. notifyByEmail usa el correo del usuario que actúa, nunca un destinatario arbitrario. No expone controladores internos.
post
clients:write/api/v1/clients/{id}/google/importParámetros de consulta
idstringobligatorio
Cuerpo de la solicitud
connectionIdstringobligatorio
scopestring (ids | folder | account)opcional
fetchedListingIdsarray of stringopcional
folderstringopcional
excludeIdsarray of stringopcional
maxLocationsintegeropcional
filterstringopcional
notifyByEmailbooleanopcional
Respuesta
dataobjectobligatorio
okbooleanopcional
reasonstring (nothing_selected | nothing_to_import | no_headroom | over_cap)opcional
batchIdstringopcional
totalintegeropcional
alreadyImportedintegeropcional
alreadyQueuedintegeropcional
partialbooleanopcional
importableintegeropcional
availableintegeropcional
overintegeropcional
maxLocationsintegeropcional
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La solicitud entra en conflicto con el estado actual del recurso — por ejemplo, cambiar el correo electrónico o el teléfono de un destinatario al que ya se le ha enviado un mensaje, o una invitación de equipo que ya fue aceptada (o que aún no ha sido aceptada).
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503El servicio no está disponible temporalmente. Reintente la asignación de créditos con la misma clave de idempotencia.
post/api/v1/clients/{id}/google/import
Su clave de API
id *
Cuerpo de la solicitud*
{}Guías que usan este recurso
- 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.