Method: users.messages.batchDelete

يؤدي هذا الإجراء إلى حذف العديد من الرسائل حسب رقم تعريف الرسالة. لا يقدم أي ضمانات بأنّ الرسائل لم يتم حذفها من قبل أو أنّها لم تكن موجودة على الإطلاق.

طلب HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete

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

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

المَعلمات
userId

string

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "ids": [
    string
  ]
}
الحقول
ids[]

string

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

نص الاستجابة

في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.

نطاقات التفويض

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

  • https://mail.google.com/

لمزيد من المعلومات، راجِع دليل التفويض.