Method: mobiledevices.list

Truy xuất danh sách đã phân trang của tất cả thiết bị di động thuộc sở hữu của người dùng cho một tài khoản. Để truy xuất danh sách bao gồm các thiết bị thuộc sở hữu của công ty, hãy sử dụng API thiết bị của Cloud Identity. Phương thức này sẽ hết thời gian chờ sau 60 phút. Để biết thêm thông tin, hãy xem phần Khắc phục sự cố mã lỗi.

Yêu cầu HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

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ề như một phần của 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ị tối đa được phép là 100.
orderBy

enum (OrderBy)

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

string

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

enum (Projection)

Hạn chế thông tin được trả về cho một nhóm các trường đã chọn.
query

string

Chuỗi tìm kiếm theo định dạng được cung cấp tại https://developers.google.com/admin-sdk/directory/v1/search-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.

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,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Trường
kind

string

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

string

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

object (MobileDevice)

Danh sách đối tượng Thiết bị di động.
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.

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.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

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

Sắp xếp theo

Enum
DEVICE_ID Số sê-ri của thiết bị di động Google Sync. Đối với các thiết bị Android, đây là giá trị nhận dạng duy nhất do phần mềm tạo ra.
EMAIL Địa chỉ email của chủ sở hữu thiết bị.
LAST_SYNC Thời gian đồng bộ hoá ngày đồng bộ hoá chế độ cài đặt chính sách gần đây nhất trên thiết bị.
MODEL Kiểu máy của thiết bị di động.
NAME Tên người dùng của chủ sở hữu thiết bị.
OS Hệ điều hành của thiết bị.
STATUS Trạng thái thiết bị.
TYPE Loại thiết bị.

Dự đoán

Enum
BASIC Chỉ bao gồm các trường siêu dữ liệu cơ bản (ví dụ: deviceId, kiểu máy, trạng thái, loại và trạng thái)
FULL Bao gồm tất cả các trường siêu dữ liệu

SortOrder

Enum
ASCENDING Thứ tự tăng dần.
DESCENDING Thứ tự giảm dần.