Method: users.settings.delegates.get

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

يُرجى العِلم أنّه يجب الإشارة إلى المستخدم المفوض باستخدام عنوان بريده الإلكتروني الأساسي، وليس عنوان بريد إلكتروني بديلاً.

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

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
userId

string

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

delegateEmail

string

عنوان البريد الإلكتروني للمستخدم الذي سيتم استرداد علاقة التفويض الخاصة به.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال 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.