Standort aus Eintrag eines verbundenen Kontos erstellen

Erstellt einen neuen Listings API-Standort, indem Unternehmensdaten aus einem vorhandenen Eintrag in einem verbundenen Google Business Profile- oder Facebook-Konto übernommen werden. Der Eintrag muss bereits im Konto vorhanden sein (über POST /connected-accounts/connected-account-listings abgerufen) und darf noch nicht mit einem anderen Listings API-Standort verknüpft sein.

Anfragestruktur. Der Body muss in ein input-Objekt mit zwei Pflichtfeldern eingebettet sein: connectedAccountId (das Konto, dem der Eintrag gehört) und connectedAccountListingId (der zu importierende Eintrag). Es gibt kein Feld listingId; es wird vom Schema abgelehnt.

Bei Google-Einträgen importiert die API Name, Adresse, Koordinaten, Telefonnummer, Website, Beschreibung, reguläre und abweichende Öffnungszeiten, primäre und zusätzliche Kategorien, Eröffnungsdatum, Geschäftscode und Zeitzone. Zahlungsmethoden und Links zu Social-Media-Profilen werden aus den Google-Attributen des Eintrags abgeleitet. Google-Attribute, die über Zahlungsmethoden und Links zu Social-Media-Profilen hinausgehen, werden gelesen, aber nicht gespeichert. Bei Facebook werden Name, Standort, Öffnungszeiten, Kategorien, Beschreibung und Kontaktinformationen importiert.

Der neue Standort wird automatisch mit dem verbundenen Konto verknüpft, aus dem er stammt. Bei einem Google-Import werden die Daten nicht erneut an Google übermittelt. Das Profil, aus dem Sie importiert haben, bleibt unverändert, und sein Eintrag meldet syncStatus: IN_PROGRESS bis zur ersten Veröffentlichung dort über POST /api/v4/locations/update. Alle anderen Plattformen werden wie üblich behandelt: Auftragspositionen werden erstellt und der Standort wird an jede weitere Website übermittelt, die für das Konto aktiviert ist.

Dieser Endpunkt akzeptiert weder eine Einschränkung auf bestimmte Websites noch eine Option zum Deaktivieren von Übermittlungen, sodass der Standort immer für alle Plattformen Ihres Kontos erstellt wird. Um ihn auf eine einzelne Plattform zu beschränken, setzen Sie unmittelbar nach der Erstellung über POST /api/v4/locations/update das Feld enabledSiteIds am neuen Standort. Senden Sie diese Aktualisierung, sobald der Standort erstellt wurde: Auftragspositionen für die anderen Plattformen werden kurz nach der Erstellung erzeugt, und bereits erzeugte Auftragspositionen werden durch die Aktualisierung nicht zurückgezogen.

Anwendungsfall: Standorte beim Onboarding gesammelt anlegen. Eine Agentur verbindet das Google-Konto eines Kunden, über das 40 Ladengeschäfte verwaltet werden, die die Agentur noch nie in Listings API erfasst hat. Statt jeden Standort manuell anzulegen, rufen Sie die Einträge des Kontos ab und rufen Sie diesen Endpunkt einmal pro connectedAccountListingId auf, um alle 40 Listings API-Standorte mit den Daten aus Google anzulegen und sie anschließend wie gewohnt abzurechnen und zu verwalten.

success: true bedeutet, dass der Standort erstellt wurde, und locationId ist seine Datenbank-ID. Im Fehlerfall ist success gleich false, locationId gleich null, und errors enthält einen strukturierten, mit einem Code versehenen Fehlergrund, beispielsweise { "code": "SY81067", "message": "Invalid connected account listing ID" }, wenn connectedAccountListingId nicht aufgelöst werden kann. Weitere häufige Fälle sind ein Eintrag, der bereits mit einem anderen Standort verbunden ist, oder ein Konto, dessen Zugangsdaten abgelaufen sind und das über den Endpunkt connect-google oder connect-facebook erneut verbunden werden muss. Um einen Eintrag mit einem vorhandenen Standort zu verknüpfen, statt einen neuen anzulegen, verwenden Sie den Endpunkt connect-listing.