このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソース表記
デバイス リソースは、EMM によって管理され、特定の企業ユーザーに属するモバイル デバイスを表します。
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
androidId |
string |
デバイスの Google Play 開発者サービス Android ID を、小文字の 16 進文字列にエンコードしたもの。たとえば、"123456789abcdef0" です。 |
|
device |
string |
デバイスの内部ハードウェア コードネームです。これは android.os.Build.DEVICE の情報です。(logs/wireless/android/android_checkin.proto ごとの「device」という名前のフィールド) |
|
kind |
string |
||
latestBuildFingerprint |
string |
デバイスのビルドのフィンガープリント(わかっている場合)。 | |
maker |
string |
デバイスのメーカー。これは android.os.Build.MANUFACTURER の情報です。 |
|
managementType |
string |
さまざまなデプロイ構成において、managed Google Play EMM によってデバイスがどの程度制御されているかを示します。 有効な値は次のとおりです。
有効な値は次のとおりです。
|
|
model |
string |
デバイスのモデル名。これは android.os.Build.MODEL の情報です。 |
|
policy |
nested object |
デバイスに適用されるポリシー。 | |
policy.autoUpdatePolicy |
string |
デバイスでアプリの自動更新を適用できるタイミングを管理します。 推奨される代替方法: autoUpdateMode アプリごとに設定することで、更新頻度をより柔軟に調整できます。autoUpdateMode が AUTO_UPDATE_POSTPONED または AUTO_UPDATE_HIGH_PRIORITY に設定されている場合、autoUpdatePolicy は機能しません。「choiceToTheUser」を使用すると、デバイスのユーザーがアプリ アップデート ポリシーを設定できるようになります。「always」は自動更新を有効にします。「never」は自動更新を無効にします。「wifiOnly」は、デバイスが Wi-Fi に接続されている場合にのみ自動更新を有効にします。 有効な値は次のとおりです。
|
|
policy.deviceReportPolicy |
string |
デバイスから EMM にアプリの状態を報告するかどうかを指定します。デフォルト値は「deviceReportDisabled」です。
有効な値は次のとおりです。
|
|
policy.maintenanceWindow |
nested object |
フォアグラウンドで実行されるアプリを更新するタイミングを定義するメンテナンスの時間枠。 | |
policy.maintenanceWindow.durationMs |
long |
メンテナンスの時間枠(ミリ秒単位)。期間は 30 分~ 24 時間の範囲で指定してください。 | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
メンテナンスの時間枠の開始時刻(デバイスで深夜 0 時からのミリ秒単位)。時間帯は深夜 0 時まで続くことがあります。 | |
policy.productAvailabilityPolicy |
string |
指定した商品についてデバイスに付与されている在庫状況。「すべて」を指定すると、承認ステータスに関係なく、デバイスはすべての商品にアクセスできます。「all」を指定しても、「アルファ版」または「ベータ版」のトラックが自動的に表示されることはありません。「ホワイトリスト」は、productPolicy[] で指定された商品へのアクセスをデバイスに許可します。企業によって承認済みの商品、または以前に承認された商品(承認が取り消された商品)のみ、許可リストに登録できます。値を指定しない場合、ユーザーレベルで設定した空き情報がデフォルトで適用されます。 有効な値は次のとおりです。
|
|
policy.productPolicy[] |
list |
サービス ポリシーのリスト。サービス ポリシーを適用するには、productAvailabilityPolicy を WHITELIST または ALL に設定する必要があります。 |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
プロダクトの自動インストール ポリシー。 | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
アプリの自動インストールに関する制約。最大 1 つの制約を指定できます。 |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
充電状態の制約。
有効な値は次のとおりです。
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
デバイスのアイドル状態に関する制約。
有効な値は次のとおりです。
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
ネットワーク タイプの制約。 有効な値は次のとおりです。
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
自動インストール モード。設定しない場合、デフォルトで「doNotAutoInstall」になります。メンテナンスの時間枠の設定に関係なく、アプリは自動的にインストールされます。 有効な値は次のとおりです。
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
インストールの優先度。符号なし整数で指定します。数字が小さいほど優先度が高くなります。 | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
アプリの最小バージョン。これより前のバージョンのアプリがインストールされている場合、通常の自動更新を待つのではなく、自動インストールの制約に沿って自動更新されます。最小バージョン コードを設定できるアプリの数は、デバイスあたり 20 個までです。 | |
policy.productPolicy[].autoUpdateMode |
string |
商品の自動更新モード。autoUpdateMode が使用されると、常にユーザーの選択よりも優先されます。そのため、ユーザーがデバイス設定を手動で変更しても、その変更は無視されます。
有効な値は次のとおりです。
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
ID プロバイダの認証システムアプリの認証 URL 構成。これにより、Android WebView を使用する限定公開アプリでの認証中に、ID プロバイダの認証システムアプリを起動できます。認証システム アプリは、すでにデバイス上の認証 URL の デフォルト ハンドラになっています。 | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
認証用 URL。 | |
policy.productPolicy[].managedConfiguration |
nested object |
プロダクトの管理対象設定。 | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
管理対象設定プロファイルの ID と、ユーザーで定義された設定変数のセット(存在する場合)が含まれます。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
管理対象設定の ID。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
ユーザーに関連付けられた変数セット。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
EMM が定義するプレースホルダ文字列。 | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
ユーザーに固有のプレースホルダの値です。 | |
policy.productPolicy[].managedConfiguration.kind |
string |
非推奨です。 |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
この構成の管理対象プロパティのセット。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
プロパティを識別する一意のキー。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
ブール値 - プロパティの型がブール値の場合にのみ存在します。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
管理プロパティのバンドル - プロパティのタイプがバンドルの場合にのみ存在します。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
管理対象プロパティのリスト。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
プロパティのバンドルのリスト - プロパティの型が bundle_array である場合にのみ存在します。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
管理対象プロパティのリスト。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
整数値 - プロパティの型が整数の場合にのみ存在します。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
文字列値 - プロパティのタイプが文字列、選択、非表示の場合にのみ存在します。 | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
文字列値のリスト - プロパティの型が複数選択の場合にのみ存在します。 | |
policy.productPolicy[].managedConfiguration.productId |
string |
管理対象設定の対象となっているサービスの ID(例: app:com.google.android.gm)。 | |
policy.productPolicy[].productId |
string |
商品の ID。たとえば、"app:com.google.android.gm" です。 |
|
policy.productPolicy[].trackIds[] |
list |
指定した製品リリース トラック(trackIds で識別)にデバイスの公開設定を付与します。プロダクトのリリース トラックのリストを取得するには、Products.Get を呼び出します。 |
|
policy.productPolicy[].tracks[] |
list |
非推奨です。trackIds を代わりに使用してください。
|
|
product |
string |
デバイスのプロダクト名。これは android.os.Build.PRODUCT の情報です。 |
|
report |
nested object |
最新のアプリ状態に基づいて更新されたデバイス レポート。 | |
report.appState[] |
list |
デバイス上の管理対象アプリによって設定されたアプリ状態のリスト。アプリの状態は、アプリのデベロッパーが定義します。このフィールドは常に存在します。 | |
report.appState[].keyedAppState[] |
list |
キー付きのアプリ状態のリスト。このフィールドは常に存在します。 | |
report.appState[].keyedAppState[].data |
string |
機械で読み取り可能なデータを対象とした追加フィールド。たとえば、数値や JSON オブジェクトです。XSS を回避するため、データを表示する前にデータから HTML をすべて削除することをおすすめします。 | |
report.appState[].keyedAppState[].key |
string |
アプリが何に対して状態を提供しているかを示すキー。キーの内容はアプリのデベロッパーが設定します。XSS を回避するには、キーを表示する前にすべての HTML をキーから削除することをおすすめします。このフィールドは常に存在します。 | |
report.appState[].keyedAppState[].message |
string |
アプリの状態を説明する自由形式の人が読める形式のメッセージ。(エラー メッセージなど)。XSS を回避するには、メッセージを表示する前に HTML を削除することをおすすめします。 | |
report.appState[].keyedAppState[].severity |
string |
アプリの状態の重大度。このフィールドは常に存在します。 有効な値は次のとおりです。
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
アプリが状態を設定したときのタイムスタンプ(エポックからのミリ秒単位)。このフィールドは常に存在します。 | |
report.appState[].packageName |
string |
アプリのパッケージ名。このフィールドは常に存在します。 | |
report.lastUpdatedTimestampMillis |
long |
最後のレポート更新のタイムスタンプ(エポックからの時間、ミリ秒単位)。このフィールドは常に存在します。 | |
retailBrand |
string |
デバイスの小売ブランド(設定されている場合)。android.os.Build.BRAND に関する説明をご覧ください。 |
|
sdkVersion |
integer |
API 互換性バージョン。 |
Methods
- forceReportUpload
- 前回のレポートが生成された後に発生したデバイス上のアプリの状態の変化を含むレポートをアップロードします。1 つのデバイスで 24 時間ごとに 3 回まで、このメソッドを呼び出すことができます。
- get
- デバイスの詳細を取得します。
- getState
- Google サービスへのデバイスのアクセスが有効か無効かを取得します。デバイスの状態は、Google 管理コンソールで Android デバイスへの EMM ポリシーの適用が有効になっている場合にのみ有効になります。それ以外の場合、デバイスの状態は無視され、すべてのデバイスが Google サービスへのアクセスが許可されます。これは、Google が管理するユーザーのみが使用できます。
- list
- ユーザーのすべてのデバイスの ID を取得します。
- setState
- Google サービスへのデバイスのアクセスを有効にするか無効にするかを設定します。 デバイスの状態は、Google 管理コンソールで Android デバイスへの EMM ポリシーの適用が有効になっている場合にのみ有効になります。それ以外の場合、デバイスの状態は無視され、すべてのデバイスが Google サービスへのアクセスが許可されます。これは、Google が管理するユーザーのみが使用できます。
- update
- デバイス ポリシーを更新します。
ポリシーを適切に適用するには、Google Play パッケージの managed 構成でallowed_accounts
を設定して、管理対象外のアカウントから Google Play にアクセスできないようにする必要があります。Google Play でのアカウント制限についての説明をご覧ください。