v1Recursos/Connections/postConsultar o status da criação de listagens do Google
Consultar o status da criação de listagens do Google
Retorna em que ponto está a criação da listagem do Google de cada local, com base na conexão do Google do local e no seu pedido de criação do Google mais recente. Chame depois de create e consulte até cada local chegar a created ou failed. Ids de locais aos quais você não tem acesso voltam em unavailableIds. Até 200 locais por solicitação.
post
connections:read/api/v1/connections/google-listing-create/statusCorpo da solicitação
locationIdsarray of stringobrigatório
Os ids dos locais a processar, até 200. Ids duplicados são ignorados.
Resposta
dataobjectopcional
statusesarray of objectopcional
Uma entrada para cada local solicitado ao qual você tem acesso.
locationIdstringopcional
O id do local.
statestring (none | queued | creating | retrying | failed | created)opcional
none (nenhuma criação do Google para este local), queued (aguardando o início), creating (em andamento), retrying (a última tentativa falhou e será executada de novo), failed (parou e não vai terminar sozinha) ou created (o local está vinculado a uma listagem do Google).
orderItemIdstringopcional
O pedido de criação do Google mais recente do local. Ausente quando não há nenhum.
orderItemStatusstring (PENDING | IN_PROGRESS | COMPLETED | FAILED | CANCELED | AUTO_FAILED | SKIPPED)opcional
O status bruto desse pedido. Ausente quando não há nenhum ou quando state é created.
issueCategorystringopcional
Um código de categoria do que deu errado na última tentativa, ou null. Ausente quando state é none ou created.
reasonstringopcional
Uma explicação legível de por que a última tentativa falhou, ou null. Ausente quando state é none ou created.
unavailableIdsarray of stringopcional
Ids de locais solicitados que não foram encontrados ou aos quais você não tem acesso. Eles aparecem aqui em vez de fazer a solicitação falhar.
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.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/connections/google-listing-create/status
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.