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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

デバイスが最後にステータス レポートを送信した時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

サポート終了。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

デバイスが最後にポリシーを取得した時刻。

RFC3339 UTC「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

同じ物理デバイスが複数回登録されている場合、このフィールドには以前のデバイス名が含まれます。シリアル番号は、同じ物理デバイスが以前に登録されたかどうかを判断するための一意の識別子として使用されます。名前は時系列で表示されます。

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)

コモン クライテリア モードに関する情報。Common Criteria for Information Technology Security Evaluation（CC）で定義されているセキュリティ基準です。

この情報は、デバイスが会社所有デバイスであるデバイス ポリシーで statusReportingSettings.commonCriteriaModeEnabled が true になっている場合にのみ利用できます。

object (PasswordRequirements)

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

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

object (DpcMigrationInfo)

出力専用。このデバイスが、別の Device Policy Controller（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

ネストされたフィールドがある設定では、特定のネストされたフィールドがポリシーに準拠していない場合に、不適切なフィールドへのフルパスを指定します。パスの形式は、ポリシーの JSON フィールドが JavaScript で参照されるのと同じ形式です。つまり、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 UTC「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)

アップデートが最初に利用可能になった時刻。値 0 は、このフィールドが設定されていないことを示します。このフィールドは、更新が利用可能な場合（つまり、updateStatus が UPDATE_STATUS_UNKNOWN でも UP_TO_DATE でもない）にのみ設定されます。

RFC3339 UTC「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

1 インチあたりのドット数で表される表示密度。

{
  "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 ハッシュです。アプリが変更されていないことを確認できます。ハッシュ値の各バイトは、2 桁の 16 進数で表されます。

string

アプリ パッケージに関連付けられている各 android.content.pm.Signature の SHA-1 ハッシュです。各ハッシュ値の各バイトは、2 桁の 16 進数で表されます。

string

このアプリをインストールしたアプリのパッケージ名。

enum (ApplicationSource)

パッケージのソース。

enum (ApplicationState)

アプリケーションの状態。

object (KeyedAppState)

アプリによってレポートされた、キー付きアプリの状態のリスト。

enum (UserFacingType)

アプリがユーザー向けかどうか。

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

enum (ApplicationEventType)

アプリイベントタイプ。

string (Timestamp format)

イベントの作成時刻。

RFC3339 UTC「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 コンソールでクエリ対象として選択できる値を設定します（「バッテリー警告データが 10 未満の場合はお知らせください」など）。

string (Timestamp format)

デバイス上のアプリの状態の作成時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

アプリの状態が最後に更新された時刻。

RFC3339 UTC「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 UTC「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 UTC「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 UTC「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 フィールドに値が入力されます。