قطع اتصال

يزيل حساب تواصل اجتماعي متصلًا واحدًا من علامته التجارية. لا تُحدَّد العلامة التجارية مباشرةً: إذ يحدِّد معرّف الاتصال كليهما. هذه عملية نهائية، ولا توجد مهلة لإلغائها أو إمكانية للتراجع عنها. لاستعادة القناة، أصدر رابط اتصال جديدًا واطلب من المستخدم إعادة منح التفويض.

حالة استخدام: عميل يلغي صلاحية الوصول إلى قناة واحدة. عندما يزيل عميل صفحة من نطاق تحكمك، اقطع اتصال تلك القناة حتى تتوقف المنشورات المجدولة عن محاولة النشر عليها. اقرأ id من اتصالات العلامة التجارية، واقطع الاتصال، ثم اقرأ القائمة مجددًا للتأكد.

ملاحظات.

• يجب تغليف جسم الطلب داخل كائن input. الحقل هو socialProfileConnectedChannelId — أي UUID الخاص بالاتصال نفسه، وليس connectedAccountId الخاص بالمنصة ولا معرّف العلامة التجارية.
• تحقق من success، وليس من حالة HTTP. إذا كان الاتصال تابعًا لعلامة تجارية أخرى، أو كان قد أُزيل بالفعل، فسيُرجع الطلب HTTP 200 مع success: false. لا تتضمن حمولة الاستجابة أي معرّف، لذا احتفظ بسجل خاص بك يحدد الاتصال الذي طلبت إزالته.
• انتبه إلى تشابه الاسمين. حقل جسم الطلب هنا هو socialProfileConnectedChannelId، وتتوسطه Profile. تقبل نقطة نهاية الإحصاءات المجاورة socialConnectedChannelId — وهو المعرّف نفسه، لكن اسم الحقل أقصر بكلمة واحدة. يختلف الاسمان بكلمة واحدة، ولا يقبل أيٌّ من الحقلين اسم الآخر.
• لا تُلغى المنشورات المجدولة. سيفشل المنشور المجدول للنشر على هذه القناة عند وقت النشر مع SY95045 بدلًا من إسقاطه. ألغِه أولًا باستخدام POST /social/posts/cancel إذا كنت لا تريد حدوث هذا الفشل.
• تظل المنشورات المنشورة بالفعل متاحة. يزيل قطع الاتصال قدرة listingsAPI على النشر وقراءة الإحصاءات؛ ولا يحذف أي شيء من المنصة.
• تعود الخانة إلى مجموعة الخانات عند التجديد، وليس عند نجاح العملية. يُظهر GET /social/limits ذلك فورًا بانخفاض usage.connectionsActive وارتفاع usage.connectionsReleased، مع بقاء usage.connections — وهو العدد الخاضع للفوترة الذي يُطبَّق عليه الحد الأقصى — دون تغيير حتى بدء فترة الفوترة التالية. يمثّل usage.connectionsReleased مقدار السعة التي تُستعاد عند التجديد. راجع الخطط والإضافات.
• إعادة ربط الحساب نفسه بالعلامة التجارية نفسها مجانية. تؤدي إعادة ربط حساب تواصل اجتماعي سبق أن قطعت اتصاله بتلك العلامة التجارية خلال الفترة نفسها إلى إعادة استخدام خانته الحالية: فينتقل مجددًا من connectionsReleased إلى connectionsActive، ولا يتغير connections الخاضع للفوترة. تُحجز خانة لكل زوج من علامة تجارية وحساب، لذا يتطلب حساب تواصل اجتماعي مختلف خانة جديدة، وكذلك الحساب نفسه عند ربطه بعلامة تجارية مختلفة.
• تؤدي أرشفة علامة تجارية إلى قطع جميع اتصالاتها، لذا لا تحتاج إلى إجراء هذا الاستدعاء أولًا عند الأرشفة. وتظل الخانات محجوزة حتى نهاية الفترة في هذه الحالة أيضًا — فلا تختلف النتيجة باختلاف طريقة قطع الاتصال.

عملية كتابة: لم تُنفَّذ على الحساب الفعلي. أُنشئ الطلب والاستجابة المعروضان استنادًا إلى مخطط API.