Tài nguyên: MobileDevice
Google Workspace Mobile Management bao gồm thiết bị Android, Google Sync và iOS. Để biết thêm thông tin về các tác vụ phổ biến đối với API trên thiết bị di động theo nhóm, hãy xem Hướng dẫn cho nhà phát triển.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "etag": string, "resourceId": string, "deviceId": string, "name": [ string ], "email": [ string ], "model": string, "os": string, "type": string, "status": string, "hardwareId": string, "firstSync": string, "lastSync": string, "userAgent": string, "serialNumber": string, "imei": string, "meid": string, "wifiMacAddress": string, "networkOperator": string, "defaultLanguage": string, "managedAccountIsOnOwnerProfile": boolean, "deviceCompromisedStatus": string, "buildNumber": string, "kernelVersion": string, "basebandVersion": string, "unknownSourcesStatus": boolean, "developerOptionsStatus": boolean, "otherAccountsInfo": [ string ], "adbStatus": boolean, "supportsWorkProfile": boolean, "manufacturer": string, "releaseVersion": string, "securityPatchLevel": string, "brand": string, "bootloaderVersion": string, "hardware": string, "encryptionStatus": string, "devicePasswordStatus": string, "privilege": string, "applications": [ { "packageName": string, "displayName": string, "versionName": string, "versionCode": integer, "permission": [ string ] } ] } |
Các trường | |
---|---|
kind |
Loại tài nguyên API. Đối với tài nguyên Thiết bị di động, giá trị là |
etag |
ETag của tài nguyên. |
resourceId |
Mã nhận dạng duy nhất mà dịch vụ API dùng để xác định thiết bị di động. |
deviceId |
Số sê-ri của thiết bị di động Google Sync. Đối với các thiết bị Android và iOS, đây là mã nhận dạng duy nhất do phần mềm tạo ra. |
name[] |
Danh sách tên người dùng của chủ sở hữu. Nếu ứng dụng của bạn cần danh sách tên hiện tại của chủ sở hữu thiết bị, hãy sử dụng phương thức get. Để biết thêm thông tin về cách truy xuất thông tin người dùng thiết bị di động, xem Hướng dẫn dành cho nhà phát triển. |
email[] |
Danh sách địa chỉ email của chủ sở hữu. Nếu ứng dụng của bạn cần danh sách email người dùng hiện tại, hãy sử dụng phương thức get. Để biết thêm thông tin, hãy xem phương thức truy xuất người dùng. |
model |
Tên mẫu của thiết bị di động, ví dụ: Nexus S. Bạn có thể cập nhật tài sản này. Để biết thêm thông tin, hãy xem Hướng dẫn cho nhà phát triển. |
os |
Hệ điều hành của thiết bị di động, ví dụ: iOS 4.3 hoặc Android 2.3.5. Bạn có thể cập nhật tài sản này. Để biết thêm thông tin, hãy xem Hướng dẫn cho nhà phát triển. |
type |
Loại thiết bị di động. |
status |
Trạng thái của thiết bị. |
hardwareId |
Giá trị nhận dạng duy nhất của IMEI/MEID cho phần cứng Android. Không áp dụng cho các thiết bị Google Sync. Khi thêm thiết bị di động Android, đây là thuộc tính không bắt buộc. Khi cập nhật một trong các thiết bị này, đây sẽ là thuộc tính chỉ có thể đọc. |
firstSync |
Ngày và giờ thiết bị được đồng bộ hóa lần đầu với cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị này ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây theo biểu mẫu |
lastSync |
Ngày và giờ thiết bị được đồng bộ hóa lần gần đây nhất với các tùy chọn cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị này ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây theo biểu mẫu |
userAgent |
Cung cấp thông tin về thiết bị, chẳng hạn như phiên bản |
serialNumber |
Số sê-ri của thiết bị. |
imei |
Số IMEI của thiết bị. |
meid |
Số MEID của thiết bị. |
wifiMacAddress |
Địa chỉ MAC của thiết bị trên mạng Wi-Fi. |
networkOperator |
Nhà cung cấp dịch vụ mạng hoặc thiết bị di động (nếu có) (Chỉ đọc) |
defaultLanguage |
Ngôn ngữ mặc định dùng trên thiết bị. |
managedAccountIsOnOwnerProfile |
Giá trị boolean cho biết tài khoản này có trên hồ sơ chính/chủ sở hữu hay không. |
deviceCompromisedStatus |
Trạng thái thiết bị bị xâm nhập. |
buildNumber |
Số bản dựng của hệ điều hành của thiết bị. |
kernelVersion |
Phiên bản kernel của thiết bị. |
basebandVersion |
Phiên bản băng tần cơ sở của thiết bị. |
unknownSourcesStatus |
Đã bật hoặc tắt các nguồn không xác định trên thiết bị (Chỉ đọc) |
developerOptionsStatus |
Bật hoặc tắt các tuỳ chọn cho nhà phát triển trên thiết bị (Chỉ đọc) |
otherAccountsInfo[] |
Danh sách tài khoản đã thêm trên thiết bị (Chỉ có thể đọc) |
adbStatus |
Bật hoặc tắt Adb (Gỡ lỗi qua USB) trên thiết bị (Chỉ đọc) |
supportsWorkProfile |
Hồ sơ công việc được hỗ trợ trên thiết bị (Chỉ đọc) |
manufacturer |
Nhà sản xuất thiết bị di động (Chỉ đọc) |
releaseVersion |
Phiên bản phát hành dành cho thiết bị di động (Chỉ đọc) |
securityPatchLevel |
Cấp bản vá bảo mật trên thiết bị di động (Chỉ đọc) |
brand |
Thương hiệu của thiết bị di động (Chỉ đọc) |
bootloaderVersion |
Phiên bản Trình tải khởi động thiết bị di động (Chỉ đọc) |
hardware |
Phần cứng thiết bị di động (Chỉ đọc) |
encryptionStatus |
Trạng thái mã hoá thiết bị di động (Chỉ đọc) |
devicePasswordStatus |
DevicePasswordStatus (Chỉ đọc) |
privilege |
DMAgentPermission (Chỉ đọc) |
applications[] |
Danh sách ứng dụng được cài đặt trên thiết bị di động Android. Không thể áp dụng cho Google Sync và các thiết bị iOS. Danh sách này bao gồm mọi ứng dụng Android truy cập vào dữ liệu trong Google Workspace. Khi cập nhật danh sách ứng dụng, điều quan trọng cần lưu ý là bản cập nhật sẽ thay thế danh sách hiện có. Nếu thiết bị Android hiện có 2 ứng dụng và API cập nhật danh sách gồm 5 ứng dụng thì giờ đây, đó là danh sách 5 ứng dụng đã cập nhật.
|
applications[].packageName |
Tên gói của ứng dụng. Ví dụ như |
applications[].displayName |
Tên hiển thị của ứng dụng. Ví dụ như |
applications[].versionName |
Tên phiên bản của ứng dụng. Ví dụ như |
applications[].versionCode |
Mã phiên bản của ứng dụng. Ví dụ như |
applications[].permission[] |
Danh sách quyền của ứng dụng này. Các quyền này có thể là quyền Android tiêu chuẩn hoặc quyền do ứng dụng xác định và có thể tìm thấy trong tệp kê khai Android của ứng dụng. Ví dụ về quyền của một ứng dụng Lịch là |
Phương thức |
|
---|---|
|
Thực hiện hành động ảnh hưởng đến thiết bị di động. |
|
Xoá thiết bị di động. |
|
Truy xuất thuộc tính của thiết bị di động. |
|
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. |