Listings APIListings API
Anmelden
POST/api/v4/locations/oauth-disconnect

Einen Standort von Apple Business Connect trennen

Trennt einen Standort vom Apple Business-Konto des Inhabers. Er bleibt auf Apple Maps und wird über das ListingsAPI-Konto veröffentlicht.

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.sitestringerforderlichSet to `APPLE`.

Beispielanfrage

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

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

Antworten

200Connection removed. Response key `disconnectConnectedAccountsLocations`.
Response
{  "data": {    "disconnectConnectedAccountsLocations": {      "clientMutationId": null,      "success": true,      "errors": null    }  }}
401Unauthenticated, missing or invalid API key.
403The key is valid but not permitted to disconnect this location (`SY90003`).

Verwenden Sie dies, wenn ein Kunde die Zusammenarbeit beendet und sein Apple Business-Konto mitnimmt. Der Standort bleibt in Ihrem Konto und auf Apple Maps: Spätere Aktualisierungen werden über das Apple Business Connect-Konto von ListingsAPI veröffentlicht, und Apple prüft die Übermittlung vor der Veröffentlichung. Andere Plattformverbindungen des Standorts sind nicht betroffen.

Bei einem Standort ohne aktive Apple-Verbindung wird SY10057 zurückgegeben. Daher bedeutet success: true, dass eine Verbindung entfernt wurde. Der Aufruf verarbeitet einen Standort; verwenden Sie eine Schleife, um mehrere Standorte zu trennen.

Um wieder über das Konto des Inhabers zu veröffentlichen, senden Sie ihm einen neuen Link aus Einen Standort mit Apple Business Connect verbinden.

Diese Seite dokumentiert den Fall site: "APPLE" aus Einen einzelnen Standort von einer Plattform trennen.

Dieser Endpunkt ändert eine aktive Verbindung. Die oben gezeigte Anfrage und Antwort dienen als Beispiele.

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