Method: users.messages.delete

يحذف الرسالة المحدّدة على الفور وبشكل دائم. لا يمكن التراجع عن هذه العملية. يُفضّل استخدام messages.trash بدلاً من ذلك.

طلب HTTP

DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
userId

string

عنوان البريد الإلكتروني للمستخدِم. يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمّت مصادقته.

id

string

رقم تعريف الرسالة المطلوب حذفها.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://mail.google.com/

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.