يسرد الرسائل في مساحة يكون المتصل عضوًا فيها، بما في ذلك الرسائل من الأعضاء المحظورين والمساحات. مثلاً، راجِع سرد الرسائل. يتطلب مصادقة المستخدم.
طلب 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.