Listings APIListings API
Anmelden
POST/api/v4/connected-accounts/disconnect-listing

Verbindung zwischen einem Eintrag und einem Standort trennen

Trennt die Verbindung zwischen dem verknüpften Plattform-Eintrag und einem einzelnen Standort in der Listings API.

Erfordert einen API-Schlüssel. Format des Headers und Schlüsselrotation finden Sie unter Authentifizierung.

Parameter

Body

NameTypErforderlichBeschreibung
inputobjecterforderlichWrapper object. The entire request body must be nested under `input`.
input.locationIdstringerforderlichBase64-encoded Relay ID of the one location to disconnect.
input.sitestringoptionalPublisher to disconnect from: `GOOGLE`, `FACEBOOK`, or `APPLE`. Required unless you send `providerId`.
input.providerIdstringoptionalThe publisher's own account identifier, as an alternative to `site`. Required unless you send `site`.

Beispielanfrage

Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "site": "GOOGLE"  }}

Antworten

200Listing disconnected.
Response
{  "data": {    "disconnectConnectedAccountsLocations": {      "clientMutationId": null,      "success": true,      "errors": null    }  }}
401Unauthenticated, missing or invalid API key.

Entfernt die Verknüpfung zwischen einem Standort in der Listings API und dem Plattform-Eintrag (Google Business Profile, Facebook Page oder Apple Business Connect), mit dem er derzeit verbunden ist. Nach der Trennung überträgt die Listings API keine Aktualisierungen mehr an diesen Eintrag. Der Standort selbst bleibt in Ihrem Konto erhalten; nur die Verknüpfung mit dem Eintrag wird getrennt.

Anfragestruktur. Der Anfragetext muss in ein input-Objekt eingebettet sein, das genau einen locationId sowie entweder site (GOOGLE, FACEBOOK oder APPLE) oder providerId enthält, um anzugeben, welche Verbindung getrennt werden soll. Dies ist kein Endpunkt für die Massenverarbeitung: Pro Aufruf wird ein Standort verarbeitet, verwenden Sie also eine Schleife, wenn Sie mehrere verarbeiten müssen.

Wenn Sie weder site noch providerId senden, wird SY10056 zurückgegeben („Die Plattform ist für die Trennung der Standortverbindung nicht gültig“). Für einen Standort ohne aktive Verbindung zu dieser Plattform wird SY10057 zurückgegeben („Der Standort ist nicht mit der Plattform verbunden“), statt den Vorgang stillschweigend als erfolgreich zu melden. Daher bedeutet success: true tatsächlich, dass eine Verknüpfung entfernt wurde.

Anwendungsfall: einen Standort einem anderen Konto zuordnen. Wenn ein Kunde ein Ladengeschäft von einem Google-Konto in ein anderes verschiebt, trennen Sie hier zunächst mit site: "GOOGLE" die Verbindung zum aktuellen Eintrag des Standorts und verwenden Sie anschließend trigger-matches und connect-listing für das neue verbundene Konto, um den Standort mit dem richtigen Eintrag zu verknüpfen.

Anwendungsfall: Verwaltung beenden, ohne Daten zu löschen. Wenn ein Kunde zu einem niedrigeren Tarif wechselt und seine Google-/Facebook-Präsenz nicht mehr von der Listings API verwalten lassen möchte, aber den Standortdatensatz und dessen bei der Listings API gehostete Daten behalten möchte, trennen Sie die Verbindung zum Eintrag, statt den Standort zu archivieren. Dadurch wird die ausgehende Synchronisierung gestoppt, während der Standort für andere Plattformen erhalten bleibt.

Dieser Endpunkt ändert eine aktive Verbindung und überträgt die Änderung an die Plattform. Die oben gezeigte Anfrage und Antwort sind Beispiele.

Request
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-listing' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "site": "GOOGLE"    }  }'
Run in playground