يسرد الرسائل في مساحة يكون المتصل عضوًا فيها، بما في ذلك الرسائل من الأعضاء المحظورين والمساحات. إذا أدرجت رسائل من مساحة لا تحتوي على رسائل، سيكون الردّ عنصرًا فارغًا. عند استخدام واجهة REST/HTTP، يحتوي الردّ على عنصر JSON فارغ، {}
. على سبيل المثال، راجِع قائمة الرسائل.
يتطلب مصادقة المستخدم.
طلب HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. اسم المورد للمساحة التي تريد إدراج الرسائل منها تنسيق الملف: |
مَعلمات طلب البحث
المعلمات | |
---|---|
page |
اختياريّ. الحد الأقصى لعدد الرسائل المعروضة قد تعرض الخدمة رسائل أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 25 عنصرًا بحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ |
page |
اختياريّ. اختياري، في حال استئناف طلب بحث سابق رمز صفحة تم تلقّيه من طلب سابق لرسائل القائمة قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند التقسيم على صفحات، يجب أن تتطابق جميع المعلمات الأخرى المقدّمة مع الاستدعاء الذي قدّم الرمز المميز للصفحة. قد يؤدي تمرير قيم مختلفة إلى المعلَمات الأخرى إلى نتائج غير متوقعة. |
filter |
اختياريّ. فلتر طلب بحث يمكنك فلترة الرسائل حسب التاريخ ( لفلترة الرسائل حسب تاريخ إنشائها، حدِّد للفلترة حسب سلسلة المحادثات، حدِّد للفلترة حسب سلسلة المحادثات والتاريخ، استخدِم عامل التشغيل على سبيل المثال، طلبات البحث التالية صالحة:
يرفض الخادم طلبات البحث غير الصالحة مع ظهور الخطأ |
order |
اختياريّ. اختياري، في حال الاستئناف من استعلام سابق. طريقة ترتيب قائمة الرسائل حدِّد قيمة لترتيبها حسب عملية ترتيب. في ما يلي القيم الصالحة لعملية الترتيب:
الترتيب التلقائي هو |
show |
اختياريّ. تحديد ما إذا كان سيتم تضمين الرسائل المحذوفة تتضمّن الرسائل المحذوفة وقت الحذف والبيانات الوصفية حول عملية الحذف، ولكن لا يتوفّر محتوى الرسالة. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الردّ على رسائل إدراج المنتجات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"messages": [
{
object ( |
الحقول | |
---|---|
messages[] |
قائمة الرسائل |
next |
يمكنك إرسال رمز مميّز على النحو التالي: |
نطاقات الأذونات
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.