Listings APIListings API
登入
POST/api/v4/locations/oauth-disconnect

中斷地點與Apple Business Connect的連線

移除一個地點與擁有者 Apple Business 帳戶的連線。該地點會保留在 Apple Maps 上，並透過 ListingsAPI 帳戶發布。

需要 API 金鑰。標頭格式與金鑰輪替請參閱驗證。

參數

請求主體

名稱類型必填說明
inputobject必填Wrapper object. The entire request body must be nested under `input`.
input.locationIdstring必填Base64-encoded Relay ID of the one location to disconnect.
input.sitestring必填Set to `APPLE`.

請求範例

可直接貼上的請求主體。請將預留位置 ID 與值換成您自己的。

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

回應

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

當客戶離開並帶走其 Apple Business 帳戶時，請使用此端點。該地點會保留在您的帳戶中，也會保留在 Apple Maps 上：後續更新會透過 ListingsAPI 的 Apple Business Connect 帳戶發布，且 Apple 會在發布前驗證提交內容。該地點與其他發布平台的連線不受影響。

若地點沒有有效的 Apple 連線，則會傳回 SY10057，因此 success: true 表示已移除一個連線。每次呼叫只處理一個地點；若要中斷多個地點的連線，請逐一呼叫。

若要再次透過擁有者的帳戶發布，請透過將地點連結至 Apple Business Connect 向對方傳送新的連結。

本頁說明中斷一個地點與發布平台的連線 中的 site: "APPLE" 情況。

此端點會變更實際運作中的連線。上方的範例請求與回應僅供示範。

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