Devices

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表記

デバイス リソースは、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	小文字の 16 進数文字列でエンコードされたデバイスの Google Play 開発者サービス Android ID。たとえば、"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 によってどの程度制御されているかを示します。 有効な値は次のとおりです。 「managedDevice」は、EMM の Device Policy Controller（DPC）をデバイス所有者として持つデバイスです。 「managedProfile」は、DPC が利用できない別の個人用プロファイルに加えて、DPC が管理するプロファイル（DPC はプロファイル所有者）があるデバイスです。 「containerApp」は使用されなくなりました（非推奨）。 「unmanagedProfile」は managed Google Play の使用を（ドメイン管理者が管理コンソールを使用して権限を有効にして）許可されていますが、プロファイル自体が DPC が所有していません。 で確認できます。 指定できる値は次のとおりです。 <ph type="x-smartling-placeholder"> </ph> "containerApp" "managedDevice" "managedProfile" 「unmanagedProfile」
model	string	デバイスのモデル名。これは android.os.Build.MODEL から取得されます。
policy	nested object	デバイスに適用されているポリシー。
policy.autoUpdatePolicy	string	デバイスでアプリの自動更新を適用できるタイミングを制御します。 推奨される代替手段: autoUpdateMode はアプリごとに設定され、更新頻度をより柔軟に設定できます。 autoUpdateMode が AUTO_UPDATE_POSTPONED または AUTO_UPDATE_HIGH_PRIORITY に設定されている場合、autoUpdatePolicy の効果はありません。 「choiceToTheUser」デバイスのユーザーがアプリのアップデート ポリシーを設定できるようになります。「常時」自動更新が有効になります。「never」自動更新を無効にします。「wifiOnly」デバイスが Wi-Fi に接続されている場合にのみ自動更新を有効にします。 指定できる値は次のとおりです。 <ph type="x-smartling-placeholder"> </ph> "always" "choiceToTheUser" "never" 「wifiOnly」
policy.deviceReportPolicy	string	デバイスがアプリの状態を EMM に報告するかどうか。デフォルト値は「deviceReportDisabled」です。 有効な値は次のとおりです。 "deviceReportDisabled" 「deviceReportEnabled」
policy.maintenanceWindow	nested object	フォアグラウンドで実行されているアプリを更新する必要があるタイミングを定義する、メンテナンスの時間枠。
policy.maintenanceWindow.durationMs	long	メンテナンスの時間枠の長さ（ミリ秒単位）。期間は 30 分～ 24 時間の範囲で指定してください。
policy.maintenanceWindow.startTimeAfterMidnightMs	long	デバイスのメンテナンスの時間枠の開始時刻（深夜 0 時からのミリ秒数）。午前 0 時をまたぐこともあります。
policy.productAvailabilityPolicy	string	デバイスに付与されている、指定した商品の在庫状況。「all」承認ステータスに関係なく、すべてのデバイスにそのデバイスへのアクセスが許可されます。「all」「alpha」の自動公開が有効にならないまたは「beta」あります。"ホワイトリスト"productPolicy[] で指定されたプロダクトへのアクセス権をデバイスに付与します。許可リストに登録できるのは、承認された商品、または企業によって以前に承認された商品（承認が取り消された商品）のみです。値を指定しない場合、ユーザーレベルで設定された可用性がデフォルトで適用されます。 有効な値は次のとおりです。 "all" 「whitelist」
policy.productPolicy[]	list	サービス ポリシーのリスト。サービス ポリシーを適用するには、productAvailabilityPolicy を WHITELIST または ALL に設定する必要があります。
policy.productPolicy[].autoInstallPolicy	nested object	プロダクトの自動インストール ポリシー。
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]	list	アプリの自動インストールに関する制約。最大 1 つの制約を指定できます。
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint	string	充電状態の制約。 有効な値は次のとおりです。 "chargingNotRequired" 「chargingRequired」
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint	string	デバイスのアイドル状態の制約。 有効な値は次のとおりです。 "deviceIdleNotRequired" 「deviceIdleRequired」
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint	string	ネットワーク タイプの制約。 有効な値は次のとおりです。 "anyNetwork" 「unmeteredNetwork」
policy.productPolicy[].autoInstallPolicy.autoInstallMode	string	自動インストール モード。設定しない場合、デフォルトの「doNotAutoInstall」になります。アプリは、設定されたメンテナンスの時間枠に関係なく自動的にインストールされます。 有効な値は次のとおりです。 "autoInstallOnce" "doNotAutoInstall" 「forceAutoInstall」
policy.productPolicy[].autoInstallPolicy.autoInstallPriority	integer	インストールの優先度（符号なし整数）。値が小さいほど優先度が高くなります。
policy.productPolicy[].autoInstallPolicy.minimumVersionCode	integer	アプリの最小バージョン。これより前のバージョンのアプリがインストールされている場合は、通常の自動更新を待つのではなく、自動インストールの制約に従ってアプリが自動更新されます。最小バージョン コードの設定が可能なアプリの数は、デバイス 1 台につき最大 20 個です。
policy.productPolicy[].autoUpdateMode	string	商品の自動更新モード。autoUpdateMode を使用する場合、ユーザーの選択よりも常に優先されます。そのため、ユーザーがデバイス設定を手動で変更しても、その変更は無視されます。 指定できる値は次のとおりです。 <ph type="x-smartling-placeholder"> </ph> "autoUpdateDefault" "autoUpdateHighPriority" 「autoUpdatePostponed」
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	プレースホルダの文字列。です。
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	ブール値 - プロパティの型が bool の場合のみ存在します。
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	アプリの状態の重大度。このフィールドは常に存在します。 有効な値は次のとおりです。 "severityError" 「severityInfo」
report.appState[].keyedAppState[].stateTimestampMillis	long	アプリが状態を設定したときのタイムスタンプ（エポックからのミリ秒単位）。このフィールドは常に存在します。
report.appState[].packageName	string	アプリのパッケージ名。このフィールドは常に存在します。
report.lastUpdatedTimestampMillis	long	最後のレポート更新のタイムスタンプ（エポックからのミリ秒）。このフィールドは常に存在します。
retailBrand	string	デバイスの小売ブランド（設定されている場合）。android.os.Build.BRAND に関する説明をご覧ください。
sdkVersion	integer	API 互換性バージョン。

メソッド

forceReportUpload

次の日付以降に、デバイス上のアプリの状態の変化を含むレポートをアップロードします。 最後のレポートの生成日までですこのメソッドは、 1 台のデバイスで 24 時間です。

get

デバイスの詳細を取得します。

getState

Google サービスへのデバイスのアクセスが有効か、または有効かを取得します 無効です。 デバイスの状態は、Android で EMM ポリシーを適用した場合にのみ有効になります Google 管理コンソールで有効にできます。 それ以外の場合、デバイスの状態は無視され、すべてのデバイスにアクセス権が付与されます Google サービスに接続できます これは、Google が管理するユーザーに対してのみサポートされます。

list

ユーザーのすべてのデバイスの ID を取得します。

setState

Google サービスへのデバイスのアクセスを有効にするか無効にするかを設定します。 デバイスの状態は、Android で EMM ポリシーを適用した場合にのみ有効になります Google 管理コンソールで有効にできます。 それ以外の場合、デバイスの状態は無視され、すべてのデバイスにアクセス権が付与されます Google サービスに接続できます これは、Google が管理するユーザーに対してのみサポートされます。

update

デバイス ポリシーを更新します。

ポリシーを適切に適用するには、管理対象外の Google Play にアクセスできないようにするために、 Google Cloud の管理対象設定の allowed_accounts Play パッケージ。制限をご覧ください 。