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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
欄位
name

string

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

string

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

enum (ManagementMode)

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

enum (DeviceState)

要套用至裝置的狀態。這個欄位可透過 PATCH 要求修改。請注意，呼叫 enterprises.devices.patch 時，僅允許使用 ACTIVE 和 DISABLED 值。如要讓裝置進入 DELETED 狀態，請呼叫 enterprises.devices.delete。
appliedState

enum (DeviceState)

目前套用至裝置的狀態。
policyCompliant

boolean

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

object (NonComplianceDetail)

裝置不符合的政策設定詳細資料。
enrollmentTime

string (Timestamp format)

裝置註冊時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastStatusReportTime

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

已淘汰。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastPolicySyncTime

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
policyName

string

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

string

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

string (int64 format)

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

integer

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

string

如果裝置是透過註冊權杖註冊，且提供額外資料，這個欄位就會包含該資料。
enrollmentTokenName

string

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

object (UserFacingMessage)

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

object (SoftwareInfo)

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

object (HardwareInfo)

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

object (Display)

裝置螢幕的詳細資訊。只有在裝置政策中將 displayInfoEnabled 設為 True 時，系統才會提供這項資訊。
applicationReports[]

object (ApplicationReport)

裝置上安裝的應用程式報表。只有在裝置政策中 applicationReportsEnabled 為 true 時，這項資訊才可用。
previousDeviceNames[]

string

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

object (NetworkInfo)

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

object (MemoryInfo)

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

object (MemoryEvent)

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

系統會保留事件一段時間，然後刪除舊事件。
powerManagementEvents[]

object (PowerManagementEvent)

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

object (HardwareStatus)

依時間順序排列的硬體狀態樣本。只有在裝置政策中將 hardwareStatusEnabled 設為 True 時，系統才會提供這項資訊。
deviceSettings

object (DeviceSettings)

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

object (User)

裝置擁有者。
systemProperties

map (key: string, value: string)

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

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

object (SecurityPosture)

裝置的安全狀態值，反映裝置的安全性。
ownership

enum (Ownership)

受管理裝置的擁有權。
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

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

只有在裝置政策中，公司擁有的裝置設為 statusReportingSettings.commonCriteriaModeEnabledtrue 時，才能取得這項資訊。
appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • 在某些情況下，套用的規定可能與 passwordPolicies 中指定的規定略有不同，因此需要這個欄位。
  • 請注意，這個欄位不會提供密碼是否符合規定等資訊。如需不符規定資訊，請參閱 nonComplianceDetails。
  • NonComplianceDetail.fieldPath 是根據 passwordPolicies 設定，而非根據這個欄位。
dpcMigrationInfo

object (DpcMigrationInfo)

僅供輸出。這部裝置是否從其他裝置政策控制器 (DPC) 管理的裝置遷移。
defaultApplicationInfo[]

object (DefaultApplicationInfo)

僅供輸出。DefaultApplicationType 的預設應用程式資訊。只有在裝置政策中將 defaultApplicationInfoReportingEnabled 設為 True 時，系統才會提供這項資訊。適用於 Android 16 以上版本。

全代管裝置會回報所有類型的應用程式。如果公司擁有的裝置設有工作資料夾，以及個人擁有的裝置，系統會針對工作資料夾回報 DEFAULT_BROWSER、DEFAULT_CALL_REDIRECTION、DEFAULT_CALL_SCREENING 和 DEFAULT_DIALER 類型。設有工作資料夾的公司裝置也會回報 DEFAULT_WALLET，但只會包含工作資料夾資訊。

DeviceState

可套用至裝置的狀態。

列舉
DEVICE_STATE_UNSPECIFIED 這個值不允許使用。
ACTIVE 裝置已啟用。
DISABLED 裝置已停用。
DELETED 裝置已刪除。API 呼叫絕不會傳回這個狀態，但裝置確認刪除時，最終狀態報告會使用這個狀態。如果透過 API 呼叫刪除裝置，系統會將此狀態發布至 Pub/Sub。如果使用者刪除工作資料夾或重設裝置，伺服器仍會顯示裝置狀態不明。
PROVISIONING 裝置正在佈建。新註冊的裝置會處於這個狀態，直到套用政策為止。
LOST 裝置遺失。只有機構擁有的裝置才可能處於這種狀態。
PREPARING_FOR_MIGRATION 裝置正在準備遷移至 Android Management API。遷移作業會繼續進行，您不需要採取進一步行動。
DEACTIVATED_BY_DEVICE_FINANCE 這是以分期付款方式購買的裝置，已遭分期付款代理人「鎖定」。這表示系統已套用特定政策設定，因此裝置功能會受到限制，直到融資代理人「解鎖」裝置為止。裝置會繼續套用政策設定，但融資代理商覆寫的設定除外。裝置「鎖定」時，appliedState 會將狀態回報為 DEACTIVATED_BY_DEVICE_FINANCE。

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 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。
PERMISSIBLE_USAGE_RESTRICTION 這項政策設定受到限制，無法為這個 Google Cloud Platform 專案設定。如要瞭解更多詳細資訊 (包括如何啟用這項政策設定)，請參閱可接受的使用方式政策。nonComplianceReason已設為 PROJECT_NOT_PERMITTED。
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE workAccountSetupConfig政策設定要求的公司帳戶已不再屬於企業。nonComplianceReason已設為 USER_ACTION。
NEW_ACCOUNT_NOT_IN_ENTERPRISE 使用者新增的公司帳戶不屬於該企業。nonComplianceReason 設為 USER_ACTION。
DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES

如果管理模式不支援特定範圍，系統會套用預設應用程式設定，即使管理模式本身支援該應用程式類型也一樣 (例如，如果將含有 DEFAULT_BROWSER 應用程式類型和 [SCOPE_PERSONAL_PROFILE] 清單的政策傳送至全代管裝置，管理模式就不適用於這些範圍)。如果應用程式類型不支援管理模式，系統會回報 NonComplianceDetail (含 MANAGEMENT_MODE)，但不含 specificNonComplianceReason。

nonComplianceReason 設為 MANAGEMENT_MODE。
DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE 無法為特定範圍套用預設應用程式設定。defaultApplicationContext。nonComplianceReason 設為 INVALID_VALUE 或 APP_NOT_INSTALLED。

SpecificNonComplianceContext

SpecificNonComplianceReason 的其他脈絡資訊。

JSON 表示法 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
欄位
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》。
defaultApplicationContext

object (DefaultApplicationContext)

僅供輸出。如果預設應用程式設定導致違規，請提供額外背景資訊。詳情請參閱《DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE》。

OncWifiContext

與 Wi-Fi 設定相關的違規額外脈絡資訊。

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

string

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

PasswordPoliciesContext

與密碼政策相關的違規事項額外背景資訊。

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

enum (PasswordPolicyScope)

不符規定的密碼範圍。

DefaultApplicationContext

針對預設應用程式設定相關違規事項提供額外背景資訊。

JSON 表示法 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
欄位
defaultApplicationScope

enum (DefaultApplicationScope)

僅供輸出。不符規定的預設應用程式設定範圍。

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)

建構時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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)，才會設定這個欄位。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

UpdateStatus

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

列舉
UPDATE_STATUS_UNKNOWN 系統更新是否待處理不得而知。舉例來說，如果裝置 API 級別低於 26，或是 Android 裝置政策版本過舊，就會發生這種情況。
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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
欄位
brand

string

裝置品牌。例如 Google。
hardware

string

硬體名稱。例如 Angler。
deviceBasebandVersion

string

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

string

製造商：例如 Motorola。
serialNumber

string

裝置序號。不過，如果個人裝置搭載 Android 12 以上版本，這項權限與 enterpriseSpecificId 相同。
model

string

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

number

裝置上每個電池的攝氏溫度關機閾值。
batteryThrottlingTemperatures[]

number

裝置上每個電池的攝氏溫度電池節流閾值。
cpuShutdownTemperatures[]

number

裝置上每個 CPU 的攝氏溫度關機閾值。
cpuThrottlingTemperatures[]

number

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

number

裝置上每個 GPU 的攝氏溫度關機閾值。
gpuThrottlingTemperatures[]

number

裝置上每個 GPU 的攝氏溫度 GPU 節流溫度門檻。
skinShutdownTemperatures[]

number

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

number

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

string

僅供輸出。可明確識別特定機構中個人裝置的 ID。在註冊相同機構的同一部實體裝置上，這個 ID 會在設定程序中保留，即使恢復原廠設定也不會變更。這項 ID 適用於搭載 Android 12 以上版本，並設有工作資料夾的個人裝置。
euiccChipInfo[]

object (EuiccChipInfo)

僅供輸出。與 eUICC 晶片相關的資訊。

EuiccChipInfo

與 eUICC 晶片相關的資訊。

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

string

僅供輸出。內嵌式身分證件 (EID)，用於識別裝置上每個 eUICC 晶片的 eUICC 晶片。這項功能適用於搭載 Android 13 以上版本的公司裝置。

多媒體

裝置顯示資訊。

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)

活動的建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

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 商店安裝。
CUSTOM 應用程式是使用 AMAPI SDK 指令安裝。另請參閱：CUSTOM

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)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastUpdateTime

string (Timestamp format)

應用程式狀態的上次更新時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

嚴重性

應用程式狀態的嚴重程度。

列舉
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,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
欄位
phoneNumber

string

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

string

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

string

僅供輸出。與這張 SIM 卡相關聯的 ICCID。
activationState

enum (ActivationState)

僅供輸出。裝置上 SIM 卡的啟用狀態。這項功能僅適用於 eSIM 卡。這項功能適用於 API 級別 35 以上版本的所有裝置。實體 SIM 卡和 API 級別 35 以下的裝置一律會顯示 ACTIVATION_STATE_UNSPECIFIED。
configMode

enum (ConfigMode)

僅供輸出。裝置上 SIM 卡的設定模式。這項功能僅適用於 eSIM 卡。這項功能適用於 API 級別 35 以上版本的所有裝置。實體 SIM 卡和 API 級別 35 以下的裝置一律會顯示 CONFIG_MODE_UNSPECIFIED。

ActivationState

裝置上 SIM 卡的啟用狀態。

列舉
ACTIVATION_STATE_UNSPECIFIED 未指定啟用狀態。
ACTIVATED SIM 卡已啟用。
NOT_ACTIVATED SIM 卡尚未啟用。

ConfigMode

裝置上 SIM 卡的設定模式。

列舉
CONFIG_MODE_UNSPECIFIED 未指定設定模式。
ADMIN_CONFIGURED 管理員已設定這張 SIM 卡。
USER_CONFIGURED 使用者已設定這張 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)

活動的建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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)

活動的建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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)

測量時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
batteryTemperatures[]

number

裝置上每個電池目前的攝氏溫度。
cpuTemperatures[]

number

裝置上每個 CPU 目前的攝氏溫度。
gpuTemperatures[]

number

裝置上每個 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 偵測到裝置執行不明作業系統 (basicIntegrity 檢查成功，但 ctsProfileMatch 失敗)。
COMPROMISED_OS Play Integrity API 偵測到裝置執行的作業系統遭到入侵 (基本完整性檢查失敗)。
HARDWARE_BACKED_EVALUATION_FAILED 如果 裝置完整性欄位中未顯示 MEETS_STRONG_INTEGRITY 標籤，Play Integrity API 會偵測到裝置無法充分確保系統完整性。

CommonCriteriaModeInfo

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

只有在裝置政策中statusReportingSettings.commonCriteriaModeEnabledtrue，系統才會提供這項資訊。

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

enum (CommonCriteriaModeStatus)

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

enum (PolicySignatureVerificationStatus)

僅供輸出。政策簽章驗證狀態。

CommonCriteriaModeStatus

是否啟用共同準則模式。

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

PolicySignatureVerificationStatus

政策簽章驗證狀態。

列舉
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED 未指定。驗證狀態尚未回報。只有在 statusReportingSettings.commonCriteriaModeEnabled 為 false 時才會設定。
POLICY_SIGNATURE_VERIFICATION_DISABLED 由於 commonCriteriaMode 設為 false，裝置已停用政策簽章驗證。
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED 政策簽章驗證成功。
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED 不支援政策簽章驗證，例如裝置註冊的 CloudDPC 版本不支援政策簽章驗證。
POLICY_SIGNATURE_VERIFICATION_FAILED 政策簽章驗證失敗。政策尚未套用。

DpcMigrationInfo

這部裝置是否從其他裝置政策控制器 (DPC) 管理的裝置遷移。

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

string

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

string

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

DefaultApplicationInfo

特定 DefaultApplicationType 的預設應用程式資訊。

JSON 表示法 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
欄位
defaultApplicationType

enum (DefaultApplicationType)

僅供輸出。預設應用程式類型。
packageName

string

僅供輸出。目前預設應用程式的套件名稱。
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

僅供輸出。預設應用程式設定嘗試的詳細資料，順序與 defaultApplications 中列出的相同。

DefaultApplicationSettingAttempt

嘗試設定預設應用程式設定的詳細資料。

JSON 表示法 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
欄位
packageName

string

僅供輸出。嘗試存取的應用程式套件名稱。
attemptOutcome

enum (AttemptOutcome)

僅供輸出。將應用程式設為預設應用程式的結果。

AttemptOutcome

將應用程式設為預設應用程式的結果。

列舉
ATTEMPT_OUTCOME_UNSPECIFIED 嘗試結果不明。未使用。
SUCCESS 已成功將應用程式設為預設應用程式。
APP_NOT_INSTALLED 由於未安裝應用程式，嘗試失敗。
APP_SIGNING_CERT_MISMATCH 由於 Play 商店或 ApplicationPolicy.signingKeyCerts 中的應用程式簽署金鑰憑證指紋與裝置上的指紋不符，因此嘗試失敗。
OTHER_FAILURE 因其他原因導致嘗試失敗。

方法

delete

 刪除裝置。

get

 取得裝置。

issueCommand

 向裝置發出指令。

list

 列出指定企業的裝置。

patch

 更新裝置。