Method: roleAssignments.list

استرداد قائمة مقسّمة على صفحات لجميع الأدوار التي تم تخصيصها

طلب HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roleassignments

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

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

المَعلمات
customer

string

المعرّف الفريد لحساب العميل على Google Workspace في حال كان الحساب متعدّد النطاقات، استخدِم هذا الحقل بدلاً من domain لجلب جميع المجموعات لعميل. يمكنك أيضًا استخدام العنوان البديل للبريد الإلكتروني my_customer لتمثيل customerId في حسابك. يتم أيضًا عرض customerId كجزء من مورد Users. يجب تقديم المعلَمة customer أو domain.

معلمات طلب البحث

المَعلمات
maxResults

integer

الحد الأقصى لعدد النتائج المطلوب عرضها.
pageToken

string

رمز مميز لتحديد الصفحة التالية في القائمة
roleId

string

رقم تعريف غير قابل للتغيير للدور. في حال تضمينها في الطلب، سيتم عرض عمليات تعيين الأدوار التي تحتوي على رقم تعريف الدور هذا فقط.
userKey

string

عنوان البريد الإلكتروني الرئيسي أو عنوان البريد الإلكتروني البديل أو رقم تعريف المستخدم أو المجموعة الفريدَين إذا تم تضمينها في الطلب، سيتم عرض عمليات إسناد الأدوار فقط لهذا المستخدم أو المجموعة.
includeIndirectRoleAssignments

boolean

عند ضبط السياسة على true، يؤدي ذلك إلى استرجاع عمليات إسناد الأدوار غير المباشرة (أي إسناد الأدوار من خلال مجموعة) بالإضافة إلى عمليات إسناد الأدوار المباشرة. يكون الإعداد التلقائي هو false. يجب تحديد userKey وإلا فلن يتم تضمين عمليات تعيين الأدوار غير المباشرة.

نص الطلب

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

نص الاستجابة

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

تمثيل JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات. دائمًا ما تكون admin#directory#roleAssignments.
etag

string

علامة ETag للمورد.
items[]

object (RoleAssignment)

قائمة بموارد "إسناد الأدوار".
nextPageToken

string

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/admin.directory.rolemanagement
  • https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

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