Method: spaces.messages.reactions.list

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

تتطلّب مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:

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

طلب 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

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