Chrome Management Enrollment Tokens API cho phép quản trị viên quản lý mã đăng ký dùng để đăng ký trình duyệt Chrome trong Chrome Enterprise Core. Bạn có thể dùng bộ API này để tạo, truy xuất, liệt kê và thu hồi mã thông báo đăng ký cho các thiết bị của mình.
Tổng quan nhanh về các phương thức API
URL liên quan đến https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Mô tả | URL tương đối | Phương thức HTTP |
|---|---|---|
| Tạo mã thông báo đăng ký | /enrollmentTokens | POST |
| Truy xuất mã thông báo đăng ký | /enrollmentTokens/{token_permanent_id} | NHẬN |
| Liệt kê mã thông báo đăng ký | /enrollmentTokens | NHẬN |
| Thu hồi mã thông báo đăng ký | /enrollmentTokens/{token_permanent_id}:revoke | POST |
Hãy xem mã mẫu để biết các yêu cầu và phản hồi mẫu.
Đang lọc kết quả
Khi liệt kê mã thông báo đăng ký bằng phương thức /enrollmentTokens, bạn có thể thu hẹp kết quả bằng cách sử dụng tham số truy vấn filter. Tất cả các tham số bộ lọc phải được thoát URL khi được gửi trong các yêu cầu HTTP. Bạn có thể kết hợp nhiều điều kiện bằng toán tử AND.
- Trường String và Enum: Hỗ trợ toán tử so sánh
=và:. - Lọc theo đơn vị tổ chức: Bạn có thể lọc các mã thông báo được tạo cho một Đơn vị tổ chức cụ thể bằng cách chỉ định
org_unit_pathhoặcorg_unit_id.
Các trường có thể lọc
| Trường | Mô tả |
|---|---|
device_type
|
Loại thiết bị mà mã thông báo đăng ký được dùng (hiện là CHROME_BROWSER). |
token_state
|
Trạng thái của mã thông báo đăng ký (ACTIVE, EXPIRED, REVOKED). |
org_unit_path
|
Đường dẫn Đơn vị tổ chức cho mã thông báo đăng ký (ví dụ: /Marketing). |
org_unit_id
|
Mã nhận dạng được làm rối của Đơn vị tổ chức cho mã thông báo đăng ký. |
Đặc quyền của quản trị viên
Chrome Management Enrollment Tokens API tuân thủ việc uỷ quyền vai trò quản trị viên.
| Phương thức | Cần có đặc quyền của quản trị viên |
|---|---|
| CreateEnrollmentToken | "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý" |
| GetEnrollmentToken | "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý" hoặc "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý -> Đọc" |
| ListEnrollmentTokens | "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý" hoặc "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý -> Đọc" |
| RevokeEnrollmentToken | "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý" |
Để quản lý vai trò và đặc quyền của quản trị viên, hãy truy cập vào "Bảng điều khiển dành cho quản trị viên -> Vai trò quản trị".
Phạm vi API
Chrome Management Enrollment Tokens API yêu cầu các phạm vi OAuth sau:
| Phương thức | Phạm vi OAuth bắt buộc |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens hoặc https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens hoặc https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
Để biết thêm thông tin, hãy xem phần Tổng quan về quy trình xác thực.