يسرد سلاسل المحادثات في صندوق بريد المستخدم.
طلب HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
userId |
عنوان البريد الإلكتروني للمستخدِم. يمكن استخدام القيمة الخاصة |
معامِلات طلب البحث
المعلمات | |
---|---|
maxResults |
الحد الأقصى لعدد سلاسل المحادثات المطلوب عرضها. القيمة التلقائية لهذا الحقل هي 100. إنّ الحدّ الأقصى المسموح به لقيمة هذا الحقل هو 500. |
pageToken |
رمز الصفحة المميّز لاسترداد صفحة معيّنة من النتائج في القائمة. |
q |
عرض سلاسل المحادثات التي تطابق طلب البحث المحدّد فقط استخدام نفس تنسيق طلب البحث الذي يستخدمه مربّع بحث Gmail. مثلاً: |
labelIds[] |
لا تعرض سوى سلاسل المحادثات التي تتضمن تصنيفات تتطابق مع جميع معرّفات التصنيفات المحدّدة. |
includeSpamTrash |
تضمين سلاسل محادثات من |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"threads": [
{
object ( |
الحقول | |
---|---|
threads[] |
قائمة سلاسل المحادثات يُرجى العلم أنّ كل مورد لسلسلة المحادثات لا يحتوي على قائمة بـ |
nextPageToken |
رمز الصفحة المميّز لاسترداد الصفحة التالية من النتائج في القائمة. |
resultSizeEstimate |
العدد الإجمالي المقدَّر للنتائج. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.metadata
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.