Method: users.threads.get

للحصول على سلسلة المحادثات المحدَّدة.

طلب HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
userId

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت المصادقة عليه.
id

string

رقم تعريف سلسلة المحادثات المطلوب استردادها

معامِلات طلب البحث

المعلّمات
format

enum (Format)

التنسيق المراد عرض الرسائل فيه.
metadataHeaders[]

string

عند تقديمه وتنسيقه MetaDATA، ضمِّن العناوين المحدّدة فقط.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Thread.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات 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

لمزيد من المعلومات، اطّلِع على دليل التفويض.

الشكل

عمليات التعداد
full عرض بيانات الرسالة الإلكترونية الكاملة مع تحليل المحتوى الأساسي في الحقل payload، وعدم استخدام الحقل raw لا يمكن استخدام التنسيق عند الوصول إلى واجهة برمجة التطبيقات باستخدام نطاق gmail.metadata.
metadata لا يعرض سوى معرّفات الرسائل الإلكترونية والتصنيفات ورؤوس الرسائل الإلكترونية.
minimal لا يعرض سوى معرّفات الرسائل الإلكترونية والتصنيفات، ولا يعرض عناوين البريد الإلكتروني أو النص أو الحمولة.