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 を呼び出す場合、ACTIVEDISABLED のみが許容値となります。デバイスを 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 が適用されます。このフィールドは、パッチ リクエストで変更できます。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 モードに関する情報 - 情報技術セキュリティ評価のための Common Criteria(CC)で定義されているセキュリティ標準。

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

appliedPasswordPolicies[]

object (PasswordRequirements)

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

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

object (DpcMigrationInfo)

出力専用。このデバイスが別のデバイス ポリシー コントローラ(DPC)による管理から移行されたかどうかに関する情報。

DeviceState

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

列挙型
DEVICE_STATE_UNSPECIFIED この値は許可されません。
ACTIVE デバイスが有効である。
DISABLED デバイスが無効になっている。
DELETED デバイスが削除されました。この状態は API 呼び出しで返されることはありませんが、デバイスが削除を承認したときに最終ステータス レポートで使用されます。API 呼び出しでデバイスが削除されると、この状態が Pub/Sub に公開されます。ユーザーが仕事用プロファイルを削除するか、デバイスをリセットすると、デバイスの状態はサーバーに認識されなくなります。
PROVISIONING デバイスのプロビジョニング中です。新しく登録されたデバイスは、ポリシーが適用されるまでこの状態になります。
LOST デバイスを紛失した。この状態は、組織所有のデバイスでのみ可能です。
PREPARING_FOR_MIGRATION デバイスは Android Management API への移行の準備中です。移行を続行するために必要な対応は特にありません。
DEACTIVATED_BY_DEVICE_FINANCE これは、金融機関によって「ロック」されたローン購入デバイスです。つまり、デバイスの機能が制限されるポリシー設定が適用されており、デバイスが金融機関によって「ロック解除」されるまで制限が続きます。デバイスには、ファイナンス エージェントによってオーバーライドされた設定を除くポリシー設定が引き続き適用されます。デバイスが「ロック」されている場合、状態は appliedStateDEACTIVATED_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 アプリが Google 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 に設定されている。
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK ユーザーが設定済みの Wi-Fi ネットワークを手動で削除する必要があります。これは、個人所有デバイスの仕事用プロファイルでのみ適用されます。nonComplianceReasonUSER_ACTION に設定されている。
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY openNetworkConfigurationClientCertKeyPairAlias フィールドで指定された鍵ペアのエイリアスが、デバイスにインストールされている既存の鍵に対応していません。nonComplianceReasonINVALID_VALUE に設定されている。
PERMISSIBLE_USAGE_RESTRICTION このポリシー設定は制限されており、この Google Cloud Platform プロジェクトに設定することはできません。詳細(このポリシー設定を有効にする方法など)については、許容される使用に関するポリシーをご覧ください。nonComplianceReasonPROJECT_NOT_PERMITTED に設定されている。
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE workAccountSetupConfig ポリシー設定で必須の仕事用アカウントが、企業の一部ではなくなりました。nonComplianceReasonUSER_ACTION に設定されている。
NEW_ACCOUNT_NOT_IN_ENTERPRISE ユーザーが追加した仕事用アカウントが企業の一部ではない。nonComplianceReasonUSER_ACTION に設定されている。

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)

ビルド時間。

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 の場合は、このフィールドが設定されていないことを示します。このフィールドは、更新が利用可能な場合(つまり、updateStatusUPDATE_STATUS_UNKNOWN でも UP_TO_DATE でもない場合)にのみ設定されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

UpdateStatus

アップデートのステータス(アップデートが存在するかどうか、存在する場合はそのタイプ)。

列挙型
UPDATE_STATUS_UNKNOWN 保留中のシステム アップデートがあるかどうかは不明です。たとえば、デバイスの API レベルが 26 未満の場合や、Android デバイス ポリシーのバージョンが古い場合に発生します。
UP_TO_DATE デバイスで保留中のシステム アップデートはありません。
UNKNOWN_UPDATE_AVAILABLE 保留中のシステム アップデートが利用可能ですが、そのタイプは不明です。
SECURITY_UPDATE_AVAILABLE 保留中のセキュリティ アップデートがあります。
OS_UPDATE_AVAILABLE 保留中の OS アップデートがあります。

HardwareInfo

デバイスのハードウェアに関する情報。温度しきい値に関連するフィールドは、デバイスのポリシーで hardwareStatusEnabled が true の場合にのみ使用できます。

JSON 表現
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
フィールド
brand

string

デバイスのブランド。例: Google

hardware

string

ハードウェアの名前。例: Angler

deviceBasebandVersion

string

ベースバンド バージョン。例: MDM9625_104662.22.05.34p

manufacturer

string

メーカー。例: Motorola

serialNumber

string

デバイスのシリアル番号。

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 以降を搭載したデバイスで仕事用プロファイルが設定されている個人所有デバイスで利用できます。

euiccChipInfo[]

object (EuiccChipInfo)

出力専用。eUICC チップに関連する情報。

EuiccChipInfo

eUICC チップに関連する情報。

JSON 表現
{
  "eid": string
}
フィールド
eid

string

出力専用。デバイス上の各 eUICC チップの eUICC チップを識別する埋め込み識別番号(EID)。この機能は、Android 13 以降を搭載した会社所有のデバイスでご利用いただけます。

ディスプレイ

デバイスのディスプレイ情報。

JSON 表現
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
フィールド
name

string

ディスプレイの名前。

displayId

integer

一意のディスプレイ ID。

refreshRate

integer

ディスプレイのリフレッシュ レート(フレーム / 秒)。

state

enum (DisplayState)

ディスプレイの状態。

width

integer

表示幅(ピクセル単位)。

height

integer

ピクセル単位の表示高さ。

density

integer

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

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,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
フィールド
phoneNumber

string

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

carrierName

string

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

iccId

string

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

activationState

enum (ActivationState)

出力専用。デバイスの SIM カードの有効化状態。これは eSIM のみに適用されます。この機能は、API レベル 35 以降のすべてのデバイスでサポートされています。API レベル 35 未満のデバイスと物理 SIM の場合は、常に ACTIVATION_STATE_UNSPECIFIED です。

configMode

enum (ConfigMode)

出力専用。デバイスの SIM カードの構成モード。これは eSIM のみに適用されます。この機能は、API レベル 35 以降のすべてのデバイスでサポートされています。API レベル 35 未満のデバイスと物理 SIM の場合は、常に CONFIG_MODE_UNSPECIFIED です。

ActivationState

デバイスの SIM カードの有効化状態。

列挙型
ACTIVATION_STATE_UNSPECIFIED アクティベーション状態が指定されていません。
ACTIVATED SIM カードが有効になっている。
NOT_ACTIVATED SIM カードが有効になっていない。

ConfigMode

デバイスの SIM カードの構成モード。

列挙型
CONFIG_MODE_UNSPECIFIED 構成モードが指定されていません。
ADMIN_CONFIGURED 管理者がこの SIM を設定しています。
USER_CONFIGURED ユーザーがこの SIM を設定しています。

MemoryInfo

デバイスのメモリとストレージに関する情報。

JSON 表現
{
  "totalRam": string,
  "totalInternalStorage": string
}
フィールド
totalRam

string (int64 format)

デバイスの合計 RAM(バイト単位)。

totalInternalStorage

string (int64 format)

デバイスの内部ストレージの合計(バイト単位)。

MemoryEvent

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

新しいイベントと古いイベントを区別するには、createTime フィールドを使用することをおすすめします。

JSON 表現
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
フィールド
eventType

enum (MemoryEventType)

イベントの種類です。

createTime

string (Timestamp format)

イベントの作成時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

byteCount

string (int64 format)

メディアの空き容量(バイト数)。EXTERNAL_STORAGE_DETECTED の場合は、ストレージ メディアの合計容量(バイト数)。

MemoryEventType

イベントタイプ。

列挙型
MEMORY_EVENT_TYPE_UNSPECIFIED 指定なし。このタイプのイベントはありません。
RAM_MEASURED RAM の空き容量が測定されました。
INTERNAL_STORAGE_MEASURED 内部ストレージの空き容量が測定されました。
EXTERNAL_STORAGE_DETECTED 新しい外部ストレージ メディアが検出されました。報告されるバイト数は、ストレージ メディアの合計容量です。
EXTERNAL_STORAGE_REMOVED 外部ストレージ メディアが取り外されました。報告されたバイト数が 0 である。
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

Common Criteria モードに関する情報 - 情報技術セキュリティ評価のための Common Criteria(CC)で定義されているセキュリティ標準。

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

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

enum (CommonCriteriaModeStatus)

コモン クライテリア モードが有効かどうか。

policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

出力専用。ポリシー署名検証のステータス。

CommonCriteriaModeStatus

コモン クライテリア モードが有効かどうか。

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

PolicySignatureVerificationStatus

ポリシー署名検証のステータス。

列挙型
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED 指定なし。確認ステータスが報告されていません。これは、statusReportingSettings.commonCriteriaModeEnabled が false の場合にのみ設定されます。
POLICY_SIGNATURE_VERIFICATION_DISABLED commonCriteriaMode が false に設定されているため、デバイスでポリシー署名の検証が無効になっています。
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED ポリシーの署名の検証に成功しました。
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED ポリシー署名の検証がサポートされていない(デバイスがポリシー署名の検証をサポートしていない CloudDPC バージョンで登録されているなど)。
POLICY_SIGNATURE_VERIFICATION_FAILED ポリシーの署名検証に失敗しました。ポリシーは適用されていません。

DpcMigrationInfo

このデバイスが別のデバイス ポリシー コントローラ(DPC)による管理から移行されたかどうかに関する情報。

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

string

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

additionalData

string

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

メソッド

delete

デバイスを削除します。

get

デバイスを取得します。

issueCommand

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

list

指定された企業に属するデバイスを一覧表示します。

patch

デバイスを更新します。