v1Recursos/Connections/postCrear listados de Google
Crear listados de Google
Pone en cola un nuevo Google Business Profile para cada ubicación de la selección que pueda tenerlo. Es la versión API de Crear fichas de Google en Location Manager y el último paso del flujo: llama a preview con locationIds para ver la preparación y los inicios de sesión disponibles, lista los grupos de un inicio de sesión con destinations, vuelve a llamar a preview con accountConnectionId y googleAccountName hasta que canSubmit sea true y luego envía el mismo body aquí. En esta llamada todo se vuelve a comprobar, así que una vista previa anterior no se da por buena. Las ubicaciones en estado ready o review se ponen en cola y el resto vuelve en skipped. confirmedNoExistingProfiles debe ser true o la solicitud devuelve 400. Un 202 significa que el trabajo está en cola, no que los perfiles ya existan: la creación se ejecuta en segundo plano y puede reintentarse o fallar, así que consulta el endpoint de estado. Devuelve 409 cuando el inicio de sesión o el grupo no se pueden usar para esta selección, o cuando no se puede crear ninguna de las ubicaciones.
post
connections:write/api/v1/connections/google-listing-createCuerpo de la solicitud
locationIdsarray of stringobligatorio
Los ids de las ubicaciones con las que trabajar, hasta 200. Los duplicados se ignoran.
accountConnectionIdstringobligatorio
El connectionId del inicio de sesión de Google con el que crear, tomado de accounts en la respuesta de preview. Obligatorio para destinations y create. Opcional para preview, donde lo envías junto con googleAccountName para comprobar un destino.
googleAccountNamestringobligatorio
El resourceName del grupo de Google donde crear los listados, por ejemplo accounts/123456789, tomado de la respuesta de destinations. Obligatorio para create. Opcional para preview.
confirmedNoExistingProfilesboolean (true)obligatorio
Debe ser true. Confirma que estos negocios necesitan nuevos perfiles de Google y que todavía no tienen uno. Cualquier otro valor devuelve 400.
Respuesta
dataobjectopcional
resultsarray of objectopcional
Una entrada por cada ubicación que create intentó poner en cola.
locationIdstringopcional
El id de la ubicación.
outcomestring (queued | blocked | failed_to_queue)opcional
queued (la creación está en marcha), blocked (no se permitió, mira reason) o failed_to_queue (algo falló de nuestro lado, así que vuelve a intentarlo).
connectionIdstringopcional
La nueva conexión de Google pendiente de la ubicación. Solo aparece con queued.
orderItemIdstringopcional
El id del pedido que ejecuta la creación. Solo aparece con queued.
reasonstringopcional
Por qué la ubicación no se puso en cola: submission_not_allowed, un código de límite del plan (feature_disabled, location_limit, connection_limit, cancellation_pending o entitlement) o internal_error. No aparece con queued.
skippedarray of objectopcional
Ubicaciones seleccionadas que no se pusieron en cola porque están excluidas o necesitan corrección, con los mismos campos que locations en la respuesta de preview.
locationIdstringopcional
El id de la ubicación.
clientIdstringopcional
El cliente al que pertenece la ubicación, o null.
namestringopcional
El nombre comercial de la ubicación, o null.
statestring (ready | review | needs_attention | excluded)opcional
ready (se puede crear), review (se puede crear, pero revísala antes porque Google podría tener ya un perfil para ella), needs_attention (corrige la ubicación y vuelve a llamar a preview) o excluded (no tendrá un nuevo listado de Google).
reasonsarray of string (archived | already_connected | creating | needs_reconnection | google_excluded_by_package | opted_out | missing_business_name | missing_google_category | missing_address | possible_existing_profile | previously_connected)opcional
Por qué la ubicación está en este estado. Excluida: archived, already_connected, creating (ya hay una creación en curso), needs_reconnection (vinculada a un listado de Google cuyo acceso venció), google_excluded_by_package (Google no forma parte del paquete de listados de la ubicación) u opted_out. Necesita corrección: missing_business_name, missing_google_category o missing_address (sin calle, ciudad y país, y sin área de servicio). Revisión: possible_existing_profile (un listado de Google encontrada en uno de tus inicios de sesión coincide con esta ubicación) o previously_connected (la ubicación estuvo vinculada a Google y se desconectó). Vacío para una ubicación en estado ready.
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.
404El recurso no se encontró, o no pertenece a su agencia.
409No se puso nada en cola. El code de la respuesta es invalid_destination cuando el inicio de sesión o el grupo no se pueden usar para esta selección, o invalid_request cuando no se puede crear ninguna de las ubicaciones seleccionadas. Llama a preview para ver por qué.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
502No se pudo contactar con Google para leer los grupos del inicio de sesión. Inténtalo de nuevo más tarde. El code de la respuesta es provider_unavailable.
post/api/v1/connections/google-listing-create
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.