Method: users.settings.delegates.list
يعرض المفوَّضين للحساب المحدّد.
لا تتوفر هذه الطريقة إلا لعملاء حسابات الخدمة الذين تم تفويضهم بسلطة على مستوى النطاق.
طلب HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم القيمة الخاصة "أنا" للإشارة إلى المستخدم الذي تمت مصادقته.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد على طريقة deleges.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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists delegates for a specified account, accessible only to service accounts with domain-wide authority."],["Employs a `GET` request to the endpoint `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`, using gRPC Transcoding syntax."],["Requires an empty request body and returns a JSON response containing a list of delegates, if any."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/gmail.settings.basic` or `https://www.googleapis.com/auth/gmail.modify`."]]],["A `GET` request is made to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates` to list an account's delegates. The `userId` path parameter, which can be \"me,\" specifies the user. The request body must be empty. The response body, if successful, includes a JSON structure with a list of delegate objects under the \"delegates\" field. This action requires service account clients with domain-wide authority and specific OAuth scopes.\n"]]