Method: users.settings.delegates.list

يتم تفويض المفوَّضين للحساب المحدَّد.

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
userId

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة "me" للإشارة إلى المستخدم الذي تمت المصادقة عليه.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

استجابة لطريقة تفويضات .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

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