Method: chromeosdevices.list

Truy xuất danh sách 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

Tham số
customerId

string

Mã nhận dạng duy nhất của 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 my_customer để đại diện cho customerId của tài khoản. customerId cũng được trả về trong tài nguyên người dùng.

Tham số truy vấn

Tham số
maxResults

integer

Số kết quả tối đa cần trả về, giá trị không được vượt quá 300.
orderBy

enum (OrderBy)

Thuộc tính thiết bị được dùng để sắp xếp kết quả.
orgUnitPath

string

Đường dẫn đầy đủ của đơn vị tổ chức (trừ / ở đầu) hoặc mã nhận dạng duy nhất của đơn vị tổ chức đó.
pageToken

string

Tham số truy vấn pageToken được dùng để yêu cầu trang tiếp theo của kết quả truy vấn. Tham số truy vấn pageToken của yêu cầu tiếp theo là nextPageToken của phản hồi trước đó của bạn.
projection

enum (Projection)

Xác định xem phản hồi có chứa danh sách đầy đủ các thuộc tính hay chỉ một tập hợp con.
query

string

Chuỗi tìm kiếm ở định dạng được cung cấp tại https://developers.google.com/admin-sdk/directory/v1/list-query-operators
sortOrder

enum (SortOrder)

Liệu có trả về kết quả theo thứ tự tăng dần hay giảm dần hay không. Phải được sử dụng với tham số orderBy.
includeChildOrgunits

boolean

Trả lại thiết bị của mọi đơn vị tổ chức con và đơn vị tổ chức được chỉ định. Nếu đặt giá trị này thành true, thì bạn phải cung cấp giá trị "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 (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Trường
kind

string

Đó là một loại tài nguyên.
etag

string

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

object (ChromeOsDevice)

Danh sách đối tượng của thiết bị Chrome OS.
nextPageToken

string

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 pageToken của yêu cầu này.

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 cuối với các cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên.
NOTES Ghi chú của thiết bị Chrome do quản trị viên chú thích.
SERIAL_NUMBER Số sê-ri thiết bị Chrome được nhập khi bật thiết bị.
STATUS Trạng thái thiết bị Chrome. Để biết thêm thông tin, hãy xem <a chromeosdevices.

Dự kiến

Loại phép chiếu để hiển thị cho 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.