Method: users.messages.get

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

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

طلب 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

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