v1Recursos/Connections/postListar los grupos de Google de un inicio de sesión
Listar los grupos de Google de un inicio de sesión
Devuelve los grupos de Google Business Profile de un inicio de sesión de Google para las ubicaciones de esta selección. Úsalo después de la primera llamada a preview, que lista los inicios de sesión en accounts, y envía el resourceName del grupo que elijas como googleAccountName a preview y a create. El inicio de sesión debe poder crear para el cliente de cada ubicación de la selección que no esté excluida. Si no puede, o si el inicio de sesión no existe, la respuesta es 404. Un inicio de sesión cuyo acceso venció devuelve 409 hasta que alguien lo vuelva a conectar. Los grupos se leen en vivo desde Google, y un 502 significa que Google no respondió. No se crea ni se guarda nada.
post
connections:read/api/v1/connections/google-listing-create/destinationsCuerpo 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.
Respuesta
dataarray of objectopcional
resourceNamestringopcional
El nombre de recurso de Google del grupo, por ejemplo accounts/123456789. Envíalo como googleAccountName.
displayNamestringopcional
El nombre del grupo en Google.
labelstringopcional
El nombre que se muestra en un selector. Cuando dos grupos comparten nombre, se añaden los últimos caracteres del id para distinguirlos. Nunca lo envíes como googleAccountName.
typestringopcional
El tipo que Google asigna al grupo, por ejemplo PERSONAL o LOCATION_GROUP. ACCOUNT_TYPE_UNSPECIFIED cuando Google no informa ninguno.
rolestringopcional
El rol del inicio de sesión en el grupo, tal como lo informa Google. No aparece cuando Google no informa ninguno.
verificationStatestringopcional
El estado de verificación del grupo, tal como lo informa Google. No determina si puedes crear en el grupo.
creatablebooleanopcional
Si se pueden crear nuevos listados en este grupo. Solo califican los grupos PERSONAL y LOCATION_GROUP, y no cuando el rol del inicio de sesión es SITE_MANAGER.
reasonstring (type_not_supported | insufficient_role)opcional
Por qué no se puede crear en el grupo: type_not_supported (este tipo de grupo no admite nuevos listados) o insufficient_role (el rol del inicio de sesión es demasiado limitado). No aparece cuando creatable es true.
locationCountintegeropcional
Cuántos listados tiene ya el grupo, aproximadamente, según el propio recuento de Google. No aparece cuando no se pudo leer o cuando el grupo no es LOCATION_GROUP.
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.
409El acceso del inicio de sesión de Google venció. Vuelve a conectarlo y luego inténtalo de nuevo. El code de la respuesta es needs_reconnection.
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/destinations
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.