Method: users.messages.batchDelete

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
userId

string

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

نص الطلب

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

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

string

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

نص الاستجابة

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

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

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

  • https://mail.google.com/

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