Method: users.settings.delegates.list

تعرض هذه الطريقة قائمة بالمستخدمين المفوَّضين للحساب المحدّد.

لا تتوفّر هذه الطريقة إلا لعملاء حسابات الخدمة الذين تم تفويضهم على مستوى النطاق.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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.