يؤدي هذا الإجراء إلى حذف العديد من الرسائل حسب رقم تعريف الرسالة. لا يقدم أي ضمانات بأنّ الرسائل لم يتم حذفها من قبل أو أنّها لم تكن موجودة على الإطلاق.
طلب HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
userId |
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "ids": [ string ] } |
الحقول | |
---|---|
ids[] |
أرقام تعريف الرسائل المطلوب حذفها. |
نص الاستجابة
في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://mail.google.com/
لمزيد من المعلومات، راجِع دليل التفويض.