Method: roleAssignments.list

Truy xuất danh sách được phân trang của tất cả roleAssignment.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customer

string

Mã nhận dạng duy nhất của tài khoản Google Workspace của khách hàng. Trong trường hợp bạn sử dụng tài khoản nhiều miền, để tìm nạp tất cả các nhóm cho khách hàng, hãy sử dụng trường này thay cho domain. Bạn cũng có thể sử dụng bí danh my_customer để đại diện cho customerId của tài khoản của mình. customerId cũng được trả về trong tài nguyên Người dùng. Bạn phải cung cấp tham số customer hoặc domain.

Tham số truy vấn

Tham số
maxResults

integer

Số kết quả tối đa cần trả về.
pageToken

string

Mã thông báo để chỉ định trang tiếp theo trong danh sách.
roleId

string

Mã nhận dạng bất biến của một vai trò. Nếu có trong yêu cầu, chỉ trả về các lượt chỉ định vai trò chứa mã vai trò này.
userKey

string

Địa chỉ email chính, địa chỉ email đại diện, mã nhận dạng nhóm hoặc người dùng riêng biệt. Nếu có trong yêu cầu, chỉ trả về các lượt chỉ định vai trò cho người dùng hoặc nhóm này.
includeIndirectRoleAssignments

boolean

Khi bạn đặt thành true, hệ thống sẽ tìm nạp thông tin chỉ định vai trò gián tiếp (tức là chỉ định vai trò qua một nhóm), cũng như thông tin chỉ định trực tiếp. Giá trị mặc định là false. Bạn phải chỉ định userKey, nếu không dữ liệu chỉ định vai trò gián tiếp sẽ không được đưa vào.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
Trường
kind

string

Loại tài nguyên API. Thao tác này luôn là admin#directory#roleAssignments.
etag

string

ETag của tài nguyên.
items[]

object (RoleAssignment)

Danh sách tài nguyên của Vai trò trong Vai trò.
nextPageToken

string

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.