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

لمزيد من المعلومات، راجِع دليل التفويض.