الحد الأقصى لعدد سلاسل المحادثات المطلوب عرضها. القيمة التلقائية لهذا الحقل هي 100. إنّ الحدّ الأقصى المسموح به لقيمة هذا الحقل هو 500.
pageToken
string
رمز الصفحة المميّز لاسترداد صفحة معيّنة من النتائج في القائمة.
q
string
عرض سلاسل المحادثات التي تطابق طلب البحث المحدّد فقط استخدام نفس تنسيق طلب البحث الذي يستخدمه مربّع بحث Gmail. مثلاً: "from:someuser@example.com rfc822msgid:<somemsgid@example.com>
is:unread" لا يمكن استخدام المعلمة عند الوصول إلى واجهة برمجة التطبيقات باستخدام نطاق gmail.metadata.
labelIds[]
string
لا تعرض سوى سلاسل المحادثات التي تتضمن تصنيفات تتطابق مع جميع معرّفات التصنيفات المحدّدة.
includeSpamTrash
boolean
تضمين سلاسل محادثات من SPAM وTRASH في النتائج.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
قائمة سلاسل المحادثات يُرجى العلم أنّ كل مورد لسلسلة المحادثات لا يحتوي على قائمة بـ messages. ويمكن استرجاع قائمة messages لسلسلة محادثات معيّنة باستخدام طريقة threads.get.
nextPageToken
string
رمز الصفحة المميّز لاسترداد الصفحة التالية من النتائج في القائمة.