/api/v4/locations/oauth-disconnectBir konumun Apple Business Connect bağlantısını kesin
Bir konumun, sahibinin Apple Business hesabıyla olan bağlantısını kaldırır. Konum Apple Maps'te kalır ve ListingsAPI hesabı üzerinden yayımlanır.
Parametreler
Gövde
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| input | object | zorunlu | Wrapper object. The entire request body must be nested under `input`. |
| input.locationId | string | zorunlu | Base64-encoded Relay ID of the one location to disconnect. |
| input.site | string | zorunlu | Set to `APPLE`. |
Örnek istek
Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "site": "APPLE" }}Yanıtlar
200Connection removed. Response key `disconnectConnectedAccountsLocations`.
{ "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`).
Bir müşteri ayrılıp Apple Business hesabını da beraberinde götürdüğünde bunu kullanın. Konum hesabınızda ve Apple Maps'te kalır: sonraki güncellemeler ListingsAPI Apple Business Connect hesabı üzerinden yayımlanır ve Apple, gönderimi yayımlamadan önce doğrular. Konumun diğer yayın platformlarıyla olan bağlantıları etkilenmez.
Etkin bir Apple bağlantısı olmayan bir konum SY10057 döndürür; dolayısıyla success: true, bir bağlantının kaldırıldığı anlamına gelir. Çağrı tek bir konumu işler; birden fazla konumun bağlantısını kesmek için döngü kullanın.
Yeniden konum sahibinin hesabı üzerinden yayımlamak için kendisine Bir konumu Apple Business Connect'e bağlayın sayfasından yeni bir bağlantı gönderin.
Bu sayfa, Bir konumun bir yayın platformuyla bağlantısını kesin işleminin site: "APPLE" durumunu belgeler.
Bu endpoint, kullanımda olan bir bağlantıyı değiştirir. Yukarıdaki örnek istek ve yanıt, örnek olarak verilmiştir.
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" } }'