v1Ressourcen/Connections/postGoogle-Einträge erstellen
Google-Einträge erstellen
Stellt für jeden Standort der Auswahl, der ein neues Google Business Profile bekommen kann, die Erstellung in die Warteschlange. Das ist die API-Version von Google-Einträge erstellen im Location Manager und der letzte Schritt des Ablaufs: Rufen Sie preview mit locationIds auf, um die Bereitschaft und die nutzbaren Logins zu sehen, listen Sie mit destinations die Gruppen eines Logins auf, rufen Sie preview erneut mit accountConnectionId und googleAccountName auf, bis canSubmit true ist, und senden Sie dann denselben Body hierher. Bei diesem Aufruf wird alles erneut geprüft, eine frühere Vorschau gilt also nicht als verbindlich. Standorte im Zustand ready oder review werden eingereiht, die übrigen kommen in skipped zurück. confirmedNoExistingProfiles muss true sein, sonst antwortet die Anfrage mit 400. Ein 202 bedeutet, dass die Arbeit eingereiht ist, nicht dass die Profile schon existieren: Die Erstellung läuft im Hintergrund und kann wiederholt werden oder fehlschlagen, fragen Sie deshalb den Status-Endpunkt ab. Gibt 409 zurück, wenn der Login oder die Gruppe für diese Auswahl nicht nutzbar ist oder keiner der Standorte erstellt werden kann.
post
connections:write/api/v1/connections/google-listing-createAnfragetext
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.
googleAccountNamestringerforderlich
Der resourceName der Google-Gruppe, in der die Einträge erstellt werden, etwa accounts/123456789, aus der destinations-Antwort. Pflicht für create. Optional für preview.
confirmedNoExistingProfilesboolean (true)erforderlich
Muss true sein. Bestätigt, dass diese Unternehmen neue Google-Profile brauchen und noch keines haben. Jeder andere Wert liefert 400.
Antwort
dataobjectoptional
resultsarray of objectoptional
Ein Eintrag für jeden Standort, den create einzureihen versucht hat.
locationIdstringoptional
Die ID des Standorts.
outcomestring (queued | blocked | failed_to_queue)optional
queued (die Erstellung ist unterwegs), blocked (sie war nicht erlaubt, siehe reason) oder failed_to_queue (bei uns ist etwas schiefgegangen, versuchen Sie es erneut).
connectionIdstringoptional
Die neue, ausstehende Google-Verbindung des Standorts. Nur vorhanden bei queued.
orderItemIdstringoptional
Die ID des Auftrags, der die Erstellung ausführt. Nur vorhanden bei queued.
reasonstringoptional
Warum der Standort nicht eingereiht wurde: submission_not_allowed, ein Code für ein Tariflimit (feature_disabled, location_limit, connection_limit, cancellation_pending oder entitlement) oder internal_error. Fehlt bei queued.
skippedarray of objectoptional
Ausgewählte Standorte, die nicht eingereiht wurden, weil sie ausgeschlossen sind oder korrigiert werden müssen, mit denselben Feldern wie locations in der preview-Antwort.
locationIdstringoptional
Die ID des Standorts.
clientIdstringoptional
Der Kunde, zu dem der Standort gehört, oder null.
namestringoptional
Der Unternehmensname des Standorts oder null.
statestring (ready | review | needs_attention | excluded)optional
ready (kann erstellt werden), review (kann erstellt werden, sollte aber zuerst geprüft werden, weil Google möglicherweise schon ein Profil dafür hat), needs_attention (korrigieren Sie den Standort und rufen Sie preview erneut auf) oder excluded (bekommt keinen neuen Google-Eintrag).
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)optional
Warum der Standort in diesem Zustand ist. Ausgeschlossen: archived, already_connected, creating (eine Erstellung läuft bereits), needs_reconnection (mit einem Google-Eintrag verknüpft, dessen Zugriff abgelaufen ist), google_excluded_by_package (Google gehört nicht zum Eintragspaket des Standorts) oder opted_out. Korrektur nötig: missing_business_name, missing_google_category oder missing_address (keine Straße, Stadt und kein Land und kein Einzugsgebiet). Prüfung: possible_existing_profile (ein unter einem Ihrer Logins gefundener Google-Eintrag passt zu diesem Standort) oder previously_connected (der Standort war früher mit Google verknüpft und wurde getrennt). Leer bei einem Standort im Zustand ready.
unavailableIdsarray of stringoptional
Angefragte Standort-IDs, die nicht gefunden wurden oder auf die Sie keinen Zugriff haben. Sie werden hier aufgeführt, statt die Anfrage scheitern zu lassen.
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.
409Es wurde nichts eingereiht. Der code der Antwort ist invalid_destination, wenn Login oder Gruppe für diese Auswahl nicht nutzbar sind, oder invalid_request, wenn keiner der ausgewählten Standorte erstellt werden kann. Rufen Sie preview auf, um den Grund zu sehen.
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
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.