Method: users.drafts.get
الحصول على المسودة المحدّدة
طلب HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.
|
id |
string
رقم تعريف المسودة المراد استردادها.
|
معلمات طلب البحث
| المَعلمات |
format |
enum (Format)
الصيغة المراد إرجاع المسودة بها.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Draft.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
https://www.googleapis.com/auth/gmail.readonly
لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieves a specific email draft using the draft ID and user ID."],["Allows specifying the format of the returned draft using query parameters."],["Requires authorization with specific Gmail scopes like `mail.google.com` or `gmail.readonly`."],["Returns the draft details as a `Draft` object in the response body if successful."],["Uses gRPC Transcoding syntax for its URL structure."]]],["This API endpoint retrieves a specific draft from a user's Gmail account. It uses a `GET` request to the URL `https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}`. Required path parameters include `userId` (user's email or \"me\") and `id` (draft ID). An optional query parameter, `format`, determines the draft's return format. The request body must be empty. The successful response returns a draft instance. Access requires specific OAuth scopes, such as `mail.google.com`.\n"]]
