Method: users.messages.batchDelete

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
userId

string

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

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

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

string

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

بدن پاسخگو

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

محدوده مجوز

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

  • https://mail.google.com/

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.