MCP Tools Reference: Android Device Management MCP Server

ツール: list_devices

指定された企業に属するデバイスを一覧表示します。親フィールドにエンタープライズ ID が必要です（例: enterprises/{enterpriseId}）。

次のサンプルは、curl を使用して list_devices MCP ツールを呼び出す方法を示しています。

Curl リクエスト 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

指定された企業に属するデバイスのリストをリクエストします。

ListDevicesRequest

JSON 表現 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
フィールド
parent

string

企業名（enterprises/{enterpriseId} 形式）。
pageSize

integer

リクエストされたページサイズ。指定されていない場合は、最大で 10 台のデバイスが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます。上限は時間の経過とともに変更されることがあります。
pageToken

string

サーバーから返される結果のページを特定するトークン。

出力スキーマ

特定の企業に属するデバイスのリストをリクエストしたことに対するレスポンス。

ListDevicesResponse

JSON 表現 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
フィールド
devices[]

object (Device)

デバイスのリスト。
nextPageToken

string

結果がさらにある場合は、結果の次のページを取得するためのトークン。

デバイス

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
フィールド
name

string

デバイスの名前（enterprises/{enterpriseId}/devices/{deviceId} 形式）。
userName

string

このデバイスを所有するユーザーのリソース名（enterprises/{enterpriseId}/users/{userId} 形式）。
managementMode

enum (ManagementMode)

Android Device Policy がデバイスで採用する管理モードの種類。これにより、サポートされるポリシー設定が決まります。
state

enum (DeviceState)

デバイスに適用する状態。このフィールドは、パッチ リクエストで変更できます。enterprises.devices.patch を呼び出す場合、ACTIVE と DISABLED のみが許容値となります。デバイスを DELETED 状態にするには、enterprises.devices.delete を呼び出します。
appliedState

enum (DeviceState)

現在デバイスに適用されている状態。
policyCompliant

boolean

デバイスがポリシーに準拠しているかどうか。
nonComplianceDetails[]

object (NonComplianceDetail)

デバイスが準拠していないポリシー設定の詳細。
enrollmentTime

string (Timestamp format)

デバイスの登録日時。

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

string (Timestamp format)

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

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

string (Timestamp format)

サポート終了。

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

string (Timestamp format)

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

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

string

デバイスに適用されるポリシーの名前（enterprises/{enterpriseId}/policies/{policyId} 形式）。指定しない場合、デバイスのユーザーの policy_name が適用されます。このフィールドは、パッチ リクエストで変更できます。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)

デバイスにインストールされているアプリのレポート。この情報は、デバイスのポリシーで application_reports_enabled が true の場合にのみ使用できます。
previousDeviceNames[]

string

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

object (NetworkInfo)

デバイスのネットワーク情報。この情報は、デバイスのポリシーで networkInfoEnabled が true に設定されている場合にのみ利用できます。
memoryInfo

object (MemoryInfo)

メモリ情報: デバイスのメモリとストレージに関する情報が含まれます。
memoryEvents[]

object (MemoryEvent)

メモリとストレージの測定に関連するイベントを時系列で表示します。この情報は、デバイスのポリシーで memoryInfoEnabled が true に設定されている場合にのみ利用できます。

イベントは一定期間保持され、古いイベントは削除されます。
powerManagementEvents[]

object (PowerManagementEvent)

デバイスの電源管理イベントが時系列順に表示されます。この情報は、デバイスのポリシーで powerManagementEventsEnabled が true に設定されている場合にのみ利用できます。
hardwareStatusSamples[]

object (HardwareStatus)

ハードウェア ステータスのサンプルを時系列順に示します。この情報は、デバイスのポリシーで hardwareStatusEnabled が true に設定されている場合にのみ利用できます。
deviceSettings

object (DeviceSettings)

デバイスの設定情報。この情報は、デバイスのポリシーで deviceSettingsEnabled が true に設定されている場合にのみ利用できます。
user

object (User)

デバイスの所有者。
systemProperties

map (key: string, value: string)

デバイスに関連する選択されたシステム プロパティの名前と値のマップ。この情報は、デバイスのポリシーで systemPropertiesEnabled が true に設定されている場合にのみ利用できます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
securityPosture

object (SecurityPosture)

デバイスのセキュリティのレベルを反映するデバイスのセキュリティ ポスチャー値。
ownership

enum (Ownership)

管理対象デバイスの所有権。
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

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

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

object (PasswordRequirements)

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

  • このフィールドが存在するのは、適用される要件が passwordPolicies で指定された要件と若干異なる場合があるためです。
  • このフィールドには、パスワードのコンプライアンスに関する情報は表示されません。コンプライアンス違反の情報については、nonComplianceDetails をご覧ください。
  • NonComplianceDetail.fieldPath は、このフィールドではなく passwordPolicies に基づいて設定されます。
dpcMigrationInfo

object (DpcMigrationInfo)

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

object (DefaultApplicationInfo)

出力専用。DefaultApplicationType のデフォルトのアプリケーション情報。この情報は、デバイスのポリシーで defaultApplicationInfoReportingEnabled が true に設定されている場合にのみ利用できます。Android 16 以降で利用できます。

すべてのアプリタイプがフルマネージド デバイスで報告されます。DEFAULT_BROWSER、DEFAULT_CALL_REDIRECTION、DEFAULT_CALL_SCREENING、DEFAULT_DIALER のタイプは、仕事用プロファイルが設定された会社所有デバイスと個人所有デバイスの仕事用プロファイルについて報告されます。DEFAULT_WALLET は、仕事用プロファイルが設定された会社所有デバイスでもレポートされますが、仕事用プロファイルの情報のみが含まれます。

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)

package_name が設定され、非準拠の理由が APP_NOT_INSTALLED または APP_NOT_UPDATED の場合、アプリをインストールまたは更新できない理由の詳細。
specificNonComplianceReason

enum (SpecificNonComplianceReason)

デバイスが設定に準拠していないポリシー固有の理由。
specificNonComplianceContext

object (SpecificNonComplianceContext)

specific_non_compliance_reason の追加コンテキスト。

値

JSON 表現 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。値の種類。kind は次のいずれかになります。
nullValue

null

null 値を表します。
numberValue

number

double 値を表します。
stringValue

string

文字列値を表します。
boolValue

boolean

ブール値を表します。
structValue

object (Struct format)

構造化された値を表します。
listValue

array (ListValue format)

Value の繰り返しを表します。

構造体

JSON 表現 
{
  "fields": {
    string: value,
    ...
  }
}
フィールド
fields

map (key: string, value: value (Value format))

動的に型指定される値の順序なしのマップ。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

JSON 表現 
{
  "key": string,
  "value": value
}
フィールド
key

string
value

value (Value format)

ListValue

JSON 表現 
{
  "values": [
    value
  ]
}
フィールド
values[]

value (Value format)

動的に型指定される値の繰り返しフィールド。

SpecificNonComplianceContext

JSON 表現 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
フィールド
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 をご覧ください。
defaultApplicationContext

object (DefaultApplicationContext)

出力専用。デフォルト アプリケーション設定に関連する不遵守に関する追加のコンテキスト。DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE をご覧ください。

OncWifiContext

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

string

準拠していない Wi-Fi 構成の GUID。

PasswordPoliciesContext

JSON 表現 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
フィールド
passwordPolicyScope

enum (PasswordPolicyScope)

準拠していないパスワードの範囲。

DefaultApplicationContext

JSON 表現 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
フィールド
defaultApplicationScope

enum (DefaultApplicationScope)

出力専用。準拠していないデフォルト アプリケーション設定の範囲。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

UserFacingMessage

JSON 表現 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
フィールド
localizedMessages

map (key: string, value: string)

<locale, message> ペアを含むマップ。locale は、en-US、es-ES、fr などの整形式の BCP 47 言語コードです。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultMessage

string

ローカライズされたメッセージが指定されていない場合、またはユーザーのロケールがローカライズされたメッセージのいずれとも一致しない場合に表示されるデフォルトのメッセージ。ローカライズされたメッセージが指定されている場合は、デフォルトのメッセージを指定する必要があります。

LocalizedMessagesEntry

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string
value

string

SoftwareInfo

JSON 表現 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
フィールド
androidVersion

string

ユーザーに表示される Android バージョン文字列。例: 6.0.1
androidDevicePolicyVersionCode

integer

Android Device Policy アプリのバージョン コード。
androidDevicePolicyVersionName

string

ユーザーに表示される Android Device Policy アプリのバージョン。
androidBuildNumber

string

ユーザーに表示するための Android ビルド ID 文字列。例: shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys
deviceKernelVersion

string

カーネル バージョン（例: 2.6.32.9-g103d848）。
bootloaderVersion

string

システム ブートローダーのバージョン番号（0.6.7 など）。
androidBuildTime

string (Timestamp format)

ビルド時間。

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

string

セキュリティ パッチレベル（2016-05-01 など）。
primaryLanguageCode

string

デバイスのプライマリ ロケールの IETF BCP 47 言語コード。
deviceBuildSignature

string

システム パッケージに関連付けられた android.content.pm.Signature の SHA-256 ハッシュ。システム ビルドが変更されていないことを確認するために使用できます。
systemUpdateInfo

object (SystemUpdateInfo)

保留中のシステム アップデートの可能性に関する情報。

SystemUpdateInfo

JSON 表現 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
フィールド
updateStatus

enum (UpdateStatus)

アップデートのステータス（アップデートが存在するかどうか、アップデートのタイプなど）。
updateReceivedTime

string (Timestamp format)

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

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

HardwareInfo

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

デバイスのシリアル番号。ただし、Android 12 以降を搭載した個人所有デバイスでは、これは enterpriseSpecificId と同じです。
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

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 インチあたりのドット数で表される表示密度。

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"。

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"。

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

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 です。

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)

イベントの作成時刻。

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 の場合は、ストレージ メディアの合計容量（バイト単位）。

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 イベントの場合、バッテリー残量をパーセンテージで表します。

HardwareStatus

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 プロテクトの確認が強制されているかどうか。

ユーザー

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

string

このユーザー用に作成する一意の識別子（user342 や asset#44418 など）。このフィールドはユーザーの作成時に設定する必要があり、更新することはできません。このフィールドに個人を特定できる情報（PII）を含めることはできません。この識別子は 1, 024 文字以下にする必要があります。これを超えると、更新ポリシー リクエストは失敗します。

SystemPropertiesEntry

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string
value

string

SecurityPosture

JSON 表現 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
フィールド
devicePosture

enum (DevicePosture)

デバイスのセキュリティ ポスチャーの値。
postureDetails[]

object (PostureDetail)

デバイスのセキュリティ ポスチャーに関する追加の詳細。

PostureDetail

JSON 表現 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
フィールド
securityRisk

enum (SecurityRisk)

デバイスのセキュリティ体制に悪影響を及ぼす特定のセキュリティ リスク。
advice[]

object (UserFacingMessage)

このセキュリティ リスクを軽減し、デバイスのセキュリティ ポスチャーを改善するための管理者向けの対応策。

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

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

enum (PolicySignatureVerificationStatus)

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

PasswordRequirements

JSON 表現 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
フィールド
passwordMinimumLength

integer

パスワードの最小許容文字数。値 0 は、制限がないことを意味します。password_quality が NUMERIC、NUMERIC_COMPLEX、ALPHABETIC、ALPHANUMERIC、COMPLEX の場合にのみ適用されます。
passwordMinimumLetters

integer

パスワードに最低限必要な英文字の文字数。password_quality が COMPLEX の場合にのみ適用されます。
passwordMinimumLowerCase

integer

パスワードに最低限必要な小文字の文字数。password_quality が COMPLEX の場合にのみ適用されます。
passwordMinimumNonLetter

integer

パスワードに最低限必要な英文字以外の文字数（数字または記号）。password_quality が COMPLEX の場合にのみ適用されます。
passwordMinimumNumeric

integer

パスワードに最低限必要な数字の文字数。password_quality が COMPLEX の場合にのみ適用されます。
passwordMinimumSymbols

integer

パスワードに最低限必要な記号の数。password_quality が COMPLEX の場合にのみ適用されます。
passwordMinimumUpperCase

integer

パスワードに最低限必要な大文字の文字数。password_quality が COMPLEX の場合にのみ適用されます。
passwordQuality

enum (PasswordQuality)

必要なパスワードの品質。
passwordHistoryLength

integer

パスワードの履歴の長さ。このフィールドを設定すると、ユーザーは履歴にあるパスワードと同じ新しいパスワードを入力できなくなります。値 0 は制限がないことを意味します。
maximumFailedPasswordsForWipe

integer

デバイスがワイプされるまでに間違ったデバイスのロック解除パスワードを入力できる回数。値 0 は制限がないことを意味します。
passwordExpirationTimeout

string (Duration format)

パスワードの有効期限。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
passwordScope

enum (PasswordPolicyScope)

パスワード要件が適用されるスコープ。
requirePasswordUnlock

enum (RequirePasswordUnlock)

デバイスまたは仕事用プロファイルが強力な認証方法（パスワード、PIN、パターン）を使用してロック解除された後、他の認証方法（指紋、信頼できるエージェント、顔など）を使用してロック解除できるまでの時間。指定した時間が経過すると、デバイスまたは仕事用プロファイルのロックを解除するには、厳格な認証方法のみを使用できます。
unifiedLockSettings

enum (UnifiedLockSettings)

仕事用プロファイルが設定された Android 9 以降を搭載するデバイスで、デバイスと仕事用プロファイルに統合ロックを許可するかどうかを制御します。これは、password_scope が SCOPE_PROFILE に設定されている場合にのみ設定できます。それ以外の場合、ポリシーは拒否されます。ユーザーが仕事用のロックを別に設定しておらず、このフィールドが REQUIRE_SEPARATE_WORK_LOCK に設定されている場合、NonComplianceDetail が報告され、nonComplianceReason が USER_ACTION に設定されます。

所要時間

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

期間の符号付き秒数。-315,576,000,000 ～+315,576,000,000 の範囲（両端を含む）にする必要があります。注: これらの境界は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。
nanos

integer

期間のナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の seconds フィールドと正または負の nanos フィールドで表されます。1 秒以上の期間の場合、nanos フィールドのゼロ以外の値は、seconds フィールドと同じ符号である必要があります。-999,999,999～+999,999,999 の範囲内（境界含む）である必要があります。

DpcMigrationInfo

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

string

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

string

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

DefaultApplicationInfo

JSON 表現 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
フィールド
defaultApplicationType

enum (DefaultApplicationType)

出力専用。デフォルトのアプリケーション タイプ。
packageName

string

出力専用。現在のデフォルト アプリケーションのパッケージ名。
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

出力専用。デフォルトのアプリ設定の試行に関する詳細（defaultApplications に記載されている順序と同じ）。

DefaultApplicationSettingAttempt

JSON 表現 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
フィールド
packageName

string

出力専用。試行されたアプリケーションのパッケージ名。
attemptOutcome

enum (AttemptOutcome)

出力専用。アプリをデフォルトに設定した結果。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌