v1Ressourcen/Connections/postGoogle-Gruppen eines Logins auflisten
Google-Gruppen eines Logins auflisten
Gibt die Google-Business-Profile-Gruppen unter einem Google-Login für die Standorte dieser Auswahl zurück. Verwenden Sie den Endpunkt nach dem ersten preview-Aufruf, der die Logins in accounts auflistet, und senden Sie den resourceName der gewählten Gruppe als googleAccountName an preview und create. Der Login muss für den Kunden jedes nicht ausgeschlossenen Standorts der Auswahl erstellen dürfen. Ist das nicht der Fall oder gibt es den Login nicht, lautet die Antwort 404. Ein Login mit abgelaufenem Zugriff liefert 409, bis ihn jemand neu verbindet. Die Gruppen werden live von Google gelesen, 502 bedeutet, dass Google nicht geantwortet hat. Es wird nichts erstellt oder gespeichert.
post
connections:read/api/v1/connections/google-listing-create/destinationsAnfragetext
locationIdsarray of stringerforderlich
Die IDs der zu bearbeitenden Standorte, höchstens 200. Doppelte IDs werden ignoriert.
accountConnectionIdstringerforderlich
Die connectionId des Google-Logins, unter dem erstellt wird, aus accounts in der preview-Antwort. Pflicht für destinations und create. Optional für preview, wo Sie sie zusammen mit googleAccountName senden, um ein Ziel zu prüfen.
Antwort
dataarray of objectoptional
resourceNamestringoptional
Der Google-Ressourcenname der Gruppe, etwa accounts/123456789. Senden Sie ihn als googleAccountName.
displayNamestringoptional
Der Name der Gruppe bei Google.
labelstringoptional
Der Name zur Anzeige in einer Auswahl. Teilen sich zwei Gruppen einen Namen, werden die letzten Zeichen der ID angehängt, um sie zu unterscheiden. Senden Sie ihn nie als googleAccountName.
typestringoptional
Googles Typ für die Gruppe, etwa PERSONAL oder LOCATION_GROUP. ACCOUNT_TYPE_UNSPECIFIED, wenn Google keinen meldet.
rolestringoptional
Die Rolle des Logins in der Gruppe, wie Google sie meldet. Fehlt, wenn Google keine meldet.
verificationStatestringoptional
Der Verifizierungsstatus der Gruppe, wie Google ihn meldet. Er entscheidet nicht darüber, ob Sie in der Gruppe erstellen können.
creatablebooleanoptional
Ob in dieser Gruppe neue Einträge erstellt werden können. Nur Gruppen vom Typ PERSONAL und LOCATION_GROUP kommen in Frage, und nicht, wenn die Rolle des Logins SITE_MANAGER ist.
reasonstring (type_not_supported | insufficient_role)optional
Warum die Gruppe nicht nutzbar ist: type_not_supported (dieser Gruppentyp kann keine neuen Einträge aufnehmen) oder insufficient_role (die Rolle des Logins ist zu eingeschränkt). Fehlt, wenn creatable true ist.
locationCountintegeroptional
Ungefähr wie viele Einträge die Gruppe bereits enthält, laut Googles eigener Zählung. Fehlt, wenn die Zahl nicht gelesen werden konnte oder die Gruppe keine LOCATION_GROUP ist.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Der Zugriff des Google-Logins ist abgelaufen. Verbinden Sie ihn neu und versuchen Sie es dann erneut. Der code der Antwort ist needs_reconnection.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
502Google war nicht erreichbar, um die Gruppen des Logins zu lesen. Versuchen Sie es später erneut. Der code der Antwort ist provider_unavailable.
post/api/v1/connections/google-listing-create/destinations
Ihr API-Schlüssel
Anfragetext*
{}Anleitungen, die diese Ressource verwenden
- 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.