يحذف الرسالة المحدّدة على الفور وبشكل دائم. لا يمكن التراجع عن هذه العملية. يُفضّل استخدام messages.trash بدلاً من ذلك.
طلب HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
userId |
عنوان البريد الإلكتروني للمستخدِم. يمكن استخدام القيمة الخاصة |
id |
رقم تعريف الرسالة المطلوب حذفها. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://mail.google.com/
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.