Method: users.messages.get

يتلقى الرسالة المحددة.

طلب HTTP

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

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

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

المَعلمات
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

لمزيد من المعلومات، راجِع دليل التفويض.