Method: roles.list

Truy xuất danh sách tất cả vai trò đã phân trang trong một miền.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
customer

string

Mã nhận dạng duy nhất cho tài khoản Google Workspace của khách hàng. Đối với 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. customerId cũng được trả về như một phần của 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

Thông số
maxResults

integer

Số lượng 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.

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 (Role)
    }
  ],
  "nextPageToken": string
}
Các trường
kind

string

Loại tài nguyên API. Giá trị này luôn là admin#directory#roles.
etag

string

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

object (Role)

Danh sách tài nguyên về 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.