Method: spaces.messages.reactions.list

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المَعلمات
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

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