MCP Tools Reference: Android Device Management MCP Server

ツール: get_policy

指定された企業とポリシー ID のポリシーを取得します。リソース名は enterprises/{enterpriseId}/policies/{policyId} の形式で指定する必要があります。

次のサンプルは、curl を使用して get_policy 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": "get_policy",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

入力スキーマ

ポリシーを取得するリクエスト。

GetPolicyRequest

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

string

ポリシーの名前(enterprises/{enterpriseId}/policies/{policyId} 形式)。

出力スキーマ

ポリシー リソースは、管理対象デバイスとそれにインストールされているアプリの動作を制御する設定のグループを表します。

ポリシー

JSON 表現
{
  "name": string,
  "version": string,
  "applications": [
    {
      object (ApplicationPolicy)
    }
  ],
  "maximumTimeToLock": string,
  "screenCaptureDisabled": boolean,
  "cameraDisabled": boolean,
  "keyguardDisabledFeatures": [
    enum (KeyguardDisabledFeature)
  ],
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "persistentPreferredActivities": [
    {
      object (PersistentPreferredActivity)
    }
  ],
  "openNetworkConfiguration": {
    object
  },
  "systemUpdate": {
    object (SystemUpdate)
  },
  "accountTypesWithManagementDisabled": [
    string
  ],
  "addUserDisabled": boolean,
  "adjustVolumeDisabled": boolean,
  "factoryResetDisabled": boolean,
  "installAppsDisabled": boolean,
  "mountPhysicalMediaDisabled": boolean,
  "modifyAccountsDisabled": boolean,
  "safeBootDisabled": boolean,
  "uninstallAppsDisabled": boolean,
  "statusBarDisabled": boolean,
  "keyguardDisabled": boolean,
  "minimumApiLevel": integer,
  "statusReportingSettings": {
    object (StatusReportingSettings)
  },
  "bluetoothContactSharingDisabled": boolean,
  "shortSupportMessage": {
    object (UserFacingMessage)
  },
  "longSupportMessage": {
    object (UserFacingMessage)
  },
  "passwordRequirements": {
    object (PasswordRequirements)
  },
  "wifiConfigsLockdownEnabled": boolean,
  "bluetoothConfigDisabled": boolean,
  "cellBroadcastsConfigDisabled": boolean,
  "credentialsConfigDisabled": boolean,
  "mobileNetworksConfigDisabled": boolean,
  "tetheringConfigDisabled": boolean,
  "vpnConfigDisabled": boolean,
  "wifiConfigDisabled": boolean,
  "createWindowsDisabled": boolean,
  "networkResetDisabled": boolean,
  "outgoingBeamDisabled": boolean,
  "outgoingCallsDisabled": boolean,
  "removeUserDisabled": boolean,
  "shareLocationDisabled": boolean,
  "smsDisabled": boolean,
  "unmuteMicrophoneDisabled": boolean,
  "usbFileTransferDisabled": boolean,
  "ensureVerifyAppsEnabled": boolean,
  "permittedInputMethods": {
    object (PackageNameList)
  },
  "stayOnPluggedModes": [
    enum (BatteryPluggedMode)
  ],
  "recommendedGlobalProxy": {
    object (ProxyInfo)
  },
  "setUserIconDisabled": boolean,
  "setWallpaperDisabled": boolean,
  "choosePrivateKeyRules": [
    {
      object (ChoosePrivateKeyRule)
    }
  ],
  "alwaysOnVpnPackage": {
    object (AlwaysOnVpnPackage)
  },
  "frpAdminEmails": [
    string
  ],
  "deviceOwnerLockScreenInfo": {
    object (UserFacingMessage)
  },
  "dataRoamingDisabled": boolean,
  "locationMode": enum (LocationMode),
  "networkEscapeHatchEnabled": boolean,
  "bluetoothDisabled": boolean,
  "complianceRules": [
    {
      object (ComplianceRule)
    }
  ],
  "blockApplicationsEnabled": boolean,
  "installUnknownSourcesAllowed": boolean,
  "debuggingFeaturesAllowed": boolean,
  "funDisabled": boolean,
  "autoTimeRequired": boolean,
  "permittedAccessibilityServices": {
    object (PackageNameList)
  },
  "appAutoUpdatePolicy": enum (AppAutoUpdatePolicy),
  "kioskCustomLauncherEnabled": boolean,
  "androidDevicePolicyTracks": [
    enum (AppTrack)
  ],
  "skipFirstUseHintsEnabled": boolean,
  "privateKeySelectionEnabled": boolean,
  "encryptionPolicy": enum (EncryptionPolicy),
  "usbMassStorageEnabled": boolean,
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "playStoreMode": enum (PlayStoreMode),
  "setupActions": [
    {
      object (SetupAction)
    }
  ],
  "passwordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "policyEnforcementRules": [
    {
      object (PolicyEnforcementRule)
    }
  ],
  "kioskCustomization": {
    object (KioskCustomization)
  },
  "advancedSecurityOverrides": {
    object (AdvancedSecurityOverrides)
  },
  "personalUsagePolicies": {
    object (PersonalUsagePolicies)
  },
  "autoDateAndTimeZone": enum (AutoDateAndTimeZone),
  "oncCertificateProviders": [
    {
      object (OncCertificateProvider)
    }
  ],
  "crossProfilePolicies": {
    object (CrossProfilePolicies)
  },
  "preferentialNetworkService": enum (PreferentialNetworkService),
  "usageLog": {
    object (UsageLog)
  },
  "cameraAccess": enum (CameraAccess),
  "microphoneAccess": enum (MicrophoneAccess),
  "deviceConnectivityManagement": {
    object (DeviceConnectivityManagement)
  },
  "deviceRadioState": {
    object (DeviceRadioState)
  },
  "credentialProviderPolicyDefault": enum (CredentialProviderPolicyDefault),
  "printingPolicy": enum (PrintingPolicy),
  "displaySettings": {
    object (DisplaySettings)
  },
  "assistContentPolicy": enum (AssistContentPolicy),
  "workAccountSetupConfig": {
    object (WorkAccountSetupConfig)
  },
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "enterpriseDisplayNameVisibility": enum (EnterpriseDisplayNameVisibility),
  "appFunctions": enum (AppFunctions),
  "defaultApplicationSettings": [
    {
      object (DefaultApplicationSetting)
    }
  ]
}
フィールド
name

string

ポリシーの名前(enterprises/{enterpriseId}/policies/{policyId} 形式)。

version

string (int64 format)

ポリシーのバージョン。読み取り専用のフィールドです。ポリシーが更新されるたびに、バージョンがインクリメントされます。

applications[]

object (ApplicationPolicy)

アプリに適用されたポリシー。要素は最大 3,000 個まで指定できます。

maximumTimeToLock

string (int64 format)

デバイスがロックされるまでのユーザー アクティビティの最大時間(ミリ秒単位)。値 0 は制限がないことを意味します。

screenCaptureDisabled

boolean

スクリーン キャプチャが無効になっているかどうか。

cameraDisabled
(deprecated)

boolean

camera_accessCAMERA_ACCESS_UNSPECIFIED 以外の値に設定されている場合、これは無効です。それ以外の場合、このフィールドはカメラが無効かどうかを制御します。true の場合、すべてのカメラが無効になり、それ以外の場合は使用可能になります。完全管理対象デバイスの場合、このフィールドはデバイス上のすべてのアプリに適用されます。仕事用プロファイルの場合、このフィールドは仕事用プロファイルのアプリにのみ適用され、仕事用プロファイル外のアプリのカメラ アクセスには影響しません。

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

ウィジェットなど、無効になっているキーガードのカスタマイズ。

defaultPermissionPolicy

enum (PermissionPolicy)

実行時の権限リクエストのデフォルトの権限ポリシー。

persistentPreferredActivities[]

object (PersistentPreferredActivity)

デフォルトのインテント ハンドラ アクティビティ。

openNetworkConfiguration

object (Struct format)

デバイスのネットワーク構成。詳細については、ネットワークを構成するをご覧ください。

systemUpdate

object (SystemUpdate)

システム アップデート ポリシー。OS アップデートの適用方法を制御します。更新タイプが WINDOWED の場合、更新ウィンドウは Google Play アプリの更新にも自動的に適用されます。

注: Google Play システム アップデート(Mainline アップデートとも呼ばれます)は自動的にダウンロードされますが、インストールするにはデバイスを再起動する必要があります。詳しくは、システム アップデートを管理するの Mainline セクションをご覧ください。

accountTypesWithManagementDisabled[]

string

ユーザーが管理できないアカウントの種類。

addUserDisabled

boolean

新しいユーザーとプロファイルの追加が無効になっているかどうか。managementModeDEVICE_OWNER のデバイスでは、このフィールドは無視され、ユーザーはユーザーの追加や削除を許可されません。

adjustVolumeDisabled

boolean

マスター音量の調整が無効になっているかどうか。デバイスもミュートされます。この設定は完全管理対象デバイスにのみ適用されます。

factoryResetDisabled

boolean

設定からの出荷時の設定へのリセットが無効になっているかどうか。

installAppsDisabled

boolean

ユーザーによるアプリのインストールが無効になっているかどうか。

mountPhysicalMediaDisabled

boolean

物理的な外部メディアをマウントするユーザーが無効かどうか。

modifyAccountsDisabled

boolean

アカウントの追加と削除が無効かどうか。

safeBootDisabled
(deprecated)

boolean

デバイスをセーフブートで再起動することが無効になっているかどうか。

uninstallAppsDisabled

boolean

ユーザーによるアプリのアンインストールが無効になっているかどうか。これにより、applications を使用して削除されたアプリも含め、アプリがアンインストールされなくなります。

statusBarDisabled
(deprecated)

boolean

ステータスバーが無効かどうか。これにより、全画面モードを終了できる通知、クイック設定、その他の画面オーバーレイが無効になります。非推奨。キオスク デバイスのステータスバーを無効にするには、InstallType KIOSK または kioskCustomLauncherEnabled を使用します。

keyguardDisabled

boolean

true の場合、メイン ディスプレイまたはセカンダリ ディスプレイのロック画面が無効になります。このポリシーは、専用デバイス管理モードでのみサポートされます。

minimumApiLevel

integer

許可される最小 Android API レベル。

statusReportingSettings

object (StatusReportingSettings)

ステータス レポートの設定

bluetoothContactSharingDisabled

boolean

Bluetooth 連絡先の共有が無効かどうか。

shortSupportMessage

object (UserFacingMessage)

管理者が機能を無効にしている設定画面でユーザーに表示されるメッセージ。メッセージが 200 文字を超える場合は、切り捨てられることがあります。

longSupportMessage

object (UserFacingMessage)

デバイス管理者の設定画面にユーザーに表示されるメッセージ。

passwordRequirements
(deprecated)

object (PasswordRequirements)

パスワードの要件。フィールド password_requirements.require_password_unlock は設定しないでください。非推奨 - passwordPolicies を使用します。

注:

PasswordQuality の複雑度ベースの値(COMPLEXITY_LOWCOMPLEXITY_MEDIUMCOMPLEXITY_HIGH)は使用できません。ここでは unified_lock_settings は使用できません。

wifiConfigsLockdownEnabled
(deprecated)

boolean

このバージョンはサポートが終了しています。

bluetoothConfigDisabled

boolean

Bluetooth の設定が無効かどうか。

cellBroadcastsConfigDisabled

boolean

緊急速報メールの設定が無効かどうか。

credentialsConfigDisabled

boolean

ユーザー認証情報の設定が無効になっているかどうか。

mobileNetworksConfigDisabled

boolean

モバイル ネットワークの設定が無効かどうか。

tetheringConfigDisabled
(deprecated)

boolean

テザリングとポータブル アクセス ポイントの設定が無効になっているかどうか。tetheringSettingsTETHERING_SETTINGS_UNSPECIFIED 以外に設定されている場合、この設定は無視されます。

vpnConfigDisabled

boolean

VPN の構成が無効になっているかどうか。

wifiConfigDisabled
(deprecated)

boolean

Wi-Fi ネットワークの設定が無効になっているかどうか。完全管理対象デバイスと会社所有デバイスの仕事用プロファイルでサポートされています。フルマネージド デバイスの場合、この値を true に設定すると、構成済みのすべてのネットワークが削除され、openNetworkConfiguration を使用して構成されたネットワークのみが保持されます。会社所有デバイスの仕事用プロファイルの場合、既存の設定済みネットワークは影響を受けず、ユーザーは Wi-Fi ネットワークの追加、削除、変更を行うことができません。configureWifiCONFIGURE_WIFI_UNSPECIFIED 以外に設定されている場合、この設定は無視されます。注: 起動時にネットワーク接続を確立できず、Wi-Fi の設定が無効になっている場合、デバイス ポリシーを更新するためにネットワーク エスケープ ハッチが表示されます(networkEscapeHatchEnabled を参照)。

createWindowsDisabled

boolean

アプリ ウィンドウ以外のウィンドウの作成が無効になっているかどうか。

networkResetDisabled

boolean

ネットワーク設定のリセットが無効になっているかどうか。

outgoingBeamDisabled

boolean

NFC を使用してアプリからデータをビーム送信することが無効になっているかどうか。

outgoingCallsDisabled

boolean

発信が無効になっているかどうか。

removeUserDisabled

boolean

他のユーザーの削除が無効になっているかどうか。

shareLocationDisabled

boolean

現在地の共有が無効かどうか。

smsDisabled

boolean

SMS メッセージの送受信が無効になっているかどうか。

unmuteMicrophoneDisabled
(deprecated)

boolean

microphone_accessMICROPHONE_ACCESS_UNSPECIFIED 以外の値に設定されている場合、これは無効です。それ以外の場合、このフィールドはマイクを無効にするかどうかを制御します。true の場合、すべてのマイクが無効になり、それ以外の場合は使用可能になります。この機能は完全管理対象デバイスでのみ利用できます。

usbFileTransferDisabled
(deprecated)

boolean

USB 経由のファイル転送が無効になっているかどうか。これは会社所有デバイスでのみサポートされています。

ensureVerifyAppsEnabled
(deprecated)

boolean

アプリの確認が強制的に有効になっているかどうか。

permittedInputMethods

object (PackageNameList)

存在する場合、このリストのパッケージによって提供される入力メソッドのみが許可されます。このフィールドが存在するが、リストが空の場合、システム入力メソッドのみが許可されます。

stayOnPluggedModes[]

enum (BatteryPluggedMode)

デバイスの電源がオンのままになるバッテリー接続モード。この設定を使用する場合は、デバイスがオンのときに自動的にロックされないように、maximum_time_to_lock をクリアすることをおすすめします。

recommendedGlobalProxy

object (ProxyInfo)

ネットワークに依存しないグローバル HTTP プロキシ。通常、プロキシは open_network_configuration でネットワークごとに構成する必要があります。ただし、一般的な内部フィルタリングなどの特殊な構成では、グローバル HTTP プロキシが役立つ場合があります。プロキシにアクセスできない場合、ネットワーク アクセスが中断されることがあります。グローバル プロキシは推奨にすぎず、一部のアプリでは無視される可能性があります。

setUserIconDisabled

boolean

ユーザー アイコンの変更が無効になっているかどうか。これは Android 7 以降を搭載しているデバイスにのみ適用されます。

setWallpaperDisabled

boolean

壁紙の変更が無効になっているかどうか。

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

アプリの秘密鍵へのアクセスを決定するルール。詳しくは、ChoosePrivateKeyRule をご覧ください。アプリケーションに CERT_SELECTION 委任スコープがある場合は、空にする必要があります。

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

常時接続 VPN 接続の構成。この設定の変更を防ぐには、vpn_config_disabled とともに使用します。

frpAdminEmails[]

string

出荷時設定へのリセット保護機能のデバイス管理者のメールアドレス。デバイスを出荷時の設定にリセットすると、デバイスのロックを解除するために、これらの管理者のいずれかが Google アカウントのメールアドレスとパスワードでログインする必要があります。管理者が指定されていない場合、デバイスは出荷時の設定へのリセット保護を提供しません。

deviceOwnerLockScreenInfo

object (UserFacingMessage)

ロック画面に表示するデバイス所有者の情報。

dataRoamingDisabled

boolean

ローミング データサービスが無効になっているかどうか。

locationMode

enum (LocationMode)

位置情報検出の精度が有効になっている。

networkEscapeHatchEnabled

boolean

ネットワーク エスケープ ハッチが有効かどうか。起動時にネットワーク接続を確立できない場合、エスケープ ハッチは、デバイス ポリシーを更新するために一時的にネットワークに接続するようユーザーに促します。ポリシーの適用後、一時的なネットワークは削除され、デバイスは起動を続けます。これにより、最後のポリシーに適切なネットワークがなく、デバイスがロックタスク モードのアプリで起動した場合や、ユーザーがデバイスの設定にアクセスできない場合に、ネットワークに接続できなくなることを防ぎます。

注: wifiConfigDisabled を true に設定すると、特定の状況下でこの設定がオーバーライドされます。詳しくは、wifiConfigDisabled をご覧ください。configureWifiDISALLOW_CONFIGURING_WIFI に設定すると、特定の状況下でこの設定がオーバーライドされます。詳しくは、DISALLOW_CONFIGURING_WIFI をご覧ください。

bluetoothDisabled

boolean

Bluetooth が無効かどうか。bluetooth_config_disabled はユーザーがバイパスできるため、この設定を bluetooth_config_disabled よりも優先します。

complianceRules[]
(deprecated)

object (ComplianceRule)

デバイスがポリシーに準拠していない場合に実行する緩和アクションを宣言するルール。複数のルールの条件が満たされた場合、ルールのすべての緩和アクションが実行されます。ルール数の上限は 100 です。代わりにポリシー適用ルールを使用してください。

blockApplicationsEnabled
(deprecated)

boolean

applications で設定されたアプリ以外のアプリのインストールがブロックされるかどうか。設定すると、以前のポリシーでインストールされたものの、ポリシーに表示されなくなったアプリは自動的にアンインストールされます。

installUnknownSourcesAllowed
(deprecated)

boolean

このフィールドは無視されます。

debuggingFeaturesAllowed
(deprecated)

boolean

ユーザーがデバッグ機能を有効にできるかどうか。

funDisabled

boolean

ユーザーが楽しむことを許可されているかどうか。[設定] のイースター エッグ ゲームを無効にするかどうかを制御します。

autoTimeRequired
(deprecated)

boolean

自動時刻設定が必須かどうか。必須の場合、ユーザーは日時を手動で設定できません。autoDateAndTimeZone が設定されている場合、このフィールドは無視されます。

permittedAccessibilityServices

object (PackageNameList)

許可されたユーザー補助サービスを指定します。このフィールドが設定されていない場合、任意のアシスタビリティ サービスを使用できます。このフィールドが設定されている場合、このリストのユーザー補助サービスとシステムの組み込みのユーザー補助サービスのみを使用できます。特に、このフィールドが空に設定されている場合、システムの組み込みユーザー補助サービスのみを使用できます。この設定は、完全管理対象デバイスと仕事用プロファイルで行うことができます。仕事用プロファイルに適用すると、個人用プロファイルと仕事用プロファイルの両方に影響します。

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

推奨される代替手段: アプリごとに設定される autoUpdateMode は、アップデートの頻度に関してより柔軟に対応できます。

autoUpdateModeAUTO_UPDATE_POSTPONED または AUTO_UPDATE_HIGH_PRIORITY に設定されている場合、このフィールドは無効になります。

アプリの自動更新ポリシー。アプリの自動更新を適用できるタイミングを制御します。

kioskCustomLauncherEnabled

boolean

キオスク カスタム ランチャーが有効かどうか。これにより、ホーム画面が、applications 設定でインストールされたアプリにデバイスをロックするランチャーに置き換えられます。アプリは 1 つのページにアルファベット順で表示されます。kioskCustomization を使用して、キオスク デバイスの動作をさらに構成します。

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

この設定はサポートされていません。値は無視されます。

skipFirstUseHintsEnabled

boolean

初回使用時のヒントをスキップするフラグ。企業管理者は、アプリのシステムによるおすすめを有効にして、初回起動時にユーザー チュートリアルやその他の入門ヒントをスキップできます。

privateKeySelectionEnabled

boolean

ChoosePrivateKeyRules に一致するルールがない場合に、ユーザーが非公開鍵のエイリアスを選択するための UI をデバイスに表示できるようにします。Android P より前のデバイスでは、この設定を行うと、エンタープライズ キーが脆弱になる可能性があります。いずれかのアプリに CERT_SELECTION 委任スコープがある場合、この値は無効になります。

encryptionPolicy

enum (EncryptionPolicy)

暗号化が有効かどうか

usbMassStorageEnabled
(deprecated)

boolean

USB ストレージが有効かどうか。サポート終了。

permissionGrants[]

object (PermissionGrant)

すべてのアプリに対する明示的な権限またはグループの付与または拒否。これらの値は default_permission_policy をオーバーライドします。

playStoreMode

enum (PlayStoreMode)

このモードでは、Google Play ストアでユーザーが利用できるアプリと、ポリシーからアプリが削除されたときのデバイスの動作を制御します。

setupActions[]

object (SetupAction)

セットアップ プロセス中に実行するアクション。指定できるアクションは 1 つまでです。

passwordPolicies[]

object (PasswordRequirements)

パスワード要件ポリシー。ポリシーの password_scope フィールドを設定することで、仕事用プロファイルまたは完全管理対象デバイスに異なるポリシーを設定できます。

policyEnforcementRules[]

object (PolicyEnforcementRule)

特定のポリシーをデバイスに適用できない場合の動作を定義するルール

kioskCustomization

object (KioskCustomization)

キオスクモードでのデバイスの動作を制御する設定。キオスクモードを有効にするには、kioskCustomLauncherEnabledtrue に設定するか、installType KIOSK を使用してポリシーでアプリを指定します。

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

高度なセキュリティ設定。ほとんどの場合、これらの設定は不要です。

personalUsagePolicies

object (PersonalUsagePolicies)

会社所有デバイスでの個人利用を管理するポリシー。

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

会社所有のデバイスで日付、時刻、タイムゾーンの自動設定が有効になっているかどうか。これが設定されている場合、autoTimeRequired は無視されます。

oncCertificateProviders[]

object (OncCertificateProvider)

この機能は一般提供されていません。

crossProfilePolicies

object (CrossProfilePolicies)

デバイスに適用されているクロス プロファイル ポリシー。

preferentialNetworkService

enum (PreferentialNetworkService)

仕事用プロファイルまたは完全管理対象デバイスで優先ネットワーク サービスを有効にするかどうかを制御します。たとえば、組織が携帯通信会社と契約して、従業員のデバイスから送信されるすべての仕事用データを企業専用のネットワーク サービス経由で送信するようにしている場合があります。サポートされている優先ネットワーク サービスの例としては、5G ネットワーク上のエンタープライズ スライスがあります。Android 13 以降を搭載したデバイスで preferentialNetworkServiceSettings または ApplicationPolicy.preferentialNetworkId が設定されている場合、このポリシーは無視されます。

usageLog

object (UsageLog)

デバイスのアクティビティ ロギングの構成。

cameraAccess

enum (CameraAccess)

カメラの使用と、ユーザーがカメラ アクセス切り替えにアクセスできるかどうかを制御します。

microphoneAccess

enum (MicrophoneAccess)

マイクの使用と、ユーザーがマイク アクセス切り替えにアクセスできるかどうかを制御します。これは、完全管理対象デバイスにのみ適用されます。

deviceConnectivityManagement

object (DeviceConnectivityManagement)

Wi-Fi、USB データアクセス、キーボード/マウスの接続など、デバイスの接続に関するコントロールについて説明します。

deviceRadioState

object (DeviceRadioState)

Wi-Fi や Bluetooth などの無線状態の制御を対象とします。

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Android 14 以降で認証情報プロバイダとして動作することを許可するアプリを制御します。これらのアプリは認証情報を保存します。詳しくは、こちらこちらをご覧ください。credentialProviderPolicy もご覧ください。

printingPolicy

enum (PrintingPolicy)

省略可。印刷を許可するかどうかを制御します。この機能は、Android 9 以降を搭載したデバイスで利用できます。.

displaySettings

object (DisplaySettings)

省略可。ディスプレイ設定のコントロール。

assistContentPolicy

enum (AssistContentPolicy)

省略可。AssistContent をアシスタント アプリなどの特権アプリに送信することを許可するかどうかを制御します。AssistContent には、スクリーンショットや、パッケージ名などのアプリに関する情報が含まれます。この機能は Android 15 以降でサポートされています。

workAccountSetupConfig

object (WorkAccountSetupConfig)

省略可。Google 認証アカウントが必要かどうかなどの、仕事用アカウントの設定構成を制御します。

wipeDataFlags[]

enum (WipeDataFlag)

省略可。デバイスまたはプロファイルのワイプがなんらかの理由(コンプライアンス違反など)でトリガーされたときに、どのデータがワイプされるかを示すワイプフラグ。これは enterprises.devices.delete メソッドには適用されません。。このリストに重複を含めることはできません。

enterpriseDisplayNameVisibility

enum (EnterpriseDisplayNameVisibility)

省略可。デバイスに enterpriseDisplayName を表示するかどうかを制御します(会社所有デバイスのロック画面メッセージなど)。

appFunctions

enum (AppFunctions)

省略可。完全管理対象デバイスのデバイス上のアプリ、または仕事用プロファイルを使用しているデバイスの仕事用プロファイル内のアプリがアプリ機能を公開することを許可するかどうかを制御します。

defaultApplicationSettings[]

object (DefaultApplicationSetting)

省略可。サポートされている型のデフォルトのアプリケーション設定。プロファイルで少なくとも 1 つのアプリタイプに対してデフォルト アプリが正常に設定されると、ユーザーはそのプロファイルですべてのデフォルト アプリを変更できなくなります。

DefaultApplicationType ごとに 1 つの DefaultApplicationSetting のみが許可されます。

詳しくは、デフォルトのアプリ設定ガイドをご覧ください。

ApplicationPolicy

JSON 表現
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "customAppConfig": {
    object (CustomAppConfig)
  },
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings),
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "signingKeyCerts": [
    {
      object (ApplicationSigningKeyCert)
    }
  ],
  "roles": [
    {
      object (Role)
    }
  ]
}
フィールド
packageName

string

アプリのパッケージ名。たとえば、YouTube アプリの場合は com.google.android.youtube

installType

enum (InstallType)

実行するインストールのタイプ。

lockTaskAllowed
(deprecated)

boolean

アプリが全画面モードでロックされることを許可するかどうか。非推奨。専用デバイスを設定するには、InstallType KIOSK または kioskCustomLauncherEnabled を使用します。

defaultPermissionPolicy

enum (PermissionPolicy)

アプリがリクエストするすべての権限のデフォルト ポリシー。指定した場合、すべてのアプリに適用されるポリシーレベルの default_permission_policy がオーバーライドされます。すべてのアプリに適用される permission_grants はオーバーライドされません。

permissionGrants[]

object (PermissionGrant)

アプリに対する明示的な権限の付与または拒否。これらの値は、すべてのアプリに適用される default_permission_policypermission_grants をオーバーライドします。

managedConfiguration

object (Struct format)

アプリに適用される管理対象設定。設定の形式は、アプリでサポートされている ManagedProperty の値によって決まります。管理対象設定の各フィールド名は、ManagedPropertykey フィールドと一致している必要があります。フィールド値は、ManagedPropertytype と互換性がある必要があります。

typeJSON 値
BOOLtrue または false
STRING文字列
INTEGER数値
CHOICE文字列
MULTISELECTarray of strings
HIDDEN文字列
BUNDLE_ARRAYオブジェクトの配列
注: 文字列値は 65,535 文字以下にする必要があります。

disabled

boolean

アプリが無効かどうか。無効にしても、アプリデータは保持されます。

minimumVersionCode

integer

デバイスで実行されるアプリの最小バージョン。設定されている場合、デバイスはこのバージョン コード以上にアプリを更新しようとします。アプリが最新でない場合、デバイスには NonComplianceDetail が含まれ、non_compliance_reasonAPP_NOT_UPDATED に設定されます。アプリは、この値以上のバージョン コードで Google Play に公開されている必要があります。ポリシーごとに指定できる最小バージョン コードは、最大 20 個のアプリまでです。

delegatedScopes[]

enum (DelegatedScope)

Android Device Policy からアプリに委任されたスコープ。これらは、適用されたアプリケーションに追加の権限を提供します。

managedConfigurationTemplate

object (ManagedConfigurationTemplate)

管理対象設定 iframe から保存された、アプリの管理対象設定テンプレート。managed_configuration が設定されている場合、このフィールドは無視されます。

accessibleTrackIds[]

string

企業に属するデバイスがアクセスできるアプリのトラック ID のリスト。リストに複数のトラック ID が含まれている場合、デバイスはアクセス可能なすべてのトラックの中で最新のバージョンを受け取ります。リストにトラック ID が含まれていない場合、デバイスはアプリのプロダクション トラックにのみアクセスできます。各トラックの詳細については、AppTrackInfo をご覧ください。

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

ユーザーの同意を条件として、デバイスの仕事用プロファイルと個人用プロファイルの間でアプリが相互に通信できるかどうかを制御します。

autoUpdateMode

enum (AutoUpdateMode)

アプリの自動更新モードを制御します。

extensionConfig
(deprecated)

object (ExtensionConfig)

このアプリを拡張機能アプリとして有効にする構成。Android Device Policy とオフラインでやり取りする機能があります。

このフィールドは、最大 1 つのアプリに設定できます。COMPANION_APP ロールを持つアプリがある場合、このフィールドは設定できません。

デバイス上のアプリの署名鍵証明書のフィンガープリントが ApplicationPolicy.signingKeyCerts または ExtensionConfig.signingKeyFingerprintsSha256(非推奨)のエントリのいずれか、または Play ストアから取得したアプリの署名鍵証明書のフィンガープリントと一致している必要があります。そうすることで、アプリが Android Device Policy と通信できるようになります。アプリが Play ストアに登録されておらず、ApplicationPolicy.signingKeyCertsExtensionConfig.signingKeyFingerprintsSha256(非推奨)が設定されていない場合、INVALID_VALUE を含む NonComplianceDetail がレポートされます。

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

VPN が接続されておらず、alwaysOnVpnPackage.lockdownEnabled が有効になっている場合に、アプリがネットワークにアクセスできるかどうかを指定します。VPN_LOCKDOWN_ENFORCED に設定すると、アプリはネットワーク接続を許可されず、VPN_LOCKDOWN_EXEMPTION に設定すると、アプリはネットワーク接続を許可されます。Android 10 以降を搭載するデバイスでのみサポートされます。デバイスがこれをサポートしていない場合、デバイスには non_compliance_reasonAPI_LEVEL に設定された NonComplianceDetail と fieldPath が含まれます。アプリに適用されない場合、デバイスには non_compliance_reasonUNSUPPORTED に設定された NonComplianceDetail と fieldPath が含まれます。fieldPath は applications[i].alwaysOnVpnLockdownExemption に設定されます。ここで、iapplications ポリシー内のパッケージのインデックスです。

workProfileWidgets

enum (WorkProfileWidgets)

仕事用プロファイルにインストールされたアプリがホーム画面にウィジェットを追加することを許可するかどうかを指定します。

credentialProviderPolicy

enum (CredentialProviderPolicy)

省略可。Android 14 以降でアプリが認証情報プロバイダとして機能することを許可するかどうか。

customAppConfig

object (CustomAppConfig)

省略可。このカスタムアプリの構成。

これを設定するには、install_typeCUSTOM に設定する必要があります。

installConstraint[]

object (InstallConstraint)

省略可。アプリのインストールに関する制約。指定できる InstallConstraint は 1 つだけです。複数の制約は拒否されます。

installPriority

integer

省略可。installType が次のように設定されているアプリのうち:

  • FORCE_INSTALLED
  • PREINSTALLED

これにより、インストールの相対的な優先度が制御されます。値 0(デフォルト)は、このアプリが他のアプリよりも優先されないことを意味します。1 ~ 10,000 の値の場合、値が小さいほど優先度が高くなります。0 ~ 10,000 の範囲外の値は拒否されます。

userControlSettings

enum (UserControlSettings)

省略可。アプリでユーザー制御が許可されているかどうかを指定します。ユーザー制御には、アプリの強制停止やアプリデータの消去などのユーザー操作が含まれます。特定のタイプのアプリは特別な扱いを受けます。詳しくは、USER_CONTROL_SETTINGS_UNSPECIFIEDUSER_CONTROL_ALLOWED をご覧ください。

preferentialNetworkId

enum (PreferentialNetworkId)

省略可。アプリが使用する優先ネットワークの ID。preferentialNetworkServiceConfigs に、指定されたネットワーク ID の構成が必要です。PREFERENTIAL_NETWORK_ID_UNSPECIFIED に設定すると、アプリケーションは defaultPreferentialNetworkId で指定されたデフォルトのネットワーク ID を使用します。このデフォルト設定から除外されるアプリのリストについては、defaultPreferentialNetworkId のドキュメントをご覧ください。この機能は、Android 13 以降の仕事用プロファイルと完全管理対象デバイスの両方に適用されます。

signingKeyCerts[]

object (ApplicationSigningKeyCert)

省略可。アプリの署名鍵証明書。

このフィールドは、次の場合に必須です。

  • アプリの installTypeCUSTOM に設定されている(カスタムアプリ)。
  • アプリの roles が空でないリストに設定されており、アプリが Google Play ストアに存在しない。
  • アプリで extensionConfig が設定されている(拡張機能アプリである)が、ExtensionConfig.signingKeyFingerprintsSha256(非推奨)が設定されておらず、アプリが Play ストアに存在しない。

カスタムアプリでこのフィールドが設定されていない場合、ポリシーは拒否されます。カスタム以外のアプリで必要なときに設定されていない場合は、INVALID_VALUE を含む NonComplianceDetail が報告されます。

その他の場合、このフィールドは省略可能で、Google Play ストアから取得した署名鍵証明書が使用されます。

このフィールドの使用方法については、次のポリシー設定をご覧ください。

  • choosePrivateKeyRules
  • ApplicationPolicy.InstallType.CUSTOM
  • ApplicationPolicy.extensionConfig
  • ApplicationPolicy.roles
roles[]

object (Role)

省略可。アプリが持つロール。

特定のロールを持つアプリは、Android 14 以降で消費電力とバックグラウンド実行の制限、一時停止、休止状態から除外できます。Android 11 以降では、特定のロールを持つアプリに対してユーザー制御を禁止することもできます。詳しくは、各 RoleType のドキュメントをご覧ください。

アプリに <meta-data android:name="com.google.android.managementapi.notification.NotificationReceiverService.SERVICE_APP_ROLES" android:value="" /> を持つ通知受信サービスがある場合、アプリに設定されたロールがアプリに通知されます。アプリのロールが更新されるたび、またはアプリのインストール後にロールのリストが空でない場合に、アプリに通知されます。アプリは、この通知を使用してインストール後にブートストラップできます。サービスの要件について詳しくは、AMAPI SDK との統合アプリのロールを管理するのガイドをご覧ください。

例外を適用してアプリにロールを通知するには、デバイス上のアプリの署名鍵証明書のフィンガープリントが、Google Play ストアから取得した署名鍵証明書のフィンガープリントのいずれか、または ApplicationPolicy.signingKeyCerts のエントリのいずれかと一致する必要があります。それ以外の場合は、APP_SIGNING_CERT_MISMATCHNonComplianceDetail が報告されます。

同じ roleType を持つ重複するロールは存在できません。複数のアプリが同じ roleType のロールを保持することはできません。ROLE_TYPE_UNSPECIFIED タイプのロールは使用できません。

PermissionGrant

JSON 表現
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
フィールド
permission

string

Android の権限またはグループ(android.permission.READ_CALENDARandroid.permission_group.CALENDAR など)。

policy

enum (PermissionPolicy)

権限を付与するためのポリシー。

構造体

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)

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 の繰り返しを表します。

ListValue

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

value (Value format)

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

ManagedConfigurationTemplate

JSON 表現
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
フィールド
templateId

string

管理対象構成テンプレートの ID。

configurationVariables

map (key: string, value: string)

省略可。構成用に定義された <key, value> 構成変数を含むマップ。

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

ConfigurationVariablesEntry

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

string

value

string

ExtensionConfig

JSON 表現
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
フィールド
signingKeyFingerprintsSha256[]
(deprecated)

string

拡張機能アプリの署名鍵証明書の 16 進数でエンコードされた SHA-256 ハッシュ。64 文字の 16 進数文字列表現のみが有効です。

署名鍵証明書のフィンガープリントは常に Google Play ストアから取得されます。このフィールドは、追加の署名鍵証明書のフィンガープリントを指定するために使用されます。ただし、アプリが Play ストアで入手できない場合は、このフィールドを設定する必要があります。アプリが Play ストアで利用できない場合、このフィールドが設定されていないと、INVALID_VALUE を含む NonComplianceDetail がレポートされます。

デバイス上の拡張機能アプリの署名鍵証明書のフィンガープリントは、Google Play ストアから取得した署名鍵証明書のフィンガープリントのいずれか、またはこのフィールドで指定されたフィンガープリントのいずれかと一致している必要があります。そうでない場合、アプリは Android デバイス ポリシーと通信できません。

本番環境のユースケースでは、このフィールドを空のままにしておくことをおすすめします。

notificationReceiver
(deprecated)

string

ローカル コマンド ステータスの更新を拡張アプリに通知する Android Device Policy のレシーバー サービス クラスの完全修飾クラス名。サービスは拡張アプリの AndroidManifest.xml でエクスポートされ、NotificationReceiverService を拡張する必要があります(詳しくは、AMAPI SDK との統合ガイドをご覧ください)。

CustomAppConfig

JSON 表現
{
  "userUninstallSettings": enum (UserUninstallSettings)
}
フィールド
userUninstallSettings

enum (UserUninstallSettings)

省略可。カスタムアプリのユーザー アンインストール設定。

InstallConstraint

JSON 表現
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
フィールド
networkTypeConstraint

enum (NetworkTypeConstraint)

省略可。ネットワーク タイプの制約。

chargingConstraint

enum (ChargingConstraint)

省略可。充電の制約。

deviceIdleConstraint

enum (DeviceIdleConstraint)

省略可。デバイス アイドル状態の制約。

ApplicationSigningKeyCert

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

string (bytes format)

必須。アプリの署名鍵証明書の SHA-256 ハッシュ値。これは有効な SHA-256 ハッシュ値(32 バイト)である必要があります。それ以外の場合、ポリシーは拒否されます。

Base64 でエンコードされた文字列。

ロール

JSON 表現
{
  "roleType": enum (RoleType)
}
フィールド
roleType

enum (RoleType)

必須。アプリが持つことができるロールのタイプ。

PersistentPreferredActivity

JSON 表現
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
フィールド
receiverActivity

string

デフォルトのインテント ハンドラとなるアクティビティ。これは Android コンポーネント名(com.android.enterprise.app/.MainActivity など)である必要があります。または、値はアプリのパッケージ名にすることもできます。この場合、Android デバイス ポリシーは、インテントを処理する適切なアクティビティをアプリから選択します。

actions[]

string

フィルタで照合するインテント アクション。フィルタにアクションが含まれている場合、インテントのアクションがそれらの値のいずれかである必要があります。アクションが含まれていない場合、インテント アクションは無視されます。

categories[]

string

フィルタで照合するインテント カテゴリ。インテントには必要なカテゴリが含まれており、一致させるには、それらのカテゴリがすべてフィルタに含まれている必要があります。つまり、インテントでカテゴリが指定されていない限り、フィルタにカテゴリを追加してもマッチングには影響しません。

SystemUpdate

JSON 表現
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "allowedDaysWithoutUpdate": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
フィールド
type

enum (SystemUpdateType)

構成するシステム アップデートのタイプ。

startMinutes

integer

タイプが WINDOWED の場合、メンテナンスの時間枠の開始時間(デバイスの現地時間の午前 0 時からの経過時間(分単位))。この値は 0 ~ 1439 の範囲で指定する必要があります。

endMinutes

integer

タイプが WINDOWED の場合、メンテナンスの時間枠の終了時刻。デバイスの現地時間の午前 0 時からの経過時間(分単位)で測定されます。この値は 0 ~ 1439 の範囲で指定する必要があります。この値が start_minutes より小さい場合、メンテナンス ウィンドウは午前 0 時をまたぎます。指定されたメンテナンスの時間枠が 30 分未満の場合、実際の時間枠は開始時刻から 30 分延長されます。

allowedDaysWithoutUpdate

integer

この値がゼロより大きい場合、保留中の更新が利用可能になってから、デバイスが更新を行わずにコンプライアンスを維持できる日数を表します。それ以外の場合は効果はありません。

freezePeriods[]

object (FreezePeriod)

無線(OTA)システム アップデートを延期して、デバイスで実行されている OS バージョンを凍結する期間。毎年繰り返されます。デバイスが永久にフリーズしないように、各フリーズ期間の間は 60 日以上離す必要があります。

FreezePeriod

JSON 表現
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
フィールド
startDate

object (Date)

フリーズ期間の開始日(指定した日も期間に含む)。注: daymonth を設定する必要があります。year は使用されないため、設定しないでください。例: {"month": 1,"date": 30}

endDate

object (Date)

フリーズ期間の終了日(指定した日も期間に含む)。開始日から 90 日以内の日付を指定してください。終了日が開始日より前の場合は、フリーズ期間は年末をまたぐとみなされます。注: daymonth を設定する必要があります。year は使用されないため、設定しないでください。例: {"month": 1,"date": 30}

日付

JSON 表現
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1~9999、または年のない日付を指定する場合は 0 にする必要があります。

month

integer

1 年の中の月。1~12、または月と日のない年を指定する場合は 0 にする必要があります。

day

integer

1 月の中の日付。1~31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

StatusReportingSettings

JSON 表現
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean,
  "defaultApplicationInfoReportingEnabled": boolean
}
フィールド
applicationReportsEnabled

boolean

アプリレポートが有効かどうか。

deviceSettingsEnabled

boolean

デバイス設定のレポートが有効かどうか。

softwareInfoEnabled

boolean

ソフトウェア情報のレポートが有効かどうか。

memoryInfoEnabled

boolean

メモリ イベントのレポートが有効かどうか。

networkInfoEnabled

boolean

ネットワーク情報のレポートが有効かどうか。

displayInfoEnabled

boolean

ディスプレイ レポートが有効かどうか。仕事用プロファイルが設定された個人所有のデバイスでは、レポートデータを利用できません。

powerManagementEventsEnabled

boolean

電源管理イベントのレポートが有効かどうか。仕事用プロファイルが設定された個人所有のデバイスでは、レポートデータを利用できません。

hardwareStatusEnabled

boolean

ハードウェア ステータスの報告が有効かどうか。仕事用プロファイルが設定された個人所有のデバイスでは、レポートデータを利用できません。

systemPropertiesEnabled

boolean

システム プロパティのレポートが有効かどうか。

applicationReportingSettings

object (ApplicationReportingSettings)

アプリケーション レポートの設定。application_reports_enabled が true の場合にのみ適用されます。

commonCriteriaModeEnabled

boolean

Common Criteria Mode レポートが有効かどうか。これは会社所有デバイスでのみサポートされています。

defaultApplicationInfoReportingEnabled

boolean

省略可。defaultApplicationInfo レポートが有効かどうか。

ApplicationReportingSettings

JSON 表現
{
  "includeRemovedApps": boolean
}
フィールド
includeRemovedApps

boolean

削除されたアプリがアプリ レポートに含まれるかどうか。

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

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_qualityNUMERICNUMERIC_COMPLEXALPHABETICALPHANUMERICCOMPLEX の場合にのみ適用されます。

passwordMinimumLetters

integer

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

passwordMinimumLowerCase

integer

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

passwordMinimumNonLetter

integer

パスワードに最低限必要な英文字以外の文字数(数字または記号)。password_qualityCOMPLEX の場合にのみ適用されます。

passwordMinimumNumeric

integer

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

passwordMinimumSymbols

integer

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

passwordMinimumUpperCase

integer

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

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_scopeSCOPE_PROFILE に設定されている場合にのみ設定できます。それ以外の場合、ポリシーは拒否されます。ユーザーが仕事用のロックを別に設定しておらず、このフィールドが REQUIRE_SEPARATE_WORK_LOCK に設定されている場合、NonComplianceDetail が報告され、nonComplianceReasonUSER_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 の範囲内(境界含む)である必要があります。

PackageNameList

JSON 表現
{
  "packageNames": [
    string
  ]
}
フィールド
packageNames[]

string

パッケージ名のリスト。

ProxyInfo

JSON 表現
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
フィールド
host

string

直接プロキシのホスト。

port

integer

直接プロキシのポート。

excludedHosts[]

string

直接プロキシの場合、プロキシがバイパスされるホスト。ホスト名には、*.example.com などのワイルドカードを含めることができます。

pacUri

string

プロキシの構成に使用される PAC スクリプトの URI。

ChoosePrivateKeyRule

JSON 表現
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
フィールド
urlPattern

string

リクエストの URL と照合する URL パターン。設定されていない場合、または空の場合、すべての URL に一致します。これは java.util.regex.Pattern の正規表現構文を使用します。

packageNames[]

string

このルールが適用されるパッケージ名。アプリの署名鍵証明書のフィンガープリントが、Google Play ストアと ApplicationPolicy.signingKeyCerts が提供する署名鍵証明書のフィンガープリントと照合されます。パッケージ名が指定されていない場合、エイリアスは KeyChain.choosePrivateKeyAlias またはオーバーロードを呼び出すすべてのアプリに提供されます(ただし、Android 11 以降でも KeyChain.choosePrivateKeyAlias を呼び出さずに提供されることはありません)。ここで指定されたパッケージと同じ Android UID を持つアプリは、KeyChain.choosePrivateKeyAlias を呼び出すときにアクセス権を持ちます。

privateKeyAlias

string

使用する秘密鍵のエイリアス。

AlwaysOnVpnPackage

JSON 表現
{
  "packageName": string,
  "lockdownEnabled": boolean
}
フィールド
packageName

string

VPN アプリのパッケージ名。

lockdownEnabled

boolean

VPN が接続されていないときにネットワークを許可しません。

ComplianceRule

JSON 表現
{
  "disableApps": boolean,
  "packageNamesToDisable": [
    string
  ],

  // Union field condition can be only one of the following:
  "nonComplianceDetailCondition": {
    object (NonComplianceDetailCondition)
  },
  "apiLevelCondition": {
    object (ApiLevelCondition)
  }
  // End of list of possible types for union field condition.
}
フィールド
disableApps

boolean

true に設定すると、デバイスを実質的に無効にするが、アプリデータは保持されるように、アプリを無効にする緩和アクションがルールに含まれます。デバイスがロックされたタスクモードでアプリを実行している場合、アプリは閉じられ、準拠していない理由を示す UI が表示されます。

packageNamesToDisable[]

string

設定されている場合、ルールにはリストで指定されたアプリを無効にする軽減アクションが含まれますが、アプリデータは保持されます。

共用体フィールド condition。条件。満たされると、ルールで定義された緩和アクションがトリガーされます。条件のいずれか 1 つを設定する必要があります。condition は次のいずれかになります。
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

デバイスに一致する NonComplianceDetailいずれか存在する場合に満たされる条件。

apiLevelCondition

object (ApiLevelCondition)

デバイスの Android Framework API レベルが最小要件を満たしていない場合に満たされる条件。

NonComplianceDetailCondition

JSON 表現
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
フィールド
settingName

string

ポリシー設定の名前。これは、最上位の Policy フィールドの JSON フィールド名です。設定されていない場合、この条件は任意の設定名と一致します。

nonComplianceReason

enum (NonComplianceReason)

デバイスが設定に準拠していない理由。設定されていない場合、この条件はすべての理由に一致します。

packageName

string

コンプライアンス違反のアプリのパッケージ名。設定されていない場合、この条件は任意のパッケージ名と一致します。

ApiLevelCondition

JSON 表現
{
  "minApiLevel": integer
}
フィールド
minApiLevel

integer

必要な最小 Android Framework API レベル。デバイスが最小要件を満たしていない場合、この条件は満たされます。0 より大きい値にする必要があります。

SetupAction

JSON 表現
{
  "title": {
    object (UserFacingMessage)
  },
  "description": {
    object (UserFacingMessage)
  },

  // Union field action can be only one of the following:
  "launchApp": {
    object (LaunchAppAction)
  }
  // End of list of possible types for union field action.
}
フィールド
title

object (UserFacingMessage)

このアクションのタイトル。

description

object (UserFacingMessage)

このアクションの説明。

共用体フィールド action。セットアップ中に実行するアクション。action は次のいずれかになります。
launchApp

object (LaunchAppAction)

アプリを起動するアクション。アプリは、キー com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION を含むエクストラがブール値 true に設定されたインテントで起動されます。これは、セットアップ アクション フローであることを示します。SetupAction がアプリを参照している場合、アプリのポリシーの対応する installTypeREQUIRED_FOR_SETUP として設定する必要があります。そうしないと、設定が失敗します。

LaunchAppAction

JSON 表現
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
フィールド

共用体フィールド launch

launch は次のいずれかになります。

packageName

string

起動するアプリのパッケージ名

PolicyEnforcementRule

JSON 表現
{
  "blockAction": {
    object (BlockAction)
  },
  "wipeAction": {
    object (WipeAction)
  },

  // Union field trigger can be only one of the following:
  "settingName": string
  // End of list of possible types for union field trigger.
}
フィールド
blockAction

object (BlockAction)

会社所有のデバイスまたは仕事用プロファイル上のアプリやデータへのアクセスをブロックするアクション。このアクションにより、コンプライアンスの問題を修正する方法に関する情報(可能な場合)を含むユーザー向けの通知もトリガーされます。注: wipeAction も指定する必要があります。

wipeAction

object (WipeAction)

会社所有デバイスをリセットしたり、仕事用プロファイルを削除したりするアクション。注: blockAction も指定する必要があります。

共用体フィールド trigger。このルールをトリガーする条件。trigger は次のいずれかになります。
settingName

string

適用するトップレベルのポリシー。たとえば、applications や、passwordPolicies です。

BlockAction

JSON 表現
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
フィールド
blockAfterDays

integer

デバイスまたは仕事用プロファイルがブロックされるまでのポリシー違反の日数。アクセスを直ちにブロックするには、0 に設定します。blockAfterDayswipeAfterDays より小さくする必要があります。

blockScope

enum (BlockScope)

この BlockAction のスコープを指定します。会社所有のデバイスにのみ適用されます。

WipeAction

JSON 表現
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
フィールド
wipeAfterDays

integer

デバイスまたは仕事用プロファイルがワイプされるまでのポリシー違反の日数。wipeAfterDaysblockAfterDays より大きい値にする必要があります。

preserveFrp

boolean

出荷時設定へのリセット保護機能のデータがデバイスに保持されているかどうか。この設定は仕事用プロファイルには適用されません。

KioskCustomization

JSON 表現
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
フィールド
powerButtonActions

enum (PowerButtonActions)

ユーザーが電源ボタンを長押ししたときのキオスクモードのデバイスの動作を設定します。

systemErrorWarnings

enum (SystemErrorWarnings)

キオスクモードで、クラッシュしたアプリや応答しないアプリのシステム エラー ダイアログをブロックするかどうかを指定します。ブロックされると、ユーザーが UI で [アプリを閉じる] オプションを選択したかのように、システムによってアプリが強制停止されます。

systemNavigation

enum (SystemNavigation)

キオスクモードで有効にするナビゲーション機能(ホームボタン、概要ボタンなど)を指定します。

statusBar

enum (StatusBar)

キオスクモードでシステム情報と通知を無効にするかどうかを指定します。

deviceSettings

enum (DeviceSettings)

キオスクモードで設定アプリを許可するかどうかを指定します。

AdvancedSecurityOverrides

JSON 表現
{
  "untrustedAppsPolicy": enum (UntrustedAppsPolicy),
  "googlePlayProtectVerifyApps": enum (GooglePlayProtectVerifyApps),
  "developerSettings": enum (DeveloperSettings),
  "commonCriteriaMode": enum (CommonCriteriaMode),
  "personalAppsThatCanReadWorkNotifications": [
    string
  ],
  "mtePolicy": enum (MtePolicy),
  "contentProtectionPolicy": enum (ContentProtectionPolicy)
}
フィールド
untrustedAppsPolicy

enum (UntrustedAppsPolicy)

デバイスに適用される信頼できないアプリ(提供元不明のアプリ)のポリシー。install_unknown_sources_allowed (deprecated). を置き換えます

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Google Play プロテクトの検証が強制されているかどうか。ensureVerifyAppsEnabled(非推奨)に代わるものです。

developerSettings

enum (DeveloperSettings)

デベロッパー設定(デベロッパー オプションとセーフモード)へのアクセスを制御します。safeBootDisabled(非推奨)と debuggingFeaturesAllowed(非推奨)に代わるものです。仕事用プロファイルが設定されている個人所有のデバイスでは、このポリシーを設定してもセーフモードは無効になりません。この場合、MANAGEMENT_MODE を含む NonComplianceDetail が報告されます。

commonCriteriaMode

enum (CommonCriteriaMode)

Common Criteria モードを制御する - 情報技術セキュリティ評価のための Common Criteria(CC)で定義されているセキュリティ標準。コモン クライテリア モードを有効にすると、デバイス上の特定のセキュリティ コンポーネントが強化されます。詳しくは、CommonCriteriaMode をご覧ください。

警告: コモン クライテリア モードでは、通常は国家安全保障システムやその他の機密性の高い組織で使用される IT プロダクトにのみ必要な厳格なセキュリティ モデルが適用されます。デバイスの標準的な使用に影響する可能性があります。必要な場合にのみ有効にします。以前に有効にした共通基準モードをオフにすると、ユーザーが設定したすべての Wi-Fi ネットワークが失われ、ユーザー入力が必要な企業が設定した Wi-Fi ネットワークを再設定する必要が生じる可能性があります。

personalAppsThatCanReadWorkNotifications[]

string

NotificationListenerService を使用して仕事用プロファイルの通知を読み取ることができる個人用アプリ。デフォルトでは、システムアプリ以外の個人用アプリは仕事用通知を読み取ることができません。リスト内の各値はパッケージ名でなければなりません。

mtePolicy

enum (MtePolicy)

省略可。デバイスの Memory Tagging Extension(MTE)を制御します。MTE ポリシーの変更を適用するには、デバイスを再起動する必要があります。Android 15 以降では、ポリシーの変更がデバイスの再起動を保留中の場合、PENDING を含む NonComplianceDetail が報告されます。

contentProtectionPolicy

enum (ContentProtectionPolicy)

省略可。不正なアプリをスキャンするコンテンツ保護を有効にするかどうかを制御します。この機能は Android 15 以降でサポートされています。

PersonalUsagePolicies

JSON 表現
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ],
  "privateSpacePolicy": enum (PrivateSpacePolicy),
  "bluetoothSharing": enum (BluetoothSharing)
}
フィールド
cameraDisabled

boolean

true の場合、個人用プロファイルでカメラが無効になります。

screenCaptureDisabled

boolean

true の場合、すべてのユーザーに対してスクリーン キャプチャが無効になります。

accountTypesWithManagementDisabled[]

string

ユーザーが管理できないアカウントの種類。

maxDaysWithWorkOff

integer

仕事用プロファイルをオフにできる期間を制御します。最小期間は 3 日以上にする必要があります。その他の詳細は次のとおりです。

  • 期間を 0 に設定すると、この機能はオフになります。
  • 期間が最小期間より小さい値に設定されている場合、この機能はエラーを返します。
注: 長期間オフラインになっている場合に個人用プロファイルが一時停止されないようにするには、このパラメータに一時的に大きな値を設定します。

personalPlayStoreMode

enum (PlayStoreMode)

personalApplications と組み合わせて、個人用プロファイルのアプリを許可またはブロックする方法を制御します。

personalApplications[]

object (PersonalApplicationPolicy)

個人用プロファイルのアプリに適用されるポリシー。

privateSpacePolicy

enum (PrivateSpacePolicy)

省略可。デバイスでプライベート スペースを許可するかどうかを制御します。

bluetoothSharing

enum (BluetoothSharing)

省略可。Bluetooth 共有が許可されているかどうか。

PersonalApplicationPolicy

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

string

アプリのパッケージ名。

installType

enum (InstallType)

実行するインストールのタイプ。

OncCertificateProvider

JSON 表現
{
  "certificateReferences": [
    string
  ],

  // Union field endpoint can be only one of the following:
  "contentProviderEndpoint": {
    object (ContentProviderEndpoint)
  }
  // End of list of possible types for union field endpoint.
}
フィールド
certificateReferences[]

string

この機能は一般提供されていません。

共用体フィールド endpoint

この機能は一般提供されていません。endpoint は次のいずれかになります。

contentProviderEndpoint

object (ContentProviderEndpoint)

この機能は一般提供されていません。

ContentProviderEndpoint

JSON 表現
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
フィールド
uri

string

この機能は一般提供されていません。

packageName

string

この機能は一般提供されていません。

signingCertsSha256[]

string

必須。この機能は一般提供されていません。

CrossProfilePolicies

JSON 表現
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "crossProfileAppFunctions": enum (CrossProfileAppFunctions),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
フィールド
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

個人用アプリが仕事用プロファイルに保存されている連絡先にアクセスできるかどうか。

exemptions_to_show_work_contacts_in_personal_profile もご覧ください。

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

一方のプロファイル(個人用または仕事用)からコピーしたテキストを、もう一方のプロファイルに貼り付けることができるかどうか。

crossProfileDataSharing

enum (CrossProfileDataSharing)

一方のプロファイル(個人用または仕事用)のデータを、もう一方のプロファイルのアプリと共有できるかどうか。インテントによるシンプルなデータ共有を具体的に制御します。連絡先の検索、コピー&ペースト、仕事用アプリと個人用アプリの接続など、他のクロス プロファイル通信チャネルの管理は個別に設定されます。

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

仕事用プロファイルのウィジェットのデフォルトの動作を指定します。ポリシーで特定のアプリの work_profile_widgets が指定されていない場合、ここで指定された値に従って動作します。

crossProfileAppFunctions

enum (CrossProfileAppFunctions)

省略可。個人用プロファイルのアプリが、仕事用プロファイルのアプリによって公開されたアプリ機能を呼び出すことができるかどうかを制御します。

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

ShowWorkContactsInPersonalProfile 設定から除外されるアプリのリスト。これを設定するには、ShowWorkContactsInPersonalProfile を次のいずれかの値に設定する必要があります。

  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED。この場合、これらの除外はブロックリストとして機能します。
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED。この場合、これらの除外は許可リストとして機能します。
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM。この場合、これらの例外は、すでに許可リストに登録されているシステムアプリに加えて、許可リストとして機能します。

Android 14 以降でサポートされています。Android のバージョンが 14 より前の場合は、API_LEVEL を含む NonComplianceDetail がレポートされます。

UsageLog

JSON 表現
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
フィールド
enabledLogTypes[]

enum (LogType)

有効にするログタイプを指定します。使用状況のロギングが有効になっている場合、ユーザーはデバイス上のメッセージを受け取ります。

uploadOnCellularAllowed[]

enum (LogType)

有効になっているログタイプのうち、モバイルデータ通信でアップロードできるものを指定します。デフォルトでは、デバイスが Wi-Fi に接続すると、ログはアップロード用にキューに登録されます。

DeviceConnectivityManagement

JSON 表現
{
  "usbDataAccess": enum (UsbDataAccess),
  "configureWifi": enum (ConfigureWifi),
  "wifiDirectSettings": enum (WifiDirectSettings),
  "tetheringSettings": enum (TetheringSettings),
  "wifiSsidPolicy": {
    object (WifiSsidPolicy)
  },
  "wifiRoamingPolicy": {
    object (WifiRoamingPolicy)
  },
  "bluetoothSharing": enum (BluetoothSharing),
  "preferentialNetworkServiceSettings": {
    object (PreferentialNetworkServiceSettings)
  },
  "apnPolicy": {
    object (ApnPolicy)
  }
}
フィールド
usbDataAccess

enum (UsbDataAccess)

USB 経由で転送できるファイルやデータを制御します。会社所有デバイスでのみサポートされています。

configureWifi

enum (ConfigureWifi)

Wi-Fi の構成権限を制御します。設定されたオプションに応じて、ユーザーは Wi-Fi ネットワークの設定を完全に制御できるか、制限付きで制御できるか、まったく制御できないかのいずれかになります。

wifiDirectSettings

enum (WifiDirectSettings)

Wi-Fi Direct の設定の構成と使用を制御します。Android 13 以降を搭載する会社所有のデバイスでサポートされています。

tetheringSettings

enum (TetheringSettings)

テザリングの設定を制御します。設定された値に基づいて、ユーザーはさまざまな形式のテザリングを部分的または完全に使用できなくなります。

wifiSsidPolicy

object (WifiSsidPolicy)

デバイスが接続できる Wi-Fi SSID の制限。なお、この設定はデバイスで構成できるネットワークには影響しません。Android 13 以降を搭載する会社所有のデバイスでサポートされています。

wifiRoamingPolicy

object (WifiRoamingPolicy)

省略可。Wi-Fi ローミング ポリシー。

bluetoothSharing

enum (BluetoothSharing)

省略可。Bluetooth 共有を許可するかどうかを制御します。

preferentialNetworkServiceSettings

object (PreferentialNetworkServiceSettings)

省略可。優先ネットワーク サービス構成。このフィールドを設定すると、preferentialNetworkService がオーバーライドされます。この設定は、Android 13 以降の仕事用プロファイルと完全管理対象デバイスの両方で行うことができます。詳しくは、5G ネットワーク スライスのガイドをご覧ください。

apnPolicy

object (ApnPolicy)

省略可。アクセス ポイント名(APN)ポリシー。デバイス上の他の APN をオーバーライドする可能性のあるアクセス ポイント名(APN)の設定。詳しくは、OVERRIDE_APNS_ENABLEDoverrideApns をご覧ください。

WifiSsidPolicy

JSON 表現
{
  "wifiSsidPolicyType": enum (WifiSsidPolicyType),
  "wifiSsids": [
    {
      object (WifiSsid)
    }
  ]
}
フィールド
wifiSsidPolicyType

enum (WifiSsidPolicyType)

適用する Wi-Fi SSID ポリシーのタイプ。

wifiSsids[]

object (WifiSsid)

省略可。ポリシーで適用される Wi-Fi SSID のリスト。WifiSsidPolicyType が WIFI_SSID_ALLOWLIST に設定されている場合、このフィールドは空でない必要があります。これが空でないリストに設定されている場合、Android のバージョンが 13 未満であれば API_LEVEL を含む NonComplianceDetail の詳細が報告され、会社所有でないデバイスについては MANAGEMENT_MODE を含む NonComplianceDetail が報告されます。

WifiSsid

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

string

必須。文字列として表される Wi-Fi SSID。

WifiRoamingPolicy

JSON 表現
{
  "wifiRoamingSettings": [
    {
      object (WifiRoamingSetting)
    }
  ]
}
フィールド
wifiRoamingSettings[]

object (WifiRoamingSetting)

省略可。Wi-Fi ローミングの設定。このリストで指定する SSID は一意である必要があります。一意でない場合、ポリシーは拒否されます。

WifiRoamingSetting

JSON 表現
{
  "wifiSsid": string,
  "wifiRoamingMode": enum (WifiRoamingMode)
}
フィールド
wifiSsid

string

必須。Wi-Fi ネットワークの SSID。

wifiRoamingMode

enum (WifiRoamingMode)

必須。指定された SSID の Wi-Fi ローミング モード。

PreferentialNetworkServiceSettings

JSON 表現
{
  "preferentialNetworkServiceConfigs": [
    {
      object (PreferentialNetworkServiceConfig)
    }
  ],
  "defaultPreferentialNetworkId": enum (PreferentialNetworkId)
}
フィールド
preferentialNetworkServiceConfigs[]

object (PreferentialNetworkServiceConfig)

必須。複数のエンタープライズ スライスを有効にする優先ネットワーク サービス構成。同じ preferentialNetworkId を持つ構成が複数存在してはなりません。ApplicationPolicy.preferentialNetworkId または defaultPreferentialNetworkId を設定して、構成がどのアプリケーションからも参照されていない場合、その構成は無視されます。4G ネットワーク上のデバイスの場合、優先ネットワーク サービスのデータ通話を設定するには、エンタープライズ APN を追加で設定する必要があります。これらの APN は apnPolicy を使用して追加できます。

defaultPreferentialNetworkId

enum (PreferentialNetworkId)

必須。applications に含まれていないアプリ、または ApplicationPolicy.preferentialNetworkIdPREFERENTIAL_NETWORK_ID_UNSPECIFIED に設定されている場合のデフォルトの優先ネットワーク ID。preferentialNetworkServiceConfigs で指定されたネットワーク ID の構成が存在する必要があります(NO_PREFERENTIAL_NETWORK に設定されている場合を除く)。PREFERENTIAL_NETWORK_ID_UNSPECIFIED に設定されているか、設定されていない場合、デフォルトは NO_PREFERENTIAL_NETWORK です。注: デフォルトの優先ネットワークが正しく構成されていない場合、ApplicationPolicy.preferentialNetworkId が設定されていないアプリはインターネットにアクセスできません。この設定は、次の重要なアプリには適用されません。

  • com.google.android.apps.work.clouddpc
  • com.google.android.gms

ApplicationPolicy.preferentialNetworkId を使用して、優先ネットワークを構成することもできます。

PreferentialNetworkServiceConfig

JSON 表現
{
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "fallbackToDefaultConnection": enum (FallbackToDefaultConnection),
  "nonMatchingNetworks": enum (NonMatchingNetworks)
}
フィールド
preferentialNetworkId

enum (PreferentialNetworkId)

必須。優先ネットワーク識別子。NO_PREFERENTIAL_NETWORK または PREFERENTIAL_NETWORK_ID_UNSPECIFIED に設定しないでください。設定すると、ポリシーは拒否されます。

fallbackToDefaultConnection

enum (FallbackToDefaultConnection)

省略可。デバイス全体のデフォルト ネットワークへのフォールバックが許可されているかどうか。これを FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED に設定する場合、nonMatchingNetworksNON_MATCHING_NETWORKS_DISALLOWED に設定することはできません。設定すると、ポリシーは拒否されます。注: これが FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED に設定されている場合、5G スライスが利用できないと、アプリはインターネットにアクセスできません。

nonMatchingNetworks

enum (NonMatchingNetworks)

省略可。この構成が適用されるアプリが、優先サービス以外のネットワークを使用できないようにブロックされるかどうか。これが NON_MATCHING_NETWORKS_DISALLOWED に設定されている場合、fallbackToDefaultConnectionFALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED に設定する必要があります。

ApnPolicy

JSON 表現
{
  "overrideApns": enum (OverrideApns),
  "apnSettings": [
    {
      object (ApnSetting)
    }
  ]
}
フィールド
overrideApns

enum (OverrideApns)

省略可。オーバーライド APN が無効か有効か。詳細については、DevicePolicyManager.setOverrideApnsEnabled をご覧ください。

apnSettings[]

object (ApnSetting)

省略可。オーバーライド APN の APN 設定。提供された APN 設定の間に競合があってはなりません。競合がある場合、ポリシーは拒否されます。2 つの ApnSetting が競合していると見なされるのは、numericOperatorIdapnproxyAddressproxyPortmmsProxyAddressmmsProxyPortmmscmvnoTypeprotocolroamingProtocol のすべてのフィールドが両方で一致する場合です。APN 設定の一部が INVALID_VALUE に準拠していない場合、それらの設定は無視されます。この設定は、Android 10 以降の完全管理対象デバイスで行うことができます。これは、Android 13 以降の仕事用プロファイルでも設定できますが、ENTERPRISE APN タイプを持つ ApnSetting のみで設定できます。Android バージョンが 10 より前の場合は、API_LEVEL を含む NonComplianceDetail がレポートされます。Android バージョン 13 より前の仕事用プロファイルでは、MANAGEMENT_MODE を含む NonComplianceDetail が報告されます。

ApnSetting

JSON 表現
{
  "apnTypes": [
    enum (ApnType)
  ],
  "apn": string,
  "displayName": string,
  "alwaysOnSetting": enum (AlwaysOnSetting),
  "authType": enum (AuthType),
  "carrierId": integer,
  "mmsProxyAddress": string,
  "mmsProxyPort": integer,
  "mmsc": string,
  "mtuV4": integer,
  "mtuV6": integer,
  "mvnoType": enum (MvnoType),
  "networkTypes": [
    enum (NetworkType)
  ],
  "username": string,
  "password": string,
  "numericOperatorId": string,
  "protocol": enum (Protocol),
  "roamingProtocol": enum (Protocol),
  "proxyAddress": string,
  "proxyPort": integer
}
フィールド
apnTypes[]

enum (ApnType)

必須。APN の使用カテゴリ。このフィールドが空の場合、または APN_TYPE_UNSPECIFIED や重複が含まれている場合、ポリシーは拒否されます。完全管理対象デバイスには複数の APN タイプを設定できます。仕事用プロファイルで許可される APN タイプは ENTERPRISE のみです。仕事用プロファイルの他の値については、MANAGEMENT_MODE を含む NonComplianceDetail が報告されます。デバイスまたは管理モードでサポートされていない APN タイプは無視されます。この結果が空のリストになる場合、apnTypes は必須フィールドであるため、APN 設定は無視されます。デバイスまたは管理モードで APN タイプがサポートされていない場合、INVALID_VALUE を伴う NonComplianceDetail がレポートされます。

apn

string

必須。APN の名前。このフィールドが空の場合、ポリシーは拒否されます。

displayName

string

必須。APN を説明する人が読める形式の名前。このフィールドが空の場合、ポリシーは拒否されます。

alwaysOnSetting

enum (AlwaysOnSetting)

省略可。この APN で CM-IDLE モードから CM-CONNECTED 状態に移行するたびにユーザー プレーン リソースをアクティブ化する必要があるかどうか。3GPP TS 23.501 セクション 5.6.13 を参照してください。

authType

enum (AuthType)

省略可。APN の認証タイプ。

carrierId

integer

省略可。APN の携帯通信会社 ID。値 0(デフォルト)は設定されていないことを意味し、負の値は拒否されます。

mmsProxyAddress

string

省略可。APN の MMS(マルチメディア メッセージング サービス)プロキシ アドレス。IP アドレスまたはホスト名(URL ではない)を指定できます。

mmsProxyPort

integer

省略可。APN の MMS(マルチメディア メッセージング サービス)プロキシ ポート。値 0(デフォルト)は設定されていないことを意味し、負の値は拒否されます。

mmsc

string

省略可。APN の MMSC(マルチメディア メッセージング サービス センター)URI。

mtuV4

integer

省略可。この APN 設定によって起動された IPv4 ルートのデフォルトの MTU(最大伝送単位)サイズ(バイト単位)。値 0(デフォルト)は設定されていないことを意味し、負の値は拒否されます。Android 13 以降でサポートされています。Android バージョンが 13 より前の場合は、API_LEVEL を含む NonComplianceDetail がレポートされます。

mtuV6

integer

省略可。APN が接続された IPv6 モバイル インターフェースの MTU(最大伝送単位)サイズ。値 0(デフォルト)は設定されていないことを意味し、負の値は拒否されます。Android 13 以降でサポートされています。Android バージョンが 13 より前の場合は、API_LEVEL を含む NonComplianceDetail がレポートされます。

mvnoType

enum (MvnoType)

省略可。APN の MVNO マッチタイプ。

networkTypes[]

enum (NetworkType)

省略可。APN が使用する可能性のある無線技術(ネットワーク タイプ)。このフィールドに NETWORK_TYPE_UNSPECIFIED または重複が含まれている場合、ポリシーは拒否されます。

username

string

省略可。APN の APN ユーザー名。

password

string

省略可。APN の APN パスワード。

numericOperatorId

string

省略可。APN の数値のオペレーター ID。数値の事業者 ID は、MCC(モバイル カントリー コード)+ MNC(モバイル ネットワーク コード)として定義されます。

protocol

enum (Protocol)

省略可。この APN への接続に使用するプロトコル。

roamingProtocol

enum (Protocol)

省略可。デバイスがローミング中にこの APN に接続するために使用するプロトコル。

proxyAddress

string

省略可。APN のプロキシ アドレス。

proxyPort

integer

省略可。APN のプロキシポート。値 0(デフォルト)は設定されていないことを意味し、負の値は拒否されます。

DeviceRadioState

JSON 表現
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel),
  "userInitiatedAddEsimSettings": enum (UserInitiatedAddEsimSettings)
}
フィールド
wifiState

enum (WifiState)

Wi-Fi の現在の状態と、ユーザーがその状態を変更できるかどうかを制御します。

airplaneModeState

enum (AirplaneModeState)

ユーザーが機内モードを切り替えられるかどうかを制御します。

ultraWidebandState

enum (UltraWidebandState)

超広帯域の設定の状態と、ユーザーがオン / オフを切り替えられるかどうかを制御します。

cellularTwoGState

enum (CellularTwoGState)

ユーザーが携帯通信会社の 2G 設定を切り替えられるかどうかを制御します。

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

デバイスが接続できる Wi-Fi ネットワークの最低限必要なセキュリティ レベル。

userInitiatedAddEsimSettings

enum (UserInitiatedAddEsimSettings)

省略可。ユーザーが eSIM プロファイルを追加できるかどうかを制御します。

DisplaySettings

JSON 表現
{
  "screenBrightnessSettings": {
    object (ScreenBrightnessSettings)
  },
  "screenTimeoutSettings": {
    object (ScreenTimeoutSettings)
  }
}
フィールド
screenBrightnessSettings

object (ScreenBrightnessSettings)

省略可。画面の明るさの設定を制御します。

screenTimeoutSettings

object (ScreenTimeoutSettings)

省略可。画面消灯の設定を制御します。

ScreenBrightnessSettings

JSON 表現
{
  "screenBrightnessMode": enum (ScreenBrightnessMode),
  "screenBrightness": integer
}
フィールド
screenBrightnessMode

enum (ScreenBrightnessMode)

省略可。画面の明るさモードを制御します。

screenBrightness

integer

省略可。画面の明るさ。1 は最も暗く、255 は最も明るい。値 0(デフォルト)は、画面の明るさが設定されていないことを意味します。その他の値は拒否されます。これを設定するには、screenBrightnessModeBRIGHTNESS_AUTOMATIC または BRIGHTNESS_FIXED である必要があります。Android 9 以降の完全管理対象デバイスでサポートされています。Android のバージョンが 9 より小さい場合は、API_LEVEL を含む NonComplianceDetail がレポートされます。Android 15 以降の会社所有デバイスの仕事用プロファイルでサポートされています。

ScreenTimeoutSettings

JSON 表現
{
  "screenTimeoutMode": enum (ScreenTimeoutMode),
  "screenTimeout": string
}
フィールド
screenTimeoutMode

enum (ScreenTimeoutMode)

省略可。ユーザーが画面のタイムアウトを設定できるかどうかを制御します。

screenTimeout

string (Duration format)

省略可。画面のタイムアウト時間を制御します。画面のタイムアウト時間は 0 より大きい必要があります。そうでない場合は拒否されます。また、maximumTimeToLock を超える値に設定することはできません。超える値に設定すると、画面タイムアウトが maximumTimeToLock に設定され、理由が INVALID_VALUE、具体的な理由が SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCKNonComplianceDetail がレポートされます。画面自動消灯が特定の下限値より小さい場合、下限値に設定されます。下限はデバイスによって異なる場合があります。この値を設定する場合は、screenTimeoutModeSCREEN_TIMEOUT_ENFORCED にする必要があります。Android 9 以降の完全管理対象デバイスでサポートされています。Android のバージョンが 9 より小さい場合は、API_LEVEL を含む NonComplianceDetail がレポートされます。Android 15 以降の会社所有デバイスの仕事用プロファイルでサポートされています。

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

WorkAccountSetupConfig

JSON 表現
{
  "authenticationType": enum (AuthenticationType),
  "requiredAccountEmail": string
}
フィールド
authenticationType

enum (AuthenticationType)

省略可。デバイス上のユーザーの認証タイプ。

requiredAccountEmail

string

省略可。追加する特定の Google 仕事用アカウントのメールアドレス。このフィールドは、authenticationTypeGOOGLE_AUTHENTICATED の場合にのみ機能します。これは一般ユーザー向けアカウントではなく、企業アカウントである必要があります。このフィールドを設定して、Google 認証済みアカウントをデバイスに追加すると、このフィールドを変更しても効果がなくなるため、一度だけ設定することをおすすめします。

DefaultApplicationSetting

JSON 表現
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "defaultApplications": [
    {
      object (DefaultApplication)
    }
  ],
  "defaultApplicationScopes": [
    enum (DefaultApplicationScope)
  ]
}
フィールド
defaultApplicationType

enum (DefaultApplicationType)

必須。デフォルトのアプリケーションを設定するアプリタイプ。

defaultApplications[]

object (DefaultApplication)

必須。特定のタイプのデフォルト アプリとして設定できるアプリのリスト。このリストは空にしたり、重複を含めたりすることはできません。リスト内の最初のアプリがインストールされ、defaultApplicationTypeDEFAULT_SMS の SMS アプリなど)の条件を満たしている場合、そのアプリがデフォルトのアプリとして設定されます。デバイス上のアプリの署名鍵証明書のフィンガープリントは、デフォルトとして設定されるために、Play ストアから取得した署名鍵証明書のフィンガープリントのいずれか、または ApplicationPolicy.signingKeyCerts のエントリのいずれかと一致する必要があります。

defaultApplicationScopesSCOPE_FULLY_MANAGED または SCOPE_WORK_PROFILE が含まれている場合、アプリは applications にエントリを持ち、installTypeBLOCKED 以外の値に設定されている必要があります。

リスト内のアプリがいずれもインストールされていない場合、APP_NOT_INSTALLED の理由と DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE の具体的な理由を含む NonComplianceDetail がレポートされます。1 つ以上のアプリがインストールされているものの、他の理由(アプリのタイプが適切でないなど)でポリシーが適用されない場合、INVALID_VALUE の理由と DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE の具体的な理由を含む NonComplianceDetail がレポートされます。

仕事用プロファイルが設定されている会社所有デバイスで SCOPE_PERSONAL_PROFILE を適用する場合、プリインストールされているシステムアプリのみをデフォルトとして設定できます。ポリシーが個人用プロファイルに適用されなかった場合は、INVALID_VALUE の理由と DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE の具体的な理由を含む NonComplianceDetail がレポートされます。

defaultApplicationScopes[]

enum (DefaultApplicationScope)

必須。ポリシーを適用するスコープ。このリストは空にしたり、重複を含めたりすることはできません。

指定されたスコープのいずれも管理モードに適用できない場合(たとえば、完全管理対象デバイスがリストに SCOPE_PERSONAL_PROFILE のみを含むポリシーを受け取った場合)、MANAGEMENT_MODE の理由と DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES の具体的な理由を含む NonComplianceDetail が報告されます。

DefaultApplication

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

string

必須。デフォルトのアプリとして設定されるパッケージ名。パッケージ名が無効な場合、ポリシーは拒否されます。

ツールのアノテーション

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