عرض اتصالات علامة تجارية

يسرد حسابات التواصل الاجتماعي المرتبطة بعلامة تجارية واحدة. يمثّل id في كل صف معرّف الاتصال: وهو القيمة التي تمرّرها في connectedChannelIds عندما تريد توجيه منشور إلى قنوات محددة، والقيمة التي تقبلها عملية قطع الاتصال، وكذلك socialConnectedChannelId الذي تتطلبه الإحصاءات.

حالة استخدام: عرض أداة اختيار القنوات. قبل عرض محرّر المنشورات، اقرأ هذه القائمة وقدّم مفتاح تبديل لكل صف، مع تسميته باستخدام displayName وplatform. لا توجد وجهة للنشر لعلامة تجارية تكون مصفوفة socialConnected لديها فارغة؛ لذا وجّه المستخدم إلى رابط اتصال بدلاً من ذلك.

حالة استخدام: التأكد من إنشاء الاتصال. بعد عودة المستخدم من مسار الاتصال المستضاف مع status=success، استعلم دورياً من نقطة النهاية هذه حتى يظهر الصف الذي تطابق فيه قيمة id قيمة connectedAccountId في عنوان URL للعودة. تُنشأ الاتصالات بصورة غير متزامنة، لذا انتظر بضع ثوانٍ وأعِد المحاولة مرتين قبل عرض خطأ.

ملاحظات.

• تكون قيمة platform واحدة من FACEBOOK أو INSTAGRAM أو TWITTER (X) أو LINKEDIN أو PINTEREST.
• يمثّل id معرّف UUID للاتصال، وهو القيمة التي تتطلبها كل نقطة نهاية في Social تقبل اتصالاً. أما referenceId فهو معرّف الحساب الخاص بالمنصة نفسها — مثل معرّف صفحة Facebook أو معرّف حساب أعمال Instagram — وهو مفيد للمطابقة مع السجلات التي تحتفظ بها خارج ListingsAPI، لكنه لا يُقبل أبداً كقيمة إدخال هنا.
• يشير archived: true مع طابع زمني في archivedAt إلى أن الاتصال لم يعد موجوداً، إما لأن شخصاً ما قطع الاتصال، أو لأن العلامة التجارية أُرشفت، أو لأن المنصة ألغت الرمز المميز. يفشل المنشور الذي يستهدف قناة مؤرشفة مع SY95045.
• لا تُعيَّن قيمة listingConnectedAccountId إلا عندما يكون الحساب نفسه مرتبطاً أيضاً في جانب Listings؛ وتكون قيمته null للاتصال الخاص بـ Social فقط.
• يُستخدم اتصال واحد فقط لكل منصة لكل علامة تجارية لأغراض النشر. يؤدي ربط المنصة نفسها مرة أخرى بالعلامة التجارية نفسها إلى استبدال القناة السابقة بدلاً من إضافة قناة ثانية.
• للاطلاع على استخدام الاتصالات على مستوى حسابك بأكمله مقارنةً بالحد الأقصى المسموح لك، بدلاً من قنوات علامة تجارية واحدة، استدعِ GET /social/limits.