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