v1Recursos/Connections/postConsultar el estado de la creación de listados de Google
Consultar el estado de la creación de listados de Google
Devuelve en qué punto está la creación del listado de Google de cada ubicación, a partir de la conexión de Google de la ubicación y de su pedido de creación de Google más reciente. Llámalo después de create y consúltalo hasta que cada ubicación llegue a created o failed. Los ids de ubicaciones a los que no tienes acceso vuelven en unavailableIds. Hasta 200 ubicaciones por solicitud.
post
connections:read/api/v1/connections/google-listing-create/statusCuerpo de la solicitud
locationIdsarray of stringobligatorio
Los ids de las ubicaciones con las que trabajar, hasta 200. Los duplicados se ignoran.
Respuesta
dataobjectopcional
statusesarray of objectopcional
Una entrada por cada ubicación solicitada a la que tienes acceso.
locationIdstringopcional
El id de la ubicación.
statestring (none | queued | creating | retrying | failed | created)opcional
none (no hay creación de Google para esta ubicación), queued (esperando para empezar), creating (en curso), retrying (el último intento falló y se volverá a ejecutar), failed (se detuvo y no terminará por sí sola) o created (la ubicación está vinculada a un listado de Google).
orderItemIdstringopcional
El pedido de creación de Google más reciente de la ubicación. No aparece cuando no hay ninguno.
orderItemStatusstring (PENDING | IN_PROGRESS | COMPLETED | FAILED | CANCELED | AUTO_FAILED | SKIPPED)opcional
El estado sin procesar de ese pedido. No aparece cuando no hay ninguno o cuando state es created.
issueCategorystringopcional
Un código de categoría de lo que falló en el último intento, o null. No aparece cuando state es none o created.
reasonstringopcional
Una explicación legible de por qué falló el último intento, o null. No aparece cuando state es none o created.
unavailableIdsarray of stringopcional
Ids de ubicaciones solicitados que no se encontraron o a los que no tienes acceso. Se listan aquí en lugar de hacer fallar la solicitud.
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/connections/google-listing-create/status
Su clave de API
Cuerpo de la solicitud*
{}Guías que usan este recurso
- 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.