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

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