Devices

如需本資源的方法清單，請見本頁結尾。

資源表示法

裝置資源代表由 EMM 管理且屬於特定企業使用者的行動裝置。

{
  "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
  },
  "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
}

屬性名稱	值	說明	附註
androidId	string	裝置的 Google Play 服務 Android ID，須以小寫十六進位字串格式編碼。例如 "123456789abcdef0"。
device	string	裝置的內部硬體產品代號。這項資訊來自android.os.Build.DEVICE。(名稱為「device」的欄位，每份記錄/wireless/android/android_checkin.proto)
kind	string
latestBuildFingerprint	string	裝置的版本指紋 (如果知道)。
maker	string	裝置製造商。這項資訊來自android.os.Build.MANUFACTURER。
managementType	string	指出裝置受 Google Play 管理版 EMM 在各種部署設定中的控管程度。 可能的值包括： 「managedDevice」：使用 EMM 裝置政策控制器 (DPC) 的裝置做為裝置擁有者。 「managedProfile」：這類裝置設有由 DPC (DPC) 管理的設定檔，以及 DPC 無法取得的個別個人設定檔。 「containerApp」已無法使用 (已淘汰)。 「unmanagedProfile」是指網域管理員允許的裝置 (透過管理控制台啟用該項權限) 使用 Google Play 管理版，但該設定檔本身並非由 DPC 擁有。 ，瞭解如何調查及移除這項存取權。 可接受的值為： 「containerApp」 「managedDevice」 「managedProfile」 「unmanagedProfile」
model	string	裝置的型號名稱。這項資訊來自android.os.Build.MODEL。
policy	nested object	對裝置強制執行的政策。
policy.autoUpdatePolicy	string	控制何時可在裝置上套用應用程式的自動更新。 建議的替代方案：autoUpdateMode 為個別應用程式設定，可讓您更靈活地調整更新頻率。 當 autoUpdateMode 設為 AUTO_UPDATE_POSTPONED 或 AUTO_UPDATE_HIGH_PRIORITY 時，autoUpdatePolicy 不會有任何作用。 「choiceToTheUser」可讓裝置的使用者設定應用程式更新政策。「一律」啟用自動更新「永不」會停用自動更新。「僅限 Wi-Fi」只在裝置連上 Wi-Fi 時啟用自動更新。 可接受的值為： 「always」 「choiceToTheUser」 「never」 「wifiOnly」
policy.deviceReportPolicy	string	指定裝置是否要向 EMM 回報應用程式狀態。預設值為「deviceReportDisabled」。 可接受的值為： 「deviceReportDisabled」 「deviceReportEnabled」
policy.maintenanceWindow	nested object	這個維護期間，用於定義在前景執行的應用程式應更新的時間。
policy.maintenanceWindow.durationMs	long	維護期間的持續時間 (以毫秒為單位)。時間長度必須介於 30 分鐘到 24 小時 (含) 之間。
policy.maintenanceWindow.startTimeAfterMidnightMs	long	維護期間的開始時間，以裝置午夜後的毫秒為單位。Windows 可跨越午夜。
policy.productAvailabilityPolicy	string	授予裝置的供應情形。「全部」允許裝置存取所有產品 (無論核准狀態為何)。「全部」未啟用「Alpha 版」自動顯示功能或「Beta 版」曲目「許可清單」授權裝置存取 productPolicy[] 中指定的產品。只能將已核准的產品或先前已獲企業核准 (已撤銷核准的產品) 加入許可清單。如未提供任何值，系統預設會套用使用者層級設定的供應情形。 可接受的值為： 「all」 「whitelist」
policy.productPolicy[]	list	產品政策清單。productAvailabilityPolicy 必須設為 WHITELIST 或 ALL，才能套用產品政策。
policy.productPolicy[].autoInstallPolicy	nested object	產品的自動安裝政策。
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]	list	自動安裝應用程式的限制。您最多可以指定一個限制條件。
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint	string	充電狀態限制。 可接受的值為： 「chargingNotRequired」 「chargingRequired」
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint	string	裝置閒置狀態限制。 可接受的值為： 「deviceIdleNotRequired」 「deviceIdleRequired」
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint	string	網路類型限制。 可接受的值為： 「anyNetwork」 「unmeteredNetwork」
policy.productPolicy[].autoInstallPolicy.autoInstallMode	string	自動安裝模式。如未設定，預設為「doNotAutoInstall」。無論維護期間為何，系統都會自動安裝應用程式。 可接受的值為： 「autoInstallOnce」 「doNotAutoInstall」 「forceAutoInstall」
policy.productPolicy[].autoInstallPolicy.autoInstallPriority	integer	安裝作業的優先順序，以無正負號整數表示。數字越小表示優先順序越高。
policy.productPolicy[].autoInstallPolicy.minimumVersionCode	integer	應用程式的最低版本。如果安裝的是較低版本的應用程式，應用程式將根據自動安裝限制自動更新，無需等待一般自動更新。每部裝置最多可設定 20 個應用程式的版本代碼。
policy.productPolicy[].autoUpdateMode	string	產品的自動更新模式。使用 autoUpdateMode 時，優先順序一律高於使用者選擇的設定。因此，當使用者手動變更裝置設定時，系統會忽略這些變更。 可接受的值為： 「autoUpdateDefault」 「autoUpdateHighPriority」 「autoUpdatePostponed」
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]	list	識別資訊提供者的驗證器應用程式的驗證網址設定。這樣當使用 Android WebView 進行私人應用程式時，系統就能啟動識別資訊提供者的驗證器應用程式。Authenticator 應用程式應該是裝置上驗證網址的 預設處理常式。
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri	string	驗證網址。
policy.productPolicy[].managedConfiguration	nested object	產品的受管理設定。
policy.productPolicy[].managedConfiguration.configurationVariables	nested object	包含受管理設定設定檔的 ID，以及為使用者定義的一組設定變數 (如有)。
policy.productPolicy[].managedConfiguration.configurationVariables.kind	string
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId	string	受管理設定的 ID。
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]	list	歸因於使用者的變數集。
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind	string
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder	string	預留位置字串；定義。
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue	string	使用者專屬的預留位置值。
policy.productPolicy[].managedConfiguration.kind	string	已淘汰。
policy.productPolicy[].managedConfiguration.managedProperty[]	list	這項設定的受管理屬性組合。
policy.productPolicy[].managedConfiguration.managedProperty[].key	string	用於識別屬性的專屬鍵。
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool	boolean	布林值 - 只有在屬性的類型為 bool 時才會顯示這個值。
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle	nested object	受管理的資源組合 - 只有在房源類型是套裝組合時才會顯示。
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]	list	受管理屬性的清單。
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]	list	房源組合清單 - 只有在屬性的類型為 bundle_array 時，才會顯示這個項目。
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]	list	受管理屬性的清單。
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger	integer	整數值 - 只有在屬性的類型為整數時才會顯示這個值。
policy.productPolicy[].managedConfiguration.managedProperty[].valueString	string	字串值 - 只有在屬性的型別為字串、Choice 或隱藏時，才會顯示此值。
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]	list	字串值清單 - 只有在屬性類型為複選時才會顯示。
policy.productPolicy[].managedConfiguration.productId	string	受管理設定的產品 ID，例如「app:com.google.android.gm」。
policy.productPolicy[].productId	string	產品的 ID。例如 "app:com.google.android.gm"。
policy.productPolicy[].trackIds[]	list	允許裝置查看指定產品測試群組(由 trackIds 識別)。如需取得產品的測試群組清單，請呼叫 Products.Get。
policy.productPolicy[].tracks[]	list	已淘汰，請改用 trackIds。
product	string	裝置的產品名稱。這項資訊來自android.os.Build.PRODUCT。
report	nested object	裝置報告已根據最新的應用程式狀態更新。
report.appState[]	list	裝置上受管理應用程式設定的應用程式狀態清單。應用程式狀態是由應用程式開發人員定義。系統一律會顯示這個欄位。
report.appState[].keyedAppState[]	list	具有鍵的應用程式狀態清單。系統一律會顯示這個欄位。
report.appState[].keyedAppState[].data	string	用於機器可讀取資料的額外欄位。例如數字或 JSON 物件。為了避免 XSS，建議您先從資料中移除任何 HTML 再顯示。
report.appState[].keyedAppState[].key	string	用來表示應用程式提供狀態的鍵。這組金鑰的內容是由應用程式的開發人員設定。為了避免 XSS，建議您先移除金鑰中的任何 HTML，再顯示該金鑰。系統一律會顯示這個欄位。
report.appState[].keyedAppState[].message	string	描述應用程式狀態的任意形式且使用者可理解的訊息。例如錯誤訊息。為了防止 XSS，建議您先移除訊息中的任何 HTML 後，再顯示該訊息。
report.appState[].keyedAppState[].severity	string	應用程式狀態的嚴重性。系統一律會顯示這個欄位。 可接受的值為： 「severityError」 「severityInfo」
report.appState[].keyedAppState[].stateTimestampMillis	long	應用程式設定狀態時間的時間戳記，以自 Epoch 紀元時間起算 (以毫秒為單位)。系統一律會顯示這個欄位。
report.appState[].packageName	string	應用程式的套件名稱。系統一律會顯示這個欄位。
report.lastUpdatedTimestampMillis	long	上次報告更新的時間戳記，以 Epoch 紀元時間起算，以毫秒為單位。系統一律會顯示這個欄位。
retailBrand	string	裝置的零售品牌 (如有)。查看 android.os.Build.BRAND
sdkVersion	integer	API 相容性版本。

方法

forceReportUpload

上傳報表，內含自以下時間之後的裝置應用程式狀態變化 最近產生的報表每次最多可呼叫此方法 3 次 每個裝置 24 小時。

取得

擷取裝置的詳細資料。

getState

擷取裝置是否已啟用 Google 服務的存取權，或 已停用。 只有在 Android 裝置強制執行 EMM 政策時，裝置狀態才會生效 已在 Google 管理控制台中啟用裝置。 否則，系統會忽略裝置狀態並允許存取所有裝置 。 這項功能僅適用於由 Google 管理的使用者。

list

擷取使用者所有裝置的 ID。

setState

設定是否啟用或停用裝置的 Google 服務存取權。 只有在 Android 裝置強制執行 EMM 政策時，裝置狀態才會生效 已在 Google 管理控制台中啟用裝置。 否則，系統會忽略裝置狀態並允許存取所有裝置 。 這項功能僅適用於由 Google 管理的使用者。

更新

更新裝置政策。

如要確保政策正確強制執行，請防止未受管 將存取 Google Play 的使用者帳戶設為 Google Cloud 控制台的受管理設定中的 allowed_accounts Play 套件。查看限制 帳戶