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 كجزء من مورد المستخدِمون. يجب تقديم المَعلمة 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)

قائمة بموارد RoleAssignment
nextPageToken

string

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

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

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

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