/api/v4/connected-accounts/disconnect-googleقطع اتصال حساب Google
يقطع اتصال حساب Google Business Profile متصل بالكامل بحسابك في Listings API.
المعلمات
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| input | object | مطلوب | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | مطلوب | UUID of the connected Google account to disconnect. The whole account is disconnected. |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}الاستجابات
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "gmbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
يفصل الارتباط بين حساب Google Business Profile متصل وحسابك في Listings API. بعد قطع الاتصال، تتوقف إدراجات الأنشطة التجارية التي كانت تُزامَن عبر ذلك الحساب عن تلقي التحديثات من Listings API.
بنية الطلب. يجب تغليف جسم الطلب بكائن input لا يحتوي إلا على الحقل connectedAccountId. تُنفَّذ هذه العملية بالكامل أو لا تُنفَّذ إطلاقًا؛ إذ يُقطع اتصال حساب Google بأكمله وجميع المواقع المرتبطة من خلاله. لا يوجد حقل locationIds؛ فالمخطط يرفضه. لفصل إدراج النشاط التجاري الخاص بموقع واحد مع إبقاء الحساب متصلًا، استخدم نقطة النهاية disconnect-listing.
حالة استخدام: إنهاء الربط بالكامل عند مغادرة العميل. أرسل connectedAccountId لإنهاء الاتصال بأكمله باستدعاء واحد. هذه هي الطريقة السليمة لإلغاء وصول Listings API بعد توقف العميل عن استخدام الخدمة أو نقله ملكية حسابه في Google.
حالة استخدام: إنهاء اتصال معطّل. إذا ظهرت في اتصال Google أخطاء في بيانات الاعتماد لا تحلّها إعادة المصادقة، فاقطع اتصاله هنا وأصدر رابطًا جديدًا باستخدام نقطة النهاية connect-google. بالنسبة إلى حسابات Facebook، استخدم نقطة النهاية disconnect-facebook، التي تتلقى بنية الطلب نفسها. لاحظ أن استجابة success: true تُعاد حتى عندما تكون قيمة connectedAccountId غير معروفة، لذا اعتبر النجاح بمعنى "تمت معالجة الطلب"، وليس دليلًا على إزالة اتصال قائم، وتحقق من حالة الحساب باستخدام GET /connected-accounts إذا كنت بحاجة إلى التأكد.
تُعدِّل نقطة النهاية هذه اتصالًا قائمًا وتُلغي وصول Listings API إلى Google. وُثّقت بنية الطلب ونموذج الاستجابة أعلاه استنادًا إلى مواصفات API؛ ولا يُنفَّذ الاستدعاء على بيانات بيئة الإنتاج.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-google' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'