Method: spaces.messages.reactions.list

تعرض التفاعلات مع رسالة. للحصول على مثال، يمكنك الاطّلاع على مقالة سرد التفاعلات مع رسالة. يتطلب مصادقة المستخدم.

طلب HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*/messages/*}/reactions

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

مطلوبة. الرسالة التي تفاعل معها المستخدِمون.

تنسيق الملف: spaces/{space}/messages/{message}

معلمات طلب البحث

المَعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد التفاعلات التي تم عرضها. ويمكن أن تعرض الخدمة تفاعلات أقل من هذه القيمة. وفي حال عدم تحديد قيمة، ستكون القيمة التلقائية 25. الحد الأقصى للقيمة هو 200، ويتم تغيير القيم التي تزيد عن 200 إلى 200.
pageToken

string

اختياريّ. (في حال الاستئناف من استعلام سابق).

رمز مميّز للصفحة تم تلقّيه من طلب تفاعلات سابقة مع القائمة يُرجى توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق قيمة الفلتر مع الطلب الذي تم توفير الرمز المميّز للصفحة. قد يؤدي تمرير قيمة مختلفة إلى نتائج غير متوقعة.
filter

string

اختياريّ. فلتر طلبات البحث

يمكنك فلترة التفاعلات حسب الرموز التعبيرية (إما emoji.unicode أو emoji.custom_emoji.uid) والمستخدم (user.name).

لفلترة التفاعلات لرموز تعبيرية متعددة أو مستخدمين متعددين، اربط الحقول المشابهة باستخدام عامل التشغيل OR، مثل emoji.unicode = "🙂" OR emoji.unicode = "👍" وuser.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

لفلترة التفاعلات حسب الرموز التعبيرية والمستخدم، استخدِم عامل التشغيل AND، مثل emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

إذا كان طلب البحث يستخدم كلاً من AND وOR، يمكنك تجميعها بين قوسين.

على سبيل المثال، تعد طلبات البحث التالية صالحة:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

طلبات البحث التالية غير صالحة:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

رفض الخادم طلبات البحث غير الصالحة مع ظهور خطأ INVALID_ARGUMENT.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الرد على طلب للتفاعل مع القائمة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "reactions": [
    {
      object (Reaction)
    }
  ],
  "nextPageToken": string
}
الحقول
reactions[]

object (Reaction)

قائمة بالتفاعلات في الصفحة المطلوبة (أو الأولى)
nextPageToken

string

الرمز المميز للمتابعة لاسترداد الصفحة التالية من النتائج. هذا الحقل فارغ في الصفحة الأخيرة من النتائج.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.