Method: users.settings.delegates.list

نمایندگان را برای حساب مشخص شده لیست می‌کند.

این روش فقط برای کلاینت‌های حساب سرویس که اختیارات در سطح دامنه به آنها تفویض شده است، در دسترس است.

درخواست HTTP

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

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

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

پارامترها
userId

string

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

object ( Delegate )

فهرست نمایندگان کاربر (با هر وضعیت تأیید). اگر حسابی نماینده نداشته باشد، این فیلد نمایش داده نمی‌شود.

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

به یکی از حوزه‌های 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

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