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

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