v1Recursos/Connections/postListar os grupos do Google de um login
Listar os grupos do Google de um login
Retorna os grupos do Google Business Profile de um login do Google para os locais desta seleção. Use depois da primeira chamada a preview, que lista os logins em accounts, e envie o resourceName do grupo escolhido como googleAccountName para preview e create. O login precisa poder criar para o cliente de cada local da seleção que não esteja excluído. Se não puder, ou se o login não existir, a resposta é 404. Um login com acesso expirado retorna 409 até alguém reconectá-lo. Os grupos são lidos ao vivo no Google, e 502 significa que o Google não respondeu. Nada é criado nem salvo.
post
connections:read/api/v1/connections/google-listing-create/destinationsCorpo da solicitação
locationIdsarray of stringobrigatório
Os ids dos locais a processar, até 200. Ids duplicados são ignorados.
accountConnectionIdstringobrigatório
O connectionId do login do Google usado para criar, vindo de accounts na resposta de preview. Obrigatório para destinations e create. Opcional para preview, onde você o envia com googleAccountName para verificar um destino.
Resposta
dataarray of objectopcional
resourceNamestringopcional
O nome de recurso do grupo no Google, como accounts/123456789. Envie como googleAccountName.
displayNamestringopcional
O nome do grupo no Google.
labelstringopcional
O nome para exibir em um seletor. Quando dois grupos têm o mesmo nome, os últimos caracteres do id são acrescentados para diferenciá-los. Nunca envie como googleAccountName.
typestringopcional
O tipo que o Google atribui ao grupo, como PERSONAL ou LOCATION_GROUP. ACCOUNT_TYPE_UNSPECIFIED quando o Google não informa nenhum.
rolestringopcional
A função do login no grupo, conforme informada pelo Google. Ausente quando o Google não informa nenhuma.
verificationStatestringopcional
O estado de verificação do grupo, conforme informado pelo Google. Ele não decide se você pode criar no grupo.
creatablebooleanopcional
Se novas listagens podem ser criadas neste grupo. Só se qualificam grupos PERSONAL e LOCATION_GROUP, e não quando a função do login é SITE_MANAGER.
reasonstring (type_not_supported | insufficient_role)opcional
Por que não é possível criar no grupo: type_not_supported (este tipo de grupo não aceita novas listagens) ou insufficient_role (a função do login é limitada demais). Ausente quando creatable é true.
locationCountintegeropcional
Quantas listagens o grupo já tem, aproximadamente, segundo a contagem do próprio Google. Ausente quando não foi possível ler ou quando o grupo não é LOCATION_GROUP.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
409O acesso do login do Google expirou. Reconecte-o e tente de novo. O code da resposta é needs_reconnection.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
502Não foi possível acessar o Google para ler os grupos do login. Tente de novo mais tarde. O code da resposta é provider_unavailable.
post/api/v1/connections/google-listing-create/destinations
Sua chave de API
Corpo da solicitação*
{}Guias que usam 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.