Method: users.messages.get

الحصول على الرسالة المحدَّدة

طلب HTTP

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

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

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

المعلّمات
userId

string

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

string

رقم تعريف الرسالة المطلوب استردادها يتم عادةً استرداد رقم التعريف هذا باستخدام messages.list. يتم أيضًا تضمين رقم التعريف في النتيجة عند إدراج رسالة (messages.insert) أو استيرادها (messages.import).

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

المعلّمات
format

enum (Format)

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

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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