Truy xuất danh sách các thiết bị Chrome OS được phân trang trong một tài khoản.
Yêu cầu HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
customerId |
Mã nhận dạng duy nhất cho tài khoản Google Workspace của khách hàng. Là quản trị viên tài khoản, bạn cũng có thể sử dụng bí danh |
Tham số truy vấn
Các tham số | |
---|---|
maxResults |
Số lượng kết quả tối đa cần trả về. |
orderBy |
Thuộc tính thiết bị để sắp xếp kết quả. |
orgUnitPath |
Đường dẫn đầy đủ của đơn vị tổ chức (trừ |
pageToken |
Tham số truy vấn |
projection |
Hạn chế thông tin được trả về trong tập hợp các trường đã chọn. |
query |
Chuỗi tìm kiếm theo định dạng được cung cấp tại https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
Liệu trả về kết quả theo thứ tự tăng dần hay giảm dần. Phải được sử dụng cùng với tham số |
includeChildOrgunits |
Trả về thiết bị của tất cả các đơn vị tổ chức con cũng như đơn vị tổ chức đã chỉ định. Nếu đặt giá trị này thành true, thì bạn phải cung cấp 'orgUnitPath'. |
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,
"chromeosdevices": [
{
object ( |
Các trường | |
---|---|
kind |
Đây là một loại tài nguyên. |
etag |
ETag của tài nguyên. |
chromeosdevices[] |
Danh sách đối tượng của Thiết bị ChromeOS. |
nextPageToken |
Mã thông báo được dùng để truy cập vào trang tiếp theo của kết quả này. Để truy cập vào trang tiếp theo, hãy dùng giá trị của mã thông báo này trong chuỗi truy vấn |
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.device.chromeos
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
OrderBy
Enum | |
---|---|
ANNOTATED_LOCATION |
Vị trí thiết bị Chrome như được quản trị viên chú thích. |
ANNOTATED_USER |
Người dùng Chromebook do quản trị viên chú thích. |
LAST_SYNC |
Ngày và giờ thiết bị Chrome được đồng bộ hóa lần gần đây nhất với cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. |
NOTES |
Thiết bị Chrome ghi chú như được quản trị viên chú thích. |
SERIAL_NUMBER |
Số sê-ri của thiết bị Chrome được nhập khi thiết bị được bật. |
STATUS |
Trạng thái thiết bị Chrome. Để biết thêm thông tin, hãy xem trang <a chromeosdevices. |
Dự đoán
Loại phép chiếu cần hiển thị cho các thiết bị.
Enum | |
---|---|
BASIC |
Chỉ bao gồm các trường siêu dữ liệu cơ bản (ví dụ: deviceId, sê-ri, trạng thái và người dùng) |
FULL |
Bao gồm tất cả các trường siêu dữ liệu |
SortOrder
Thứ tự sắp xếp sẽ được áp dụng cho danh sách thiết bị.
Enum | |
---|---|
ASCENDING |
Thứ tự tăng dần. |
DESCENDING |
Thứ tự giảm dần. |