Method: users.threads.get

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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 لا يعرض سوى أرقام تعريف الرسائل الإلكترونية وتصنيفاتها، ولا يعرض عناوين الرسائل الإلكترونية أو نصها أو الحمولة.