REST Resource: enterprises.devices

資源：裝置

公司擁有的裝置。除非另有註明，否則所有欄位皆為唯讀，且無法由 enterprises.devices.patch 修改。

JSON 表示法 
{
  "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)
  }
}
欄位
name

string

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

string

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

enum (ManagementMode)

裝置採用的管理模式 Android Device Policy 類型。這會影響系統支援的政策設定。
state

enum (DeviceState)

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

enum (DeviceState)

裝置目前套用的狀態。
policyCompliant

boolean

裝置是否符合政策規定。
nonComplianceDetails[]

object (NonComplianceDetail)

裝置違反的政策設定詳細資料。
enrollmentTime

string (Timestamp format)

裝置註冊的時間。

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

string (Timestamp format)

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

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

string (Timestamp format)

已淘汰。

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

string (Timestamp format)

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

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

string

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

string

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

string (int64 format)

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

integer

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

string

如果裝置已註冊註冊權杖並提供額外資料，這個欄位會包含這些資料。
enrollmentTokenName

string

如果裝置已使用註冊權杖註冊，這個欄位會包含權杖名稱。
disabledReason

object (UserFacingMessage)

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

object (SoftwareInfo)

裝置軟體的詳細資訊。只有在裝置的政策為 softwareInfoEnabled 時，系統才會提供這項資訊。
hardwareInfo

object (HardwareInfo)

裝置硬體的詳細資訊。
displays[]

object (Display)

裝置顯示畫面的詳細資訊。只有在裝置的政策為 displayInfoEnabled 時，系統才會提供這項資訊。
applicationReports[]

object (ApplicationReport)

裝置上已安裝應用程式的報告。只有在 applicationReportsEnabled 的裝置政策中為 true 時，系統才會提供這項資訊。
previousDeviceNames[]

string

如果相同的實體裝置註冊多次，這個欄位會包含先前的裝置名稱。序號做為專屬 ID，用於判斷同一實體裝置先前是否已註冊。名稱會按照時間順序排列，
networkInfo

object (NetworkInfo)

裝置網路資訊。只有在裝置的政策為 networkInfoEnabled 時，系統才會提供這項資訊。
memoryInfo

object (MemoryInfo)

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

object (MemoryEvent)

與記憶體和儲存空間測量相關的事件，依時間順序排序。只有在裝置的政策為 memoryInfoEnabled 時，系統才會提供這項資訊。

事件會保留一段時間，舊活動也會遭到刪除。
powerManagementEvents[]

object (PowerManagementEvent)

裝置上的電源管理事件 (依時間順序排列)。只有在裝置的政策為 powerManagementEventsEnabled 時，系統才會提供這項資訊。
hardwareStatusSamples[]

object (HardwareStatus)

硬體狀態範例 (依時間順序排列)。只有在裝置的政策為 hardwareStatusEnabled 時，系統才會提供這項資訊。
deviceSettings

object (DeviceSettings)

裝置設定資訊。只有在裝置的政策為 deviceSettingsEnabled 時，系統才會提供這項資訊。
user

object (User)

擁有該裝置的使用者。
systemProperties

map (key: string, value: string)

對應於裝置相關的系統屬性名稱和值。只有在裝置的政策為 systemPropertiesEnabled 時，系統才會提供這項資訊。

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

object (SecurityPosture)

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

enum (Ownership)

受管理裝置的擁有權。
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

共同準則模式相關資訊 - 請參閱資訊技術安全性評估共同準則 (CC) 中定義的安全性標準。

只有在 statusReportingSettings.commonCriteriaModeEnabled 設為「true」的裝置政策中時，系統才會提供這項資訊。
appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • 在某些情況下，適用的規定可能與 passwordPolicies 中指定的規定略有不同。
  • fieldPath (根據passwordPolicies設定)
dpcMigrationInfo

object (DpcMigrationInfo)

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

DeviceState

裝置上適用的狀態。

列舉
DEVICE_STATE_UNSPECIFIED 不允許此值。
ACTIVE 裝置處於啟用狀態。
DISABLED 裝置已停用。
DELETED 裝置已刪除。此狀態一律不會由 API 呼叫傳回，但裝置確認刪除時，最終狀態報告會使用此狀態。如果透過 API 呼叫刪除裝置，此狀態會發布至 Pub/Sub。即便使用者刪除工作資料夾或重設裝置，伺服器仍可查看裝置狀態。
PROVISIONING 系統正在佈建裝置。新註冊的裝置在套用政策前會處於此狀態。
LOST 裝置遺失。這個狀態只能在機構擁有的裝置上運作。
PREPARING_FOR_MIGRATION 裝置正在準備遷移至 Android Management API。如要繼續遷移，您不需要採取進一步行動。

NonComplianceDetail

詳細說明未遵循政策設定的情況。

JSON 表示法 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
欄位
settingName

string

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

enum (NonComplianceReason)

裝置不符合設定的原因。
packageName

string

用來指出哪個應用程式違反規定的套件名稱。
fieldPath

string

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

value (Value format)

如果無法套用這項政策設定，代表裝置目前設定的值。
installationFailureReason

enum (InstallationFailureReason)

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

enum (SpecificNonComplianceReason)

裝置與設定不符的具體原因。
specificNonComplianceContext

object (SpecificNonComplianceContext)

specificNonComplianceReason 的其他背景資訊。

InstallationFailureReason

應用程式安裝失敗的原因。

列舉
INSTALLATION_FAILURE_REASON_UNSPECIFIED 不允許此值。
INSTALLATION_FAILURE_REASON_UNKNOWN 不明條件導致使用者無法安裝應用程式。一些可能的原因包括裝置儲存空間不足、裝置網路連線不穩定，或是安裝時間超出預期。系統將自動重新安裝。
IN_PROGRESS 安裝作業仍在進行中，
NOT_FOUND 在 Google Play 中找不到這個應用程式。
NOT_COMPATIBLE_WITH_DEVICE 這個應用程式與裝置不相容。
NOT_APPROVED 管理員尚未核准應用程式。
PERMISSIONS_NOT_ACCEPTED 應用程式擁有管理員尚未接受的新權限。
NOT_AVAILABLE_IN_COUNTRY 該應用程式並未在使用者所在的國家/地區上架。
NO_LICENSES_REMAINING 沒有可指派給該使用者的授權。
NOT_ENROLLED 企業已停止註冊 Google Play 管理版，或是管理員尚未接受最新的《Google Play 管理版服務條款》。
USER_INVALID 使用者已失效。該使用者可能已遭刪除或停用。
NETWORK_ERROR_UNRELIABLE_CONNECTION

使用者的裝置發生網路錯誤，導致安裝失敗。這通常是因為裝置的網際網路連線中斷、無法使用或網路設定問題。請確認裝置可在符合「Android Enterprise Network Requirements」的網路上能取得完整的網際網路連線。在這種情況下，應用程式會自動恢復安裝或更新作業。
INSUFFICIENT_STORAGE 使用者裝置的儲存空間不足，無法安裝應用程式。如要解決這個問題，請釋出裝置的儲存空間。裝置的儲存空間足夠後，系統會自動繼續安裝或更新應用程式。

SpecificNonComplianceReason

以下詳細說明裝置為何違反政策設定。您日後可以將新值加入列舉中。

列舉
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED 未指定特定的違規原因。未設定 specificNonComplianceContext 中的欄位。
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED 使用者必須輸入螢幕鎖定才能確認憑證。未設定 specificNonComplianceContext 中的欄位。nonComplianceReason 已設為 USER_ACTION。
PASSWORD_POLICIES_PASSWORD_EXPIRED 裝置或設定檔密碼已過期。已設定「passwordPoliciesContext」。nonComplianceReason 已設為 USER_ACTION。
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT 裝置密碼不符合密碼規定。已設定「passwordPoliciesContext」。nonComplianceReason 已設為 USER_ACTION。
ONC_WIFI_INVALID_VALUE ONC Wi-Fi 設定中的值不正確。fieldPath 指定哪個欄位值不正確。已設定「oncWifiContext」。nonComplianceReason 已設為 INVALID_VALUE。
ONC_WIFI_API_LEVEL 裝置搭載的 Android 版本 API 級別不支援 ONC Wi-Fi 設定。fieldPath 指定不支援的欄位值。已設定「oncWifiContext」。nonComplianceReason 已設為 API_LEVEL。
ONC_WIFI_INVALID_ENTERPRISE_CONFIG 企業 Wi-Fi 網路缺少根 CA 或網域名稱。nonComplianceReason 設為 INVALID_VALUE。
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK 使用者必須手動移除已設定的 Wi-Fi 網路。這項設定僅適用於個人擁有裝置的工作資料夾。nonComplianceReason 設為 USER_ACTION。
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY 在 openNetworkConfiguration 中透過 ClientCertKeyPairAlias 欄位指定的金鑰組別名，與裝置上安裝的現有金鑰未對應。nonComplianceReason 已設為 INVALID_VALUE。

SpecificNonComplianceContext

SpecificNonComplianceReason 的其他背景資訊。

JSON 表示法 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
欄位
oncWifiContext

object (OncWifiContext)

與 Wi-Fi 設定相關的違規詳情。查看《ONC_WIFI_INVALID_VALUE》和《ONC_WIFI_API_LEVEL》
passwordPoliciesContext

object (PasswordPoliciesContext)

其他與密碼政策相關的違規背景資訊。請參閱《PASSWORD_POLICIES_PASSWORD_EXPIRED及PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT》。

OncWifiContext

與 Wi-Fi 設定相關的違規詳情。

JSON 表示法 
{
  "wifiGuid": string
}
欄位
wifiGuid

string

不符規定的 Wi-Fi 設定的 GUID。

PasswordPoliciesContext

其他與密碼政策相關的違規背景資訊。

JSON 表示法 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
欄位
passwordPolicyScope

enum (PasswordPolicyScope)

不符規定的密碼範圍。

SoftwareInfo

裝置軟體相關資訊。

JSON 表示法 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
欄位
androidVersion

string

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

integer

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

string

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

string

要向使用者顯示的 Android 建構 ID 字串。例如 shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys。
deviceKernelVersion

string

核心版本，例如 2.6.32.9-g103d848。
bootloaderVersion

string

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

string (Timestamp format)

建構時間。

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

string

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

string

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

string

與系統套件相關聯的 android.content.pm.Signature 雜湊 SHA-256 雜湊，可用於驗證系統版本是否遭到修改。
systemUpdateInfo

object (SystemUpdateInfo)

可能的系統更新相關資訊。

SystemUpdateInfo

可能的系統更新相關資訊。

JSON 表示法 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
欄位
updateStatus

enum (UpdateStatus)

更新狀態：是否有更新，以及是否有更新。
updateReceivedTime

string (Timestamp format)

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

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

UpdateStatus

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

列舉
UPDATE_STATUS_UNKNOWN 不明，不確定是否有待處理的系統更新。舉例來說，如果裝置 API 級別低於 26，或是 Android Device Policy 版本過舊，就會發生這種情況。
UP_TO_DATE 裝置上沒有待處理的系統更新。
UNKNOWN_UPDATE_AVAILABLE 有可用的系統更新，但類型不明。
SECURITY_UPDATE_AVAILABLE 目前有可用的安全性更新。
OS_UPDATE_AVAILABLE 有可用的 OS 更新。

HardwareInfo

裝置硬體相關資訊。只有在裝置政策為「hardwareStatusEnabled」設為 true 時，系統才會提供與溫度門檻相關的欄位。

JSON 表示法 
{
  "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
}
欄位
brand

string

裝置品牌。例如 Google。
hardware

string

硬體名稱。例如 Angler。
deviceBasebandVersion

string

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

string

製造商。例如 Motorola。
serialNumber

string

裝置序號。
model

string

裝置的型號。例如 Asus Nexus 7。
batteryShutdownTemperatures[]

number

裝置上每個電池的攝氏溫度門檻。
batteryThrottlingTemperatures[]

number

裝置每個電池在攝氏溫度下的節流溫度門檻。
cpuShutdownTemperatures[]

number

裝置上每個 CPU 的 CPU 關閉溫度門檻 (攝氏)。
cpuThrottlingTemperatures[]

number

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

number

裝置上每個 GPU 的 GPU 關閉溫度門檻 (攝氏)。
gpuThrottlingTemperatures[]

number

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

number

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

number

裝置皮膚節流溫度 (攝氏)。
enterpriseSpecificId

string

僅供輸出。可明確識別特定機構中個人擁有裝置的 ID。在註冊於同一機構的實體裝置上，這個 ID 會在設定期間維持不變，甚至恢復原廠設定。這個 ID 適用於搭載工作資料夾的個人裝置，而且裝置必須搭載 Android 12 以上版本。

螢幕

裝置顯示資訊。

JSON 表示法 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
欄位
name

string

顯示名稱。
displayId

integer

專屬螢幕 ID。
refreshRate

integer

螢幕的刷新率，以每秒影格數為單位。
state

enum (DisplayState)

顯示狀態。
width

integer

螢幕寬度 (以像素為單位)。
height

integer

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

integer

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

DisplayState

螢幕的狀態，

列舉
DISPLAY_STATE_UNSPECIFIED 不允許此值。
OFF 螢幕已關閉。
ON 螢幕已開啟。
DOZE 螢幕處於低耗電狀態
SUSPENDED 螢幕處於暫停的低耗電狀態。

ApplicationReport

回報已安裝應用程式的相關資訊。

JSON 表示法 
{
  "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)
}
欄位
packageName

string

應用程式的套件名稱。
versionName

string

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

integer

應用程式版本代碼，可用於判斷某個版本是否比另一個版本。
events[]

object (ApplicationEvent)

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

string

應用程式的顯示名稱。
packageSha256Hash

string

應用程式 APK 檔案的 SHA-256 雜湊，可用於驗證應用程式是否遭到修改。雜湊值的每一個位元組都會以兩位數的十六進位數字表示。
signingKeyCertFingerprints[]

string

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

string

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

enum (ApplicationSource)

套件的來源。
state

enum (ApplicationState)

應用程式狀態。
keyedAppStates[]

object (KeyedAppState)

應用程式回報的金鑰應用程式狀態清單。
userFacingType

enum (UserFacingType)

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

ApplicationEvent

應用程式相關事件。

JSON 表示法 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
欄位
eventType

enum (ApplicationEventType)

應用程式事件類型。
createTime

string (Timestamp format)

活動的建立時間。

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

ApplicationEventType

應用程式相關事件的類型。

列舉
APPLICATION_EVENT_TYPE_UNSPECIFIED 不允許此值。
INSTALLED 已安裝應用程式。
CHANGED 應用程式有所變更，例如啟用或停用元件。
DATA_CLEARED 已清除應用程式資料。
REMOVED 應用程式已遭移除。
REPLACED 已安裝新版應用程式，取代舊版本。
RESTARTED 應用程式已重新啟動。
PINNED 應用程式已固定在前景。
UNPINNED 已取消固定應用程式。

ApplicationSource

提供應用程式的來源。

列舉
APPLICATION_SOURCE_UNSPECIFIED 應用程式是從未指定的來源側載。
SYSTEM_APP_FACTORY_VERSION 這是裝置原廠映像檔中的系統應用程式。
SYSTEM_APP_UPDATED_VERSION 這是新版系統應用程式。
INSTALLED_FROM_PLAY_STORE 應用程式是從 Google Play 商店安裝。

ApplicationState

目前的安裝狀態。

列舉
APPLICATION_STATE_UNSPECIFIED 未指定應用程式狀態
REMOVED 應用程式已從裝置中移除
INSTALLED 應用程式已安裝在裝置上

KeyedAppState

應用程式回報的金鑰應用程式狀態。

JSON 表示法 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
欄位
key

string

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

enum (Severity)

應用程式狀態的嚴重性。
message

string

選填，用來說明應用程式狀態的任意格式訊息字串。如果狀態是由特定值 (例如受管理的設定值) 所觸發，訊息中也應包含這項資訊。
data

string

視需要指定可供 EMM 讀取的值。例如，設定管理員可在 EMM 控制台中查詢的值 (例如「如果 Battery_warning 資料小於 10」時請通知我)。
createTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

嚴重程度

應用程式狀態的嚴重性。

列舉
SEVERITY_UNSPECIFIED 未指定的嚴重性等級。
INFO 資訊嚴重性等級。
ERROR 錯誤嚴重性等級。建議您只在管理機構需要採取行動的真實錯誤情況下，才設定這個屬性。

UserFacingType

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

列舉
USER_FACING_TYPE_UNSPECIFIED 未指定應用程式使用者端類型。
NOT_USER_FACING 應用程式未面向使用者。
USER_FACING 應用程式面向使用者。

NetworkInfo

裝置網路資訊。

JSON 表示法 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
欄位
imei

string

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

string

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

string

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

string

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

object (TelephonyInfo)

提供與裝置上每張 SIM 卡相關聯的電話資訊。僅支援 Android API 級別 23 以後的全代管裝置。

TelephonyInfo

與裝置上指定 SIM 卡相關聯的電話通訊資訊。僅支援 Android API 級別 23 以後的全代管裝置。

JSON 表示法 
{
  "phoneNumber": string,
  "carrierName": string
}
欄位
phoneNumber

string

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

string

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

MemoryInfo

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

JSON 表示法 
{
  "totalRam": string,
  "totalInternalStorage": string
}
欄位
totalRam

string (int64 format)

裝置上的 RAM 總量 (以位元組為單位)。
totalInternalStorage

string (int64 format)

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

MemoryEvent

與記憶體和儲存空間測量相關的事件。

為了區分新舊事件，建議使用 createTime 欄位。

JSON 表示法 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
欄位
eventType

enum (MemoryEventType)

這是指活動類型。
createTime

string (Timestamp format)

活動的建立時間。

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

string (int64 format)

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

MemoryEventType

事件的類型。

列舉
MEMORY_EVENT_TYPE_UNSPECIFIED 未指定。沒有任何事件具有這個類型。
RAM_MEASURED 已測量 RAM 的可用空間。
INTERNAL_STORAGE_MEASURED 評估的是內部儲存空間的可用空間。
EXTERNAL_STORAGE_DETECTED 偵測到新的外部儲存空間媒介。回報的位元組數為儲存空間中型的總容量。
EXTERNAL_STORAGE_REMOVED 已移除外部儲存空間媒介。回報的位元組數為零。
EXTERNAL_STORAGE_MEASURED 已測量外部儲存空間媒介中的可用空間。

PowerManagementEvent

電源管理事件。

JSON 表示法 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
欄位
eventType

enum (PowerManagementEventType)

這是指活動類型。
createTime

string (Timestamp format)

活動的建立時間。

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

number

如果是 BATTERY_LEVEL_COLLECTED 事件，系統會以百分比表示電池電量。

PowerManagementEventType

事件的類型。

列舉
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED 未指定。沒有任何事件具有這個類型。
BATTERY_LEVEL_COLLECTED 已測量電池電量。
POWER_CONNECTED 裝置已開始充電。
POWER_DISCONNECTED 裝置已停止充電。
BATTERY_LOW 裝置已進入低耗電模式。
BATTERY_OKAY 裝置已退出低耗電模式。
BOOT_COMPLETED 裝置已啟動。
SHUTDOWN 裝置已關閉。

HardwareStatus

硬體狀態。我們可能會將溫度與 hardwareInfo 提供的溫度門檻做比較，判斷硬體健康。

JSON 表示法 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
欄位
createTime

string (Timestamp format)

測量結果的時間。

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

number

裝置電池目前的電池溫度 (以攝氏為單位)。
cpuTemperatures[]

number

裝置上每個 CPU 目前的 CPU 溫度 (以攝氏為單位)。
gpuTemperatures[]

number

裝置上每個 GPU 的當前 GPU 溫度 (以攝氏為單位)。
skinTemperatures[]

number

目前裝置皮膚溫度 (攝氏)。
fanSpeeds[]

number

裝置上每個風扇的風扇速度 (RPM)。空白陣列表示系統不支援風扇或風扇速度。
cpuUsages[]

number

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

DeviceSettings

裝置與安全性相關的裝置設定資訊。

JSON 表示法 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
欄位
isDeviceSecure

boolean

裝置是否使用 PIN 碼/密碼確保安全。
unknownSourcesEnabled

boolean

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

boolean

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

boolean

指出裝置是否已啟用 ADB。
isEncrypted

boolean

是否啟用儲存空間加密。
encryptionStatus

enum (EncryptionStatus)

DevicePolicyManager 的加密狀態。
verifyAppsEnabled

boolean

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

EncryptionStatus

裝置的加密狀態。

列舉
ENCRYPTION_STATUS_UNSPECIFIED 未指定。所有裝置不應使用這類類型。
UNSUPPORTED 裝置不支援加密。
INACTIVE 裝置支援加密功能，但目前未啟用。
ACTIVATING 目前未啟用加密功能，但目前已啟用。
ACTIVE 已啟用加密功能。
ACTIVE_DEFAULT_KEY 加密功能已啟用，但使用者未設定加密金鑰。
ACTIVE_PER_USER 加密功能已啟用，且加密金鑰已連結至使用者個人資料。

SecurityPosture

裝置的安全防護機制 (取決於目前裝置狀態和套用的政策)。

JSON 表示法 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
欄位
devicePosture

enum (DevicePosture)

裝置的安全防護機制值。
postureDetails[]

object (PostureDetail)

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

DevicePosture

管理的裝置可能的安全防護機制值。

列舉
POSTURE_UNSPECIFIED 未指定。這個型態值沒有型態詳細資料。
SECURE 這是安全的裝置。
AT_RISK 與公司資料搭配使用時，這部裝置可能較容易遭受惡意人士攻擊。
POTENTIALLY_COMPROMISED 這部裝置可能會遭駭，且未經授權的行為人或許可以存取公司資料。

PostureDetail

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

JSON 表示法 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
欄位
securityRisk

enum (SecurityRisk)

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

object (UserFacingMessage)

對應的管理員建議，有助於降低這項安全性風險並改善裝置安全防護機制。

SecurityRisk

導致裝置未處於最佳安全狀態的風險。

列舉
SECURITY_RISK_UNSPECIFIED 未指明
UNKNOWN_OS Play Integrity API 偵測到裝置正在執行未知的 OS (基本完整性檢查成功，但 ctsProfileMatch 失敗)。
COMPROMISED_OS Play Integrity API 偵測到裝置正在執行遭入侵的 OS (基本完整性檢查失敗)。
HARDWARE_BACKED_EVALUATION_FAILED 如果裝置完整性欄位未顯示 MEETS_STRONG_INTEGRITY 標籤，Play Integrity API 會偵測裝置並未充分保證系統完整性。

CommonCriteriaModeInfo

共同準則模式相關資訊 - 請參閱資訊技術安全性評估共同準則 (CC) 中定義的安全性標準。

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

JSON 表示法 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
欄位
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

是否啟用共通條件模式。

CommonCriteriaModeStatus

是否啟用共通條件模式。

列舉
COMMON_CRITERIA_MODE_STATUS_UNKNOWN 狀態不明。
COMMON_CRITERIA_MODE_DISABLED 共同準則模式目前已停用。
COMMON_CRITERIA_MODE_ENABLED 共同準則模式目前已啟用。

DpcMigrationInfo

與這部裝置是否從其他裝置政策控制器 (DPC) 遷移的相關資訊有關的資訊。

JSON 表示法 
{
  "previousDpc": string,
  "additionalData": string
}
欄位
previousDpc

string

僅供輸出。如果這部裝置是從其他 DPC 遷移而來，這會是裝置的套件名稱。否則不會填入。
additionalData

string

僅供輸出。如果這部裝置是從其他 DPC 遷移而來，系統會在這裡填入遷移權杖的 additionalData 欄位。

方法

delete

 刪除裝置。

get

 取得裝置。

issueCommand

 向裝置發出指令。

list

 列出特定企業的裝置。

patch

 更新裝置。