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/

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.