Method: users.settings.filters.list

فیلترهای پیام یک کاربر Gmail را فهرست می‌کند. برای اطلاعات بیشتر، به مدیریت فیلترهای Gmail مراجعه کنید.

درخواست HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/filters

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

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

پارامترها
userId

string

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

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخ برای متد filters.list.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "filter": [
    {
      object (Filter)
    }
  ]
}
فیلدها
filter[]

object ( Filter )

فهرست فیلترهای یک کاربر.

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

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

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly

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