Method: roleAssignments.list

یک لیست صفحه بندی شده از تمام roleAssignments را بازیابی می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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

نوع منبع API. این همیشه 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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.