Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.
Biểu diễn tài nguyên
Tài nguyên thiết bị đại diện cho một thiết bị di động do EMM quản lý và thuộc về một người dùng doanh nghiệp cụ thể.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string, "policyId": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
Tên tài sản | Giá trị | Mô tả | Ghi chú |
---|---|---|---|
androidId |
string |
Mã nhận dạng thiết bị Android của Dịch vụ Google Play cho thiết bị được mã hoá dưới dạng chuỗi hex viết thường. Ví dụ: "123456789abcdef0" . |
|
device |
string |
Tên mã phần cứng bên trong của thiết bị. Đây là thông tin từ android.os.Build.DEVICE . (trường có tên "device" mỗi nhật ký/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
Vân tay số của bản dựng thiết bị (nếu có). | |
maker |
string |
Nhà sản xuất thiết bị. Thông tin này đến từ android.os.Build.MANUFACTURER . |
|
managementType |
string |
Xác định phạm vi mà thiết bị được kiểm soát bởi dịch vụ EMM (quản lý thiết bị di động doanh nghiệp) được quản lý của Google Play trong các cấu hình triển khai khác nhau. Các giá trị có thể là:
Các giá trị được chấp nhận là:
|
|
model |
string |
Tên mẫu của thiết bị. Đây là ý kiến của android.os.Build.MODEL . |
|
policy |
nested object |
Chính sách được thực thi trên thiết bị. | |
policy.autoUpdatePolicy |
string |
Kiểm soát thời điểm có thể áp dụng bản cập nhật ứng dụng tự động trên thiết bị. Giải pháp thay thế được đề xuất: autoUpdateMode được đặt cho mỗi ứng dụng, mang lại tính linh hoạt cao hơn về tần suất cập nhật. Khi bạn đặt autoUpdateMode thành AUTO_UPDATE_POSTPONED hoặc AUTO_UPDATE_HIGH_PRIORITY , autoUpdatePolicy sẽ không có hiệu lực. "choiceToTheUser" cho phép người dùng thiết bị định cấu hình chính sách cập nhật ứng dụng. "luôn luôn" bật tính năng tự động cập nhật. "never" (không bao giờ) sẽ tắt tính năng tự động cập nhật. "chỉ wifi" chỉ cho phép tự động cập nhật khi thiết bị được kết nối Wi-Fi. Các giá trị được chấp nhận là:
|
|
policy.deviceReportPolicy |
string |
Liệu thiết bị có báo cáo trạng thái ứng dụng cho EMM hay không. Giá trị mặc định là "deviceReportDisabled".
Các giá trị được chấp nhận là:
|
|
policy.maintenanceWindow |
nested object |
Cửa sổ bảo trì xác định thời điểm cập nhật các ứng dụng chạy ở nền trước. | |
policy.maintenanceWindow.durationMs |
long |
Thời gian bảo trì, tính bằng mili giây. Thời lượng phải nằm trong khoảng từ 30 phút đến 24 giờ (bao gồm cả hai). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
Thời gian bắt đầu của thời gian bảo trì, tính bằng mili giây sau nửa đêm trên thiết bị. Windows có thể kéo dài đến nửa đêm. | |
policy.policyId |
string |
Giá trị nhận dạng cho chính sách sẽ được truyền cùng với ý kiến phản hồi về lượt cài đặt ứng dụng được gửi từ Cửa hàng Play. | |
policy.productAvailabilityPolicy |
string |
Tình trạng còn hàng được cấp cho thiết bị đối với các sản phẩm đã chỉ định. "tất cả" cấp cho thiết bị quyền truy cập vào tất cả sản phẩm, bất kể trạng thái phê duyệt là gì. "tất cả" không bật chế độ tự động hiển thị "alpha" hoặc "beta" bản nhạc. "danh sách cho phép" cấp cho thiết bị quyền truy cập vào các sản phẩm được chỉ định trong productPolicy[]. Chỉ những sản phẩm được phê duyệt hoặc sản phẩm từng được phê duyệt (sản phẩm có quyết định phê duyệt bị thu hồi) của doanh nghiệp mới có thể được đưa vào danh sách cho phép. Nếu bạn không cung cấp giá trị nào, thì tình trạng còn hàng thiết lập ở cấp người dùng sẽ được áp dụng theo mặc định.
Các giá trị được chấp nhận là:
|
|
policy.productPolicy[] |
list |
Danh sách các chính sách sản phẩm. Bạn cần đặt productAvailabilityPolicy thành WHITELIST hoặc ALL để áp dụng các chính sách về sản phẩm. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
Chính sách tự động cài đặt cho sản phẩm. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
Các quy tắc ràng buộc để tự động cài đặt ứng dụng. Bạn có thể chỉ định tối đa một quy tắc ràng buộc. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Quy tắc ràng buộc trạng thái sạc.
Các giá trị được chấp nhận là:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Quy tắc ràng buộc trạng thái rảnh của thiết bị.
Các giá trị được chấp nhận là:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Quy tắc ràng buộc về loại mạng.
Các giá trị được chấp nhận là:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
Chế độ tự động cài đặt. Nếu không được đặt, giá trị mặc định sẽ là "doNotAutoInstall". Ứng dụng sẽ tự động được cài đặt bất kể khoảng thời gian bảo trì đã đặt.
Các giá trị được chấp nhận là:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Mức độ ưu tiên của lượt cài đặt, dưới dạng số nguyên chưa ký. Số càng thấp thì mức độ ưu tiên càng cao. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
Phiên bản tối thiểu của ứng dụng. Nếu bạn cài đặt phiên bản thấp hơn của ứng dụng, thì ứng dụng sẽ tự động cập nhật theo các quy tắc ràng buộc tự động cài đặt, thay vì chờ bản cập nhật tự động thông thường. Bạn có thể đặt mã phiên bản tối thiểu cho tối đa 20 ứng dụng trên mỗi thiết bị. | |
policy.productPolicy[].autoUpdateMode |
string |
Chế độ tự động cập nhật cho sản phẩm. Khi được sử dụng, autoUpdateMode luôn được ưu tiên hơn lựa chọn của người dùng. Vì vậy, khi người dùng thay đổi chế độ cài đặt thiết bị theo cách thủ công, những thay đổi này sẽ bị bỏ qua.
Các giá trị được chấp nhận là:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Cấu hình URL xác thực cho ứng dụng trình xác thực của nhà cung cấp danh tính. Thao tác này giúp khởi chạy ứng dụng xác thực của nhà cung cấp danh tính trong quá trình xác thực diễn ra trong một ứng dụng riêng tư sử dụng Android WebView. Ứng dụng Authenticator phải là trình xử lý mặc định cho url xác thực trên thiết bị. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
URL xác thực. | |
policy.productPolicy[].managedConfiguration |
nested object |
Cấu hình được quản lý cho sản phẩm. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
Chứa mã nhận dạng của hồ sơ cấu hình được quản lý và tập hợp các biến cấu hình (nếu có) được xác định cho người dùng. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
Mã của các chế độ cài đặt cấu hình được quản lý. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
Tập hợp biến được phân bổ cho người dùng. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
Chuỗi phần giữ chỗ; do EMM xác định. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
Giá trị của phần giữ chỗ, dành riêng cho người dùng. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Không được dùng nữa. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
Tập hợp các tài sản được quản lý cho cấu hình này. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
Khoá duy nhất giúp xác định cơ sở lưu trú. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
Giá trị boolean – giá trị này chỉ xuất hiện nếu loại thuộc tính là boolean. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Gói các tài sản được quản lý – thông tin này sẽ chỉ xuất hiện nếu loại tài sản là gói. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
Danh sách tài sản được quản lý. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
Danh sách các gói thuộc tính – danh sách này sẽ chỉ xuất hiện nếu loại thuộc tính là bundle_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
Danh sách tài sản được quản lý. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
Giá trị số nguyên – giá trị này sẽ chỉ xuất hiện nếu loại thuộc tính là số nguyên. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
Giá trị chuỗi – giá trị này sẽ chỉ xuất hiện nếu loại thuộc tính là chuỗi, lựa chọn hoặc ẩn. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
Danh sách các giá trị chuỗi – danh sách này sẽ chỉ xuất hiện nếu loại thuộc tính là chọn nhiều đối tượng. | |
policy.productPolicy[].managedConfiguration.productId |
string |
Mã của sản phẩm mà cấu hình được quản lý dành cho, ví dụ: "app:com.google.android.gm". | |
policy.productPolicy[].productId |
string |
Mã nhận dạng của sản phẩm. Ví dụ: "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
Cấp quyền hiển thị thiết bị cho (các) kênh phát hành sản phẩm được chỉ định, được xác định bằng trackIds . Bạn có thể lấy danh sách các bản phát hành của một sản phẩm bằng cách gọi Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
Không dùng nữa. Thay vào đó, hãy sử dụng trackIds . |
|
product |
string |
Tên sản phẩm của thiết bị. Đây là thông tin từ android.os.Build.PRODUCT . |
|
report |
nested object |
Báo cáo thiết bị đã cập nhật các trạng thái mới nhất của ứng dụng. | |
report.appState[] |
list |
Danh sách trạng thái ứng dụng do các ứng dụng được quản lý đặt trên thiết bị. Trạng thái ứng dụng do nhà phát triển ứng dụng xác định. Trường này sẽ luôn xuất hiện. | |
report.appState[].keyedAppState[] |
list |
Danh sách trạng thái của ứng dụng được khoá. Trường này sẽ luôn xuất hiện. | |
report.appState[].keyedAppState[].data |
string |
Trường bổ sung dành cho dữ liệu mà máy có thể đọc được. Ví dụ: một số hoặc đối tượng JSON. Để ngăn chặn XSS, bạn nên xoá mọi HTML khỏi dữ liệu trước khi hiển thị dữ liệu đó. | |
report.appState[].keyedAppState[].key |
string |
Khoá cho biết ứng dụng đang cung cấp trạng thái cho mục đích gì. Nội dung của khoá là do nhà phát triển ứng dụng thiết lập. Để ngăn chặn XSS, bạn nên xoá mọi HTML khỏi khoá trước khi hiển thị khoá đó. Trường này sẽ luôn xuất hiện. | |
report.appState[].keyedAppState[].message |
string |
Thông báo ở dạng tự do, người dùng có thể đọc được, mô tả trạng thái ứng dụng. Ví dụ: một thông báo lỗi. Để ngăn XSS, chúng tôi khuyên bạn nên xoá mọi HTML khỏi thư trước khi hiển thị thư đó. | |
report.appState[].keyedAppState[].severity |
string |
Tính nghiêm trọng của trạng thái ứng dụng. Trường này sẽ luôn xuất hiện.
Các giá trị được chấp nhận là:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Dấu thời gian của thời điểm ứng dụng đặt trạng thái tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Trường này sẽ luôn xuất hiện. | |
report.appState[].packageName |
string |
Tên gói của ứng dụng. Trường này sẽ luôn xuất hiện. | |
report.lastUpdatedTimestampMillis |
long |
Dấu thời gian của lần cập nhật báo cáo gần đây nhất tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Trường này sẽ luôn xuất hiện. | |
retailBrand |
string |
Thương hiệu bán lẻ của thiết bị (nếu đã đặt). Xem android.os.Build.BRAND |
|
sdkVersion |
integer |
Phiên bản tương thích với API. |
Phương thức
- forceReportUpload
- Tải một báo cáo lên, trong đó có mọi thay đổi về trạng thái ứng dụng trên thiết bị kể từ lần tạo báo cáo gần nhất. Bạn có thể gọi phương thức này tối đa 3 lần mỗi 24 giờ cho một thiết bị cụ thể.
- get
- Truy xuất thông tin chi tiết về thiết bị.
- getState
- Truy xuất xem quyền truy cập của thiết bị vào các dịch vụ của Google có được bật hay tắt hay không. Trạng thái thiết bị chỉ có hiệu lực nếu thực thi các chính sách EMM trên Android thiết bị được bật trong Bảng điều khiển dành cho quản trị viên của Google. Nếu không, trạng thái thiết bị sẽ bị bỏ qua và tất cả thiết bị đều được phép truy cập vào các dịch vụ của Google. Chế độ này chỉ được hỗ trợ cho người dùng do Google quản lý.
- list
- Truy xuất mã nhận dạng tất cả thiết bị của người dùng.
- setState
- Đặt quyền truy cập của một thiết bị vào các dịch vụ của Google là bật hay tắt. Trạng thái thiết bị chỉ có hiệu lực nếu bạn bật chế độ thực thi chính sách EMM trên thiết bị Android trong Bảng điều khiển dành cho quản trị viên của Google. Nếu không, trạng thái thiết bị sẽ bị bỏ qua và tất cả thiết bị đều được phép truy cập vào các dịch vụ của Google. Chế độ này chỉ được hỗ trợ cho người dùng do Google quản lý.
- update
- Cập nhật chính sách thiết bị.
Để đảm bảo chính sách này được thực thi đúng cách, bạn cần ngăn chặn các tệp không được quản lý tài khoản truy cập Google Play bằng cách đặtallowed_accounts
trong cấu hình được quản lý của Google Gói Play. Xem các quy định hạn chế trong Google Play.