Method: users.messages.batchDelete

پیام‌های زیادی را بر اساس شناسه پیام حذف می‌کند. هیچ تضمینی نمی‌دهد که پیام‌ها قبلاً حذف نشده باشند یا حتی اصلاً وجود نداشته باشند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
userId

string

آدرس ایمیل کاربر. مقدار ویژه me می‌تواند برای نشان دادن کاربر احراز هویت شده استفاده شود.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "ids": [
    string
  ]
}
فیلدها
ids[]

string

شناسه پیام‌هایی که باید حذف شوند.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ خالی است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://mail.google.com/

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .