/api/v4/locations/oauth-disconnectقطع اتصال موقع واحد بمنصة نشر
يقطع اتصال موقع واحد بمنصة نشر، وهو الإجراء المقابل لرابط اتصال OAuth الخاص بكل موقع.
المعلمات
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| 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 | اختياري | Publisher to disconnect from: `GOOGLE`, `FACEBOOK`, or `APPLE`. Required unless you send `providerId`. |
| input.providerId | string | اختياري | The publisher's own account identifier, as an alternative to `site`. Required unless you send `site`. |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "site": "GOOGLE" }}الاستجابات
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`).
يزيل اتصال موقع واحد بمنصة نشر. وهو جزء قطع الاتصال من تدفق OAuth الخاص بكل موقع، والذي يبدأ عبر إنشاء عنوان URL للربط عبر OAuth لموقع واحد.
هذا المسار وفصل إدراج نشاط تجاري عن موقع ينفذان العملية نفسها عبر مسارين: فكلاهما يقبل جسم الطلب input نفسه تمامًا، وكلاهما يعيد النتيجة ضمن disconnectConnectedAccountsLocations، وليس ضمن اسم أيٍّ من المسارين. اختر المسار الذي تبدو تسميته أوضح في تكاملك؛ فلا يوجد اختلاف في السلوك.
يجب تغليف جسم الطلب ضمن input، وأن يتضمن locationId واحدًا، بالإضافة إلى إما site أو providerId لتحديد الاتصال المراد قطعه. إذا لم ترسل أيًّا منهما، فستعيد نقطة النهاية SY10056 ("Site is not valid for the location disconnection"، أي أن منصة النشر غير صالحة لقطع اتصال الموقع)؛ وإذا لم يكن للموقع اتصال نشط بتلك المنصة، فستعيد SY10057 بدلًا من الإبلاغ عن النجاح دون تنبيه، لذا تعني success: true أن اتصالًا أُزيل فعلًا. هذه ليست نقطة نهاية للعمليات المجمّعة، لذا كرّر العملية في حلقة لعدة مواقع. لقطع اتصال جميع مواقع حساب واحد دفعة واحدة، استخدم قطع اتصال حسابات Google بشكل مجمّع بدلًا من ذلك.
حالة استخدام: التراجع عن اتصال استهدف إدراج نشاط تجاري خاطئًا
عندما يربط المستخدم إدراج نشاط تجاري خاطئًا على منصة نشر بمتجر، اقطع اتصاله هنا مع ضبط site على تلك المنصة، ثم وجّه المستخدم مجددًا إلى رابط الاتصال (أو شغّل trigger-matches وربط إدراج نشاط تجاري) لربط الإدراج الصحيح. يُبقي قطع الاتصال الموقع وبياناته كما هي؛ ولا تتوقف إلا المزامنة الصادرة إلى منصة النشر تلك.
حالة استخدام: مغادرة عميل واحتفاظه بحسابه على Apple Business
عند استخدام site: "APPLE"، يتوقف نشر الموقع من خلال حساب المالك على Apple Business. ويظل الموقع على Apple Maps: إذ تُنشر التحديثات اللاحقة من خلال حساب ListingsAPI على Apple Business Connect، وتتحقق Apple من الطلب المقدَّم قبل نشره. للنشر من خلال حساب المالك مرة أخرى، أرسل إليه رابطًا جديدًا من إنشاء عنوان URL للربط عبر OAuth لموقع واحد.
تُغيّر نقطة النهاية هذه اتصالًا فعليًا. الطلب والاستجابة النموذجيان أعلاه مثالان توضيحيان.
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": "GOOGLE" } }'