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 والتنسيق هو 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
  • https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  • https://www.googleapis.com/auth/gmail.addons.current.message.action

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

التنسيق

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