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)
    }
  ]
}
フィールド
name

string

デバイスの名前(enterprises/{enterpriseId}/devices/{deviceId} の形式)。

userName

string

このデバイスを所有しているユーザーのリソース名。形式は enterprises/{enterpriseId}/users/{userId} です。

managementMode

enum (ManagementMode)

Android Device Policy がデバイスで適用する管理モードの種類。これは、どのポリシー設定を使用できるかに影響します。

state

enum (DeviceState)

デバイスに適用される状態。このフィールドは、パッチ リクエストで変更できます。enterprises.devices.patch を呼び出す場合、指定できる値は ACTIVEDISABLED のみです。デバイスを 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 が適用されます。このフィールドは、パッチ リクエストで変更できます。policyId にスラッシュを含めない限り、enterprises.devices.patch を呼び出すときにのみ policyId を指定できます。ポリシー名の残りの部分は推測されます。

appliedPolicyName

string

デバイスに現在適用されているポリシーの名前。

appliedPolicyVersion

string (int64 format)

デバイスに現在適用されているポリシーのバージョン。

apiLevel

integer

デバイスで実行されている Android プラットフォーム バージョンの API レベル。

enrollmentTokenData

string

追加データが提供された登録トークンでデバイスが登録されている場合、このフィールドにはそのデータが表示されます。

enrollmentTokenName

string

デバイスが登録トークンで登録されている場合、このフィールドにはトークンの名前が含まれます。

disabledReason

object (UserFacingMessage)

デバイスの状態が DISABLED の場合、デバイスが無効になっている理由を示すオプション メッセージがデバイスに表示されます。このフィールドは、パッチ リクエストで変更できます。

softwareInfo

object (SoftwareInfo)

デバイスのソフトウェアに関する詳細情報。この情報は、デバイスのポリシーで softwareInfoEnabled が 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.commonCriteriaModeEnabledtrue に設定されている場合にのみ利用できます。

appliedPasswordPolicies[]

object (PasswordRequirements)

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

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

DeviceState

デバイスに適用できる状態。

列挙型
DEVICE_STATE_UNSPECIFIED この値は許可されていません。
ACTIVE デバイスは有効です。
DISABLED デバイスが無効になっている。
DELETED デバイスが削除されました。この状態は API 呼び出しでは返されませんが、デバイスが削除を確認応答したときに最終ステータス レポートで使用されます。API 呼び出しによってデバイスが削除されると、この状態は Pub/Sub に公開されます。ユーザーが仕事用プロファイルを削除したりデバイスをリセットしたりしても、デバイスの状態はサーバーに保持されません。
PROVISIONING デバイスをプロビジョニングしています。新しく登録されたデバイスは、ポリシーが適用されるまでこの状態になります。
LOST デバイスを紛失したこの状態は、組織所有のデバイスでのみ可能です。

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 のフィールドが設定されていません。nonComplianceReasonUSER_ACTION に設定されている。
PASSWORD_POLICIES_PASSWORD_EXPIRED デバイスまたはプロファイルのパスワードの有効期限が切れています。passwordPoliciesContext が設定されました。nonComplianceReasonUSER_ACTION に設定されている。
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT デバイスのパスワードがパスワード要件を満たしていません。passwordPoliciesContext が設定されました。nonComplianceReasonUSER_ACTION に設定されている。
ONC_WIFI_INVALID_VALUE ONC の Wi-Fi 設定に正しくない値があります。fieldPath は、不正確なフィールド値を指定します。oncWifiContext が設定されました。nonComplianceReasonINVALID_VALUE に設定されている。
ONC_WIFI_API_LEVEL ONC の Wi-Fi 設定は、デバイスに搭載されている Android バージョンの API レベルではサポートされていません。fieldPath には、サポートされていないフィールド値を指定します。oncWifiContext が設定されました。nonComplianceReasonAPI_LEVEL に設定されている。
ONC_WIFI_INVALID_ENTERPRISE_CONFIG エンタープライズ Wi-Fi ネットワークに、ルート CA またはドメイン名のいずれかが指定されていません。nonComplianceReasonINVALID_VALUE に設定されている。

SpecificNonComplianceContext

SpecificNonComplianceReason の追加コンテキスト。

JSON 表現
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
フィールド
oncWifiContext

object (OncWifiContext)

Wi-Fi の設定に関連した違反がある場合の追加のコンテキスト。ONC_WIFI_INVALID_VALUEONC_WIFI_API_LEVEL を表示

passwordPoliciesContext

object (PasswordPoliciesContext)

パスワード ポリシーに関連する違反に関するその他のコンテキスト。PASSWORD_POLICIES_PASSWORD_EXPIREDPASSWORD_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)

アップデートが初めて利用可能になった時刻です。ゼロの値は、このフィールドが設定されていないことを示します。このフィールドは、利用可能なアップデートがある場合にのみ設定されます(つまり、updateStatusUPDATE_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 ディスプレイは 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)

イベントの作成時間。

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

メモリとストレージの測定に関連するイベント。

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 SafetyNet が、デバイスが不明な OS を実行していることを検出します(basicIntegrity チェックは成功しますが、ctsProfileMatch は失敗します)。
COMPROMISED_OS SafetyNet は、デバイスで侵害された OS が実行されていることを検出します(基本的な整合性チェックが失敗する)。
HARDWARE_BACKED_EVALUATION_FAILED SafetyNet は、デバイスにハードウェア格納型キーストアなど、システム完全性の強力な保証がないデバイスを検出します。

CommonCriteriaModeInfo

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

この情報は、デバイスのポリシーで statusReportingSettings.commonCriteriaModeEnabledtrue に設定されている場合にのみ使用できます。

JSON 表現
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
フィールド
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

コモン クライテリア モードを有効にするかどうか。

CommonCriteriaModeStatus

コモン クライテリア モードを有効にするかどうか。

列挙型
COMMON_CRITERIA_MODE_STATUS_UNKNOWN 不明なステータスです。
COMMON_CRITERIA_MODE_DISABLED コモン クライテリア モードは現在無効になっています。
COMMON_CRITERIA_MODE_ENABLED 現在、コモン クライテリア モードが有効になっています。

Methods

delete

デバイスを削除します。

get

デバイスを取得します。

issueCommand

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

list

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

patch

デバイスを更新します。