Method: users.settings.delegates.list

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

این روش فقط برای سرویس گیرندگان حساب خدماتی در دسترس است که اختیارات گسترده دامنه به آنها واگذار شده است.

درخواست HTTP

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

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

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

پارامترها
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

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