部分應用程式能夠以輸入應用程式狀態的形式將意見回饋傳送給 EMM。金鑰化應用程式狀態由專屬 ID (金鑰)、對應訊息 (選用)、機器可讀取的資料 (選用)、嚴重性狀態和時間戳記組成。如要傳送這類通知，應用程式必須整合 Enterprise Jetpack 程式庫。
EMM 可以運用來自索引鍵應用程式狀態的資料，協助 IT 管理員掌握受管理裝置和設定檔上安裝的應用程式。如需運作方式的範例，請參閱「向企業顯示意見回饋」。
啟用裝置報告
應用程式會依裝置傳送金鑰應用程式狀態。您必須先啟用裝置的裝置報告，才能接受裝置上任何應用程式的索引鍵應用程式狀態。在裝置上的政策更新之前，系統會忽略所有索引鍵的應用程式狀態，並永久遺失。在完成裝置註冊程序「之前」，盡早啟用裝置報告。這樣可確保您收到裝置註冊期間產生的應用程式意見回饋，而且不會遺失任何金鑰的應用程式狀態。
- 呼叫
devices.update()，將policy.deviceReportPolicy設為"deviceReportEnabled"。
擷取裝置報告
您可以透過下列幾種方式擷取裝置報告：
- 如要擷取裝置報告和其他通知，請呼叫
enterprises.pullNotificationSet()。在回應中，每個deviceReportUpdateEvent都代表一部裝置報告。 - 如要擷取在指定裝置中更新為使用最新金鑰化應用程式狀態的裝置報表，請呼叫
devices.get()。 - 如要強制裝置上傳最新的應用程式狀態，請呼叫
devices.forceReportUpload()。這個方法會上傳報表，其中包含自上次產生報表以來，應用程式狀態發生的任何變更。
查看金鑰應用程式狀態
裝置報告是裝置資源的一部分。報表會為裝置上安裝的個別應用程式 (套件) 或工作資料夾中的各個應用程式 (套件) 提供一個 appState 物件。特定套件的索引鍵應用程式狀態 (keyedAppState) 會列在 appState 物件中，如以下範例所示：
{
"result":{
"kind":"androidenterprise#device",
"report":{
"appState":[
{
"keyedAppState":[
{
"severity":"severityError",
"data":"user",
"message":"Username or password are incorrect",
"key":"account",
"stateTimestampMillis":"1556206406926"
}
],
"packageName":"com.google.android.feedbacktestapp"
}
],
"lastUpdatedTimestampMillis":"1556206407685"
},
"androidId":"32714368a0ad8ad5",
"managementType":"managedProfile",
"policy":{
"deviceReportPolicy":"deviceReportEnabled"
}
}
}
每個鍵化應用程式狀態都包含：
| 欄位 | 說明 |
|---|---|
key |
識別狀態的專屬金鑰。 |
severity |
狀態的嚴重性：INFO 表示資訊豐富的訊息。例如，如果代管設定成功。ERROR 表示企業需要採取行動來修正問題。例如無法調整受管理設定的情況。 |
message |
這是選用字串，提供應用程式狀態的詳細資料。我們建議應用程式開發人員將這個欄位視為向使用者顯示的訊息。 |
data |
選用的字串，可為 EMM 提供電腦可讀取的應用程式狀態詳細資料。舉例來說，您可以提供 IT 管理員在您的控制台中查詢的值，例如「如果 Battery_warning 資料小於 10」，請通知我。 |
stateTimestampMillis |
時間戳記 (以毫秒為單位)，表示應用程式狀態上次在裝置上更新的時間。 |
lastUpdatedTimestampMillis |
時間戳記 (以毫秒為單位)，表示裝置上次上傳金鑰應用程式狀態的時間。 |
向企業顯示應用程式意見回饋
應用程式會傳送意見回饋的原因有很多，不過，傳送有鍵的應用程式狀態最常見的用途是提供受管理設定的意見回饋。例如：
- IT 管理員會透過 EMM 控制台為應用程式配置受管理設定。
- 在後端，您要將設定傳送至應用程式。
- 應用程式會嘗試套用設定。應用程式會根據每項設定傳送金鑰化應用程式狀態，指出其狀態 (例如確認訊息或錯誤通知)。
- 如要查看這類重要應用程式狀態，請擷取裝置報告。
- EMM 控制台會使用金鑰應用程式狀態的資訊，以使用者容易理解的方式顯示受管理設定的狀態。
向 IT 管理員發出錯誤快訊
嚴重性為 ERROR 的金鑰應用程式狀態，表示機構必須採取行動才能修正問題。EMM 應「一律」透過 EMM 控制台或其他方式通知機構發生錯誤。舉例來說，EMM 控制台可以顯示錯誤資訊主頁，該資訊主頁會連結到含有錯誤的特定裝置意見回饋。
如果錯誤狀態修正，應用程式會傳送後續追蹤狀態，此金鑰與原始錯誤狀態相同，且嚴重性為 INFO。錯誤修正後，EMM 應「一律」通知機構。例如，請從主控台的錯誤資訊主頁移除錯誤，或將其標示為已解決。