Truy xuất danh sách đã phân trang gồm tất cả các thiết bị di động do người dùng sở hữu cho một tài khoản. Để truy xuất danh sách bao gồm các thiết bị do công ty sở hữu, hãy sử dụng Devices API 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 bài viết 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
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ề. Giá trị tối đa cho phép là 100. |
orderBy |
Thuộc tính thiết bị để sắp xếp kết quả. |
pageToken |
Mã thông báo để chỉ định trang tiếp theo trong danh sách |
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/search-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ố |
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 ( |
Các trường | |
---|---|
kind |
Đây là một loại tài nguyên. |
etag |
ETag của tài nguyên. |
mobiledevices[] |
Danh sách đối tượng Thiết bị di động. |
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. |
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.
OrderBy
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à mã 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 |
Ngày đồng bộ hoá chế độ cài đặt chính sách gần đây nhất của thiết bị. |
MODEL |
Kiểu 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ụ: mã thiết bị, 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. |