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/

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