REST Resource: enterprises.devices

リソース: Device

企業が所有するデバイス。特に記載のない限り、すべてのフィールドは読み取り専用であり、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)

デバイスの登録日時。

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 が適用されます。このフィールドは、パッチ リクエストで変更できます。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

同じ物理デバイスが複数回登録されている場合、このフィールドには以前のデバイス名が含まれます。シリアル番号は、同じ物理デバイスが以前に登録されているかどうかを判断するための一意の識別子として使用されます。名前は時系列順に表示されます。
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.commonCriteriaModeEnabled が true であり、デバイスが会社所有である場合にのみ利用できます。
appliedPasswordPolicies[]

object (PasswordRequirements)

デバイスに現在適用されているパスワード要件。

  • 適用される要件は、passwordPolicies で指定されている要件と若干異なる場合があります。
  • fieldPath は passwordPolicies に基づいて設定されます。
dpcMigrationInfo

object (DpcMigrationInfo)

出力専用。このデバイスが別の Device Policy Controller（DPC）から管理対象に移行されたかどうかに関する情報。

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 組織が managed Google Play への登録を解除した、または管理者が最新の managed 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 ONC Wi-Fi 設定は、デバイスで実行されている Android バージョンの API レベルでサポートされていません。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)

ビルド時間。

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)

アップデートが最初に利用可能になった日時。値 0 は、このフィールドが設定されていないことを示します。このフィールドは、更新が利用可能な場合にのみ設定されます（つまり、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
}
フィールド
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 ハッシュ。アプリが変更されていないことを確認するために使用できます。ハッシュ値の各バイトは 2 桁の 16 進数で表されます。
signingKeyCertFingerprints[]

string

アプリ パッケージに関連付けられている各 android.content.pm.Signature の SHA-1 ハッシュ。各ハッシュ値の各バイトは 2 桁の 16 進数で表されます。
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 ストアからインストールされたものである。

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
}
フィールド
phoneNumber

string

この SIM カードに関連付けられている電話番号。
carrierName

string

この SIM カードに関連付けられている携帯通信会社の名称。
iccId

string

出力専用。この SIM カードに関連付けられている ICCID。

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 の現在の 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 を実行していることを検出しました（basicIntegrity チェックは成功しましたが、ctsProfileMatch は失敗しました）。
COMPROMISED_OS Play Integrity API が、デバイスが侵害された OS を実行していることを検出しました（basicIntegrity チェックが失敗しました）。
HARDWARE_BACKED_EVALUATION_FAILED デバイスの完全性フィールドに MEETS_STRONG_INTEGRITY ラベルが表示されない場合、Play Integrity API はデバイスにシステム完全性の強力な保証がないことを確認します。

CommonCriteriaModeInfo

コモン クライテリア モードに関する情報 - 情報技術セキュリティ評価のための共通基準（CC）で定義されているセキュリティ基準。

この情報は、デバイスのポリシーで statusReportingSettings.commonCriteriaModeEnabled が true の場合にのみ利用できます。

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

このデバイスが別の Device Policy Controller（DPC）から管理対象に移行されたかどうかに関する情報。

JSON 表現 
{
  "previousDpc": string,
  "additionalData": string
}
フィールド
previousDpc

string

出力専用。このデバイスが別の DPC から移行された場合は、そのパッケージ名です。それ以外の場合は入力されません。
additionalData

string

出力専用。このデバイスが別の DPC から移行された場合、移行トークンの additionalData フィールドがここに入力されます。

メソッド

delete

 デバイスを削除します。

get

 デバイスを取得します。

issueCommand

 デバイスにコマンドを送信します。

list

 特定の企業のデバイスを一覧表示します。

patch

 デバイスを更新します。