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/

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.