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)

デバイスの登録日時。

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

string (Timestamp format)

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

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

string (Timestamp format)

廃止されました。

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

string (Timestamp format)

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

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

コモン クライテリア モード（Common Criteria for Information Technology Security Evaluation（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 への移行の準備をしています。移行を続行するために、これ以上の対応は必要ありません。

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

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

ビルド時間。

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

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

DisplayState

ディスプレイの状態。

列挙型
DISPLAY_STATE_UNSPECIFIED この値は使用できません。
OFF ディスプレイがオフになっています。
ON ディスプレイは 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)

イベントの作成時刻。

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

string (Timestamp format)

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

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 がデバイスで実行されていることを検出しました（basicIntegrity チェックは成功しますが、ctsProfileMatch は失敗します）。
COMPROMISED_OS Play Integrity API は、デバイスが不正使用された OS を実行していることを検出します（basicIntegrity チェックが失敗します）。
HARDWARE_BACKED_EVALUATION_FAILED デバイスの完全性フィールドに MEETS_STRONG_INTEGRITY ラベルが表示されない場合、Play Integrity API は、デバイスのシステム完全性が強く保証されていないことを検出します。

CommonCriteriaModeInfo

コモン クライテリア モード（Common Criteria for Information Technology Security Evaluation（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

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

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

string

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

string

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

Methods

delete

 デバイスを削除します。

get

 デバイスを取得します。

issueCommand

 デバイスにコマンドを発行します。

list

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

patch

 デバイスを更新します。