مرجع سمات التفاعل

تُرجع نقاط النهاية عرض قائمة التفاعلات لموقع وجلب التفاعلات المجمّعة وجلب التفاعلات حسب المعرّفات كائنات التفاعل. وتُغلّف نقطتا النهاية اللتان تدعمان تقسيم النتائج إلى صفحات هذه الكائنات ضمن بنية اتصال بأسلوب Relay: يحتوي كل من data.interactions (لكل موقع) وdata.rollupInteractions (للتجميع على مستوى الحساب) على edges[].node وpageInfo وtotalCount. ولا يدعم الجلب حسب المعرّفات تقسيم النتائج إلى صفحات؛ إذ إن data.interactionDetails كائن { "interactions": [ ... ] } بسيط لا يحتوي على edges أو pageInfo أو totalCount.

حقول التفاعل

الحقل	النوع	الوصف
id	String	معرّف UUID الخاص بالتفاعل. مرّره بوصفه `interactionId` عند الرد
interactionId	String	معرّف UUID نفسه الموجود في `id`
source	String	اسم المضيف لموقع التقييمات أو التواصل الاجتماعي (مثل `maps.google.com`، `yelp.com`)
title	String	عنوان التفاعل، عندما يوفّره المصدر
content	String	نص التقييم أو المنشور
authorName	String	اسم العرض للكاتب
rating	Integer	التقييم بالنجوم، من 1 إلى 5 (للتقييمات فقط)
date	String	الطابع الزمني للتفاعل بتنسيق ISO 8601
permalink	String	رابط مباشر إلى التفاعل على موقع المصدر
category	String	فئة عامة، مثل `Review` أو `Social`
type	String	نوع التفاعل المحدّد، `Review`، `Question`، `Comment`، `Recommendation`، `Post`، `Photo`، `Message`، `Response`
responded	Boolean	ما إذا كان هناك رد من المالك
notes	String	ملاحظات مالك الحساب الخاصة
responses	Array	ردود المالك المرفقة بهذا التفاعل (انظر أدناه)
responseCount	Integer	عدد الردود المرفقة
canRespond	Boolean	ما إذا كان يمكن نشر رد عبر Listings API لهذا المصدر
locationId	Integer	المعرّف الرقمي في قاعدة البيانات للموقع الذي يتبعه التفاعل
flaggedReason	String	سبب وضع علامة على التفاعل، إن وُجد

حقول كائن الرد

كل عنصر في مصفوفة responses الخاصة بالتفاعل (وكذلك الكائن الذي تُرجعه نقطة النهاية الرد على تفاعل):

الحقل	النوع	الوصف
id	String	المعرّف الفريد للرد (مرّره بوصفه `responseId` عند التعديل أو الأرشفة)
interactionId	String	معرّف التفاعل الذي ينتمي إليه هذا الرد
content	String	نص الرد
authorName	String	الاسم المعروض بوصفه صاحب الرد
date	String	الطابع الزمني لإنشاء الرد
respondedWith	String	معرّف قالب الرد المستخدم، إن وُجد
respondedBy	Integer	معرّف مستخدم Listings API الذي أرسل الرد
interactionStatus	String	حالة دورة الحياة، `CREATED` أو `FAILED` أو `COMPLETED` أو `CONFIRMED`
editedResponse	Boolean	ما إذا كان هذا الرد قد عُدّل منذ نشره لأول مرة
remarks	String	ملاحظات النظام (مثل تفاصيل الفشل)

تسلسل حالات الرد

يتتبّع الحقل interactionStatus الرد أثناء نشره على موقع المصدر:

CREATED → COMPLETED: نُشر على منصة النشر؛ لا يتوفر تأكيد مزدوج على تلك المنصة
CREATED → COMPLETED → CONFIRMED: نُشر ثم أكّدت منصة النشر نشره
CREATED → FAILED: لم ينجح الإرسال إلى منصة النشر؛ انظر remarks

قيم التعداد للتصفية

تقبل نقاط النهاية التي تدعم تقسيم النتائج إلى صفحات قيم التعداد التالية بوصفها عوامل تصفية:

responseStatus: RESPONDED, PENDING
sortOrder: NEWEST_FIRST, OLDEST_FIRST, LAST_RESPONDED
category: REVIEW (وفئات عامة أخرى متاحة لكل حساب)