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

عند تقديمه والتنسيق هو "البيانات الوصفية"، يجب تضمين العناوين المحدَّدة فقط.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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 عرض معرّفات الرسائل الإلكترونية وتصنيفاتها فقط، ولا يتم عرض رؤوس الرسالة الإلكترونية أو نصها أو حمولةها