REST Resource: enterprises.devices

{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}

string

裝置名稱，格式為 enterprises/{enterpriseId}/devices/{deviceId}。

string

擁有這部裝置的使用者資源名稱，格式為 enterprises/{enterpriseId}/users/{userId}。

enum (ManagementMode)

Android Device Policy 可選擇的管理模式類型。這項政策會影響系統支援的政策設定。

enum (DeviceState)

要為裝置套用的狀態。這個欄位可透過修補要求修改。請注意，呼叫 enterprises.devices.patch、ACTIVE 和 DISABLED 是唯一允許的值。如要將裝置進入「DELETED」狀態，請呼叫 enterprises.devices.delete。

enum (DeviceState)

裝置目前套用的狀態。

boolean

裝置是否遵循裝置政策。

object (NonComplianceDetail)

進一步瞭解裝置不符合的政策設定。

string (Timestamp format)

裝置註冊時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

裝置上次傳送狀態報告的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

已淘汰。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

裝置上次擷取政策的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string

套用至裝置的政策名稱，格式為 enterprises/{enterpriseId}/policies/{policyId}。如未指定，系統會為裝置使用者套用 policyName。這個欄位可透過修補要求修改。您可以只在呼叫 enterprises.devices.patch 時指定 policyId，前提是 policyId 不含任何斜線。系統會推論政策名稱的其餘部分。

string

裝置目前套用的政策名稱。

string (int64 format)

裝置目前套用的政策版本。

integer

裝置上所執行的 Android 平台版本 API 級別。

string

如果裝置是使用註冊權杖註冊且提供了其他資料，這個欄位就會包含該資料。

string

如果裝置是透過註冊權杖註冊，這個欄位會包含權杖名稱。

object (UserFacingMessage)

如果裝置狀態為 DISABLED，裝置上會顯示選擇性訊息，指出裝置停用原因。這個欄位可透過修補要求修改。

object (SoftwareInfo)

裝置軟體的詳細資訊。只有當裝置政策中的 softwareInfoEnabled 為 true 時，系統才會顯示這項資訊。

object (HardwareInfo)

裝置硬體的詳細資訊。

object (Display)

裝置顯示詳細資訊。只有當裝置政策中的 displayInfoEnabled 為 true 時，系統才會顯示這項資訊。

object (ApplicationReport)

針對裝置上安裝的應用程式回報。只有當裝置政策的 applicationReportsEnabled 為 true 時，系統才會顯示這項資訊。

string

如果同一部實體裝置已多次註冊，這個欄位會包含舊裝置名稱。序號會用做專屬 ID，判斷同一實體裝置先前已註冊過。這些名稱會按照時間順序排列。

object (NetworkInfo)

裝置網路資訊。只有當裝置政策中的 networkInfoEnabled 為 true 時，系統才會顯示這項資訊。

object (MemoryInfo)

記憶體資訊：包含裝置記憶體和儲存空間的相關資訊。

object (MemoryEvent)

與記憶體和儲存空間測量相關的事件，按時間順序排列。只有當裝置政策中的 memoryInfoEnabled 為 true 時，系統才會顯示這項資訊。

系統會將活動保留一段時間，並刪除舊活動。

object (PowerManagementEvent)

裝置上的電源管理事件 (依時間順序排列)。只有當裝置政策中的 powerManagementEventsEnabled 為 true 時，系統才會顯示這項資訊。

object (HardwareStatus)

硬體狀態範例 (按時間順序排列)。只有當裝置政策中的 hardwareStatusEnabled 為 true 時，系統才會顯示這項資訊。

object (DeviceSettings)

裝置設定資訊。只有當裝置政策中的 deviceSettingsEnabled 為 true 時，系統才會顯示這項資訊。

object (User)

裝置擁有者。

map (key: string, value: string)

所選系統屬性名稱和裝置相關值的對應表。只有當裝置政策中的 systemPropertiesEnabled 為 true 時，系統才會顯示這項資訊。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

object (SecurityPosture)

裝置的安全防護機制值，可反映裝置的安全性。

enum (Ownership)

受管理裝置的擁有權。

object (CommonCriteriaModeInfo)

進一步瞭解共通準則模式，也就是《資訊科技安全評估共同準則》(CC) 中定義的安全標準。

只有在裝置獲派的政策中的 statusReportingSettings.commonCriteriaModeEnabled 為 true 時，系統才會提供這項資訊。

object (PasswordRequirements)

裝置目前套用的密碼規定。

• 在某些情況下，套用要求可能會與 passwordPolicies 中指定的規定略有不同。
• fieldPath 是根據 passwordPolicies 設定。

object (DpcMigrationInfo)

僅供輸出。與這部裝置是否由其他裝置政策控制器 (DPC) 管理的相關資訊有關。

{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}

string

政策設定的名稱。這是頂層 Policy 欄位的 JSON 欄位名稱。

enum (NonComplianceReason)

裝置不符合設定的原因。

string

指明哪一個應用程式不符合規定的套件名稱 (如適用)。

string

針對含有巢狀欄位的設定，如果特定巢狀欄位不符合規定，這會指定違規欄位的完整路徑。路徑格式與 JavaScript 政策 JSON 欄位的參照方式相同，即：1) 如果是物件類型的欄位，欄位名稱後面會有一個點，後面接著子欄位名稱。2) 如果是陣列類型欄位，欄位名稱後面接上括號括住的陣列索引。舉例來說，如要指出第 3 應用程式中 externalData 欄位中的 url 欄位有問題，路徑為 applications[2].externalData.url

value (Value format)

如果無法套用政策設定，表示裝置上目前設定的值。

enum (InstallationFailureReason)

如果已設定 packageName，且違規原因為 APP_NOT_INSTALLED 或 APP_NOT_UPDATED，則無法安裝或更新應用程式的詳細原因。

enum (SpecificNonComplianceReason)

裝置未遵守設定的政策特定原因。

object (SpecificNonComplianceContext)

specificNonComplianceReason 的其他相關資訊。

{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}

object (OncWifiContext)

其他不符合 Wi-Fi 設定規範的背景資訊。請參閱《ONC_WIFI_INVALID_VALUE》和《ONC_WIFI_API_LEVEL》

object (PasswordPoliciesContext)

關於密碼政策違規情況的額外背景資訊。詳情請參閱《PASSWORD_POLICIES_PASSWORD_EXPIRED》和《PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT》。

{
  "wifiGuid": string
}

string

不符合 Wi-Fi 設定的 GUID。

{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}

enum (PasswordPolicyScope)

不符合規定的密碼範圍。

{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}

string

使用者可看到的 Android 版本字串。例如 6.0.1。

integer

Android Device Policy 應用程式的版本代碼。

string

向使用者顯示的 Android Device Policy 應用程式版本。

string

用於向使用者顯示的 Android 版本 ID 字串。例如 shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys。

string

核心版本，例如 2.6.32.9-g103d848。

string

系統系統啟動載入程式版本號碼，例如0.6.7。

string (Timestamp format)

建構時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string

安全性修補程式等級，例如2016-05-01。

string

裝置主要語言代碼的 IETF BCP 47 語言代碼。

string

與系統套件相關聯 android.content.pm.Signature 的 SHA-256 雜湊，可用來確認系統版本未經過修改。

object (SystemUpdateInfo)

關於潛在系統更新的資訊。

{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}

enum (UpdateStatus)

更新的狀態：是否有更新，以及更新類型。

string (Timestamp format)

首次發布更新的時間。如果值為零，表示未設定這個欄位。只有在有可用的更新時，系統才會設定這個欄位 (也就是 updateStatus 不是 UPDATE_STATUS_UNKNOWN 或 UP_TO_DATE)。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}

string

裝置品牌。例如 Google。

string

硬體名稱。例如 Angler。

string

基頻版本。例如 MDM9625_104662.22.05.34p。

string

製造商例如 Motorola。

string

裝置序號。

string

裝置的型號。例如 Asus Nexus 7。

number

裝置每個電池的電池關閉溫度門檻 (以攝氏為單位)。

number

裝置上每個電池的電池調節溫度門檻 (以攝氏為單位)。

number

裝置上每個 CPU 的 CPU 關閉溫度門檻 (以攝氏為單位)。

number

裝置上每個 CPU 的 CPU 節流溫度門檻 (以攝氏為單位)。

number

裝置上每個 GPU 的 GPU 關閉溫度門檻 (以攝氏為單位)。

number

裝置上每個 GPU 的 GPU 節流溫度門檻 (以攝氏為單位)。

number

裝置皮膚關閉溫度門檻 (攝氏)。

number

裝置皮膚節流溫度門檻 (以攝氏為單位)。

string

僅供輸出。專門用於辨識特定機構中個人裝置的 ID。在同一機構註冊至相同實體裝置的情況下，這個 ID 會在設定和恢復原廠設定時保留。這個 ID 適用於個人擁有，且裝置上設有工作資料夾的裝置，且搭載 Android 12 以上版本。

{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}

string

顯示畫面的名稱。

integer

不重複的顯示 ID。

integer

畫面的刷新率 (以每秒影格數為單位)。

enum (DisplayState)

顯示畫面的狀態。

integer

顯示寬度 (以像素為單位)。

integer

顯示高度 (以像素為單位)。

integer

顯示密度，以每英寸像素數表示。

{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}

string

應用程式的套件名稱。

string

向使用者顯示的應用程式版本。

integer

應用程式版本代碼，可用來判斷某版本是否比其他版本新。

object (ApplicationEvent)

過去 30 小時內發生的應用程式事件清單。

string

應用程式的顯示名稱。

string

應用程式 APK 檔案的 SHA-256 雜湊，可用於驗證應用程式未經過修改。雜湊值的每個位元組都以兩位數十六進制數字表示。

string

與應用程式套件相關聯的每個 android.content.pm.Signature 的 SHA-1 雜湊值。每個雜湊值的每個位元組都會以兩位數十六進制數字表示。

string

安裝這個應用程式的應用程式套件名稱。

enum (ApplicationSource)

套件的來源。

enum (ApplicationState)

應用程式狀態。

object (KeyedAppState)

應用程式回報的按鍵應用程式狀態清單。

enum (UserFacingType)

應用程式是否會向使用者顯示。

{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}

enum (ApplicationEventType)

應用程式事件類型。

string (Timestamp format)

事件的建立時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}

string

應用程式狀態的鍵。做為應用程式提供狀態的參考依據。舉例來說，提供受管理設定的意見回饋時，這個金鑰可能會是受管理的設定金鑰。

enum (Severity)

應用程式狀態的嚴重性。

string

或者，您也可以使用任意形式的訊息字串來說明應用程式狀態。如果狀態是由特定值所觸發 (例如受管理的設定值)，應加入訊息中。

string

(選用) 可供 EMM 讀取的機器可讀值。例如，設定管理員可在 EMM 控制台中查詢的值 (例如「當 Battery_warning 資料小於 10 時通知我」)。

string (Timestamp format)

裝置上應用程式狀態的建立時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

應用程式狀態最近一次更新的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}

string

GSM 裝置的 IMEI 號碼。例如 A1000031212。

string

CDMA 裝置的 MEID 號碼。例如 A00000292788E1。

string

裝置的 Wi-Fi MAC 位址。例如 7c:11:11:11:11:11。

string

目前註冊業者的字母名稱。例如 Vodafone。

object (TelephonyInfo)

提供與裝置上每張 SIM 卡相關聯的電話資訊。僅適用於 Android API 級別 23 以上版本的全代管裝置。

{
  "phoneNumber": string,
  "carrierName": string
}

string

與這張 SIM 卡相關聯的電話號碼。

string

與這張 SIM 卡相關聯的電信業者名稱。

{
  "totalRam": string,
  "totalInternalStorage": string
}

string (int64 format)

裝置上的 RAM 總量，以位元組為單位。

string (int64 format)

裝置上的內部儲存空間總量，以位元組為單位。

{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}

enum (MemoryEventType)

這是指活動類型。

string (Timestamp format)

事件的建立時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (int64 format)

媒介中的可用位元組數，或以 EXTERNAL_STORAGE_DETECTED 來說，儲存空間媒介的總容量 (以位元組為單位)。

{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}

enum (PowerManagementEventType)

這是指活動類型。

string (Timestamp format)

事件的建立時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

number

對於 BATTERY_LEVEL_COLLECTED 事件，電池電量會以百分比表示。

{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}

string (Timestamp format)

進行測量的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

number

裝置中每個電池的目前電池溫度 (以攝氏為單位)。

number

裝置中各個 CPU 的目前 CPU 溫度 (以攝氏為單位)。

number

裝置上每個 GPU 的目前 GPU 溫度 (以攝氏為單位)。

number

目前裝置的皮膚溫度 (攝氏)。

number

裝置上每位粉絲的風扇速度 (RPM)。如果陣列為空白，表示系統不支援風扇或風扇速度。

number

裝置上每個可用核心的 CPU 用量 (以百分比表示)。每個未插電的核心用量為 0。空白陣列表示系統不支援 CPU 使用率。

{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}

boolean

裝置是否受到 PIN 碼/密碼保護。

boolean

是否已啟用從不明來源安裝應用程式的功能。

boolean

裝置是否已啟用開發人員模式。

boolean

是否在裝置上啟用 ADB。

boolean

是否啟用儲存空間加密。

enum (EncryptionStatus)

來自 DevicePolicyManager 的加密狀態。

boolean

是否要在裝置上強制執行 Google Play 安全防護驗證。

{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}

enum (DevicePosture)

裝置的安全防護機制值。

object (PostureDetail)

關於裝置安全防護機制的其他詳細資料。

{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}

enum (SecurityRisk)

對裝置安全防護機製造成負面影響的特定安全性風險。

object (UserFacingMessage)

針對管理員提供的對應建議，可降低這項安全性風險，並改善裝置安全性。

{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}

enum (CommonCriteriaModeStatus)

是否已啟用共同準則模式。

{
  "previousDpc": string,
  "additionalData": string
}

string

僅供輸出。如果這部裝置是從其他裝置政策控制器 (DPC) 遷移，則會是套件名稱。否則不會填入。

string

僅供輸出。如果這部裝置是從其他裝置政策控制器 (DPC) 遷移，則遷移權杖的「additionalData」欄位會填入這裡。