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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.