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/

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