/api/v4/locations/oauth-disconnectقطع اتصال موقع بـ Apple Business Connect
يزيل اتصال موقع واحد بحساب المالك في Apple Business. يبقى الموقع على Apple Maps ويُنشر من خلال حساب ListingsAPI.
المعلمات
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| input | object | مطلوب | Wrapper object. The entire request body must be nested under `input`. |
| input.locationId | string | مطلوب | Base64-encoded Relay ID of the one location to disconnect. |
| input.site | string | مطلوب | Set to `APPLE`. |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "site": "APPLE" }}الاستجابات
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`).
استخدم هذه العملية عندما يغادر عميل ويأخذ معه حسابه في Apple Business. يبقى الموقع في حسابك وعلى Apple Maps: تُنشر التحديثات اللاحقة من خلال حساب ListingsAPI في Apple Business Connect، وتتحقق Apple من طلب النشر قبل نشره. لا تتأثر اتصالات الموقع بمنصات النشر الأخرى.
عندما لا يكون للموقع اتصال نشط بـ Apple، تُرجع العملية SY10057، لذا تعني success: true أن اتصالًا أُزيل فعلًا. يعالج الاستدعاء موقعًا واحدًا؛ استخدم حلقة تكرار لقطع اتصال عدة مواقع.
للنشر من خلال حساب المالك مرة أخرى، أرسل إليه رابطًا جديدًا من ربط موقع بـ Apple Business Connect.
توثّق هذه الصفحة حالة site: "APPLE" من قطع اتصال موقع واحد بمنصة نشر.
تغيّر نقطة النهاية هذه اتصالًا فعليًا. الطلب والاستجابة النموذجيان أعلاه مثالان توضيحيان.
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" } }'