يسرد المسودات في صندوق بريد المستخدم.
طلب HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
userId |
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة |
معلمات طلب البحث
المَعلمات | |
---|---|
maxResults |
الحد الأقصى لعدد المسودات المطلوب عرضها. القيمة التلقائية لهذا الحقل هي 100. الحد الأقصى المسموح به للقيمة في هذا الحقل هو 500. |
pageToken |
الرمز المميز للصفحة لاسترداد صفحة محدّدة من النتائج في القائمة |
q |
عدم عرض سوى مسودات الرسائل المطابقة لطلب البحث المحدَّد. يتيح استخدام تنسيق طلب البحث نفسه الذي يظهر في مربّع بحث Gmail. مثلاً: |
includeSpamTrash |
تضمين مسودّات من |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"drafts": [
{
object ( |
الحقول | |
---|---|
drafts[] |
قائمة المسودات يُرجى العلم أنّ السمة |
nextPageToken |
رمز مميز لاسترداد الصفحة التالية من النتائج في القائمة |
resultSizeEstimate |
إجمالي العدد المقدّر للنتائج. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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
لمزيد من المعلومات، راجِع دليل التفويض.