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

Putuskan koneksi lokasi dari Apple Business Connect

Menghapus koneksi satu lokasi ke akun Apple Business pemiliknya. Lokasi tetap ada di Apple Maps dan dipublikasikan melalui akun ListingsAPI.

Memerlukan kunci API. Lihat Autentikasi untuk format header dan rotasi kunci.

Parameter

Body

NamaTipeWajibDeskripsi
inputobjectwajibWrapper object. The entire request body must be nested under `input`.
input.locationIdstringwajibBase64-encoded Relay ID of the one location to disconnect.
input.sitestringwajibSet to `APPLE`.

Contoh permintaan

Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.

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

Respons

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`).

Gunakan ini saat klien berhenti menggunakan layanan Anda dan membawa serta akun Apple Business mereka. Lokasi tetap ada di akun Anda dan di Apple Maps: pembaruan selanjutnya dipublikasikan melalui akun Apple Business Connect milik ListingsAPI, dan Apple memverifikasi pengajuan sebelum memublikasikannya. Koneksi ke platform publikasi lain pada lokasi tersebut tidak terpengaruh.

Lokasi tanpa koneksi Apple yang aktif mengembalikan SY10057, sehingga success: true berarti koneksi telah dihapus. Panggilan ini menangani satu lokasi; gunakan perulangan untuk memutuskan koneksi beberapa lokasi.

Untuk kembali memublikasikan melalui akun pemilik, kirimkan tautan baru kepada mereka dari Hubungkan lokasi ke Apple Business Connect.

Halaman ini mendokumentasikan kasus site: "APPLE" dari Putuskan koneksi satu lokasi dari platform publikasi.

Endpoint ini mengubah koneksi aktif. Contoh permintaan dan respons di atas merupakan ilustrasi.

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