Tài nguyên: MobileDevice
Google Workspace Mobile Management bao gồm các thiết bị Android, Google Sync và iOS. Để biết thêm thông tin về các tác vụ API thiết bị di động phổ biến theo nhóm, hãy xem Hướng dẫn dành 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 ] } ] } |
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 sử 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à giá trị 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 chủ sở hữu thiết bị hiện tại, 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, hãy 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 hiện tại của người dùng, 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. 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 dành cho nhà phát triển. |
os |
Hệ điều hành của thiết bị di động, ví dụ như iOS 4.3 hoặc Android 2.3.5. 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 dành 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 |
Mã nhận dạng duy nhất IMEI/MEID của phần cứng Android. Không áp dụng được cho các thiết bị Google Sync. Khi thêm một 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, thuộc tính này chỉ có thể đọc. |
firstSync |
Ngày và giờ thiết bị được đồng bộ hoá lần đầu 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. Giá trị có đị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 ở dạng |
lastSync |
Ngày và giờ gần đây nhất mà thiết bị được đồng bộ hoá với các chế độ cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị có đị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 ở dạng |
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ó thuộc chủ sở hữu/hồ sơ chính hay không. |
deviceCompromisedStatus |
Trạng thái thiết bị bị xâm nhập. |
buildNumber |
Số bản dựng hệ điều hành của thiết bị. |
kernelVersion |
Phiên bản nhân hệ điều hành 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 nguồn không xác định trên thiết bị (Chỉ đọc) |
developerOptionsStatus |
Bật hoặc tắt Tuỳ chọn dành 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) |
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 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 các ứng dụng được cài đặt trên thiết bị di động Android. Không áp dụng được 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 có 5 ứng dụng, thì danh sách đó sẽ là danh sách cập nhật của 5 ứng dụng.
|
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. Đây có thể là một quyền tiêu chuẩn trên Android hoặc quyền do ứng dụng xác định và có trong tệp kê khai Android của ứng dụng. Ví dụ về quyền của ứng dụng Lịch: |
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 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. |