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
  • 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.