Devices

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

リソース表記

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,
    "policyId": 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 が所有していません。有効な値は次のとおりです。 "`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 に接続されている場合にのみ自動更新を有効にします。指定できる値は次のとおりです。 "`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.policyId`	`string`	Google Play ストアから送信されるアプリのインストールフィードバックで渡されるポリシーの識別子。
`policy.productAvailabilityPolicy`	`string`	デバイスに付与されている、指定した商品の在庫状況。「all」承認ステータスに関係なく、すべてのデバイスにそのデバイスへのアクセスが許可されます。「all」では、「alpha」または「beta」トラックの自動公開は有効になりません。「whitelist」は、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`	アプリの最小バージョン。インストールされているアプリのバージョンがこれより低い場合、通常の自動更新を待たずに、自動インストールの制約に従ってアプリが自動更新されます。デバイスごとに最小バージョンコードを設定できるアプリは 20 個までです。
`policy.productPolicy[].autoUpdateMode`	`string`	商品の自動更新モード。`autoUpdateMode` を使用すると、ユーザーの選択よりも常に優先されます。そのため、ユーザーがデバイス設定を手動で変更しても、その変更は無視されます。指定できる値は次のとおりです。 "`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`	プレースホルダ文字列（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`	ブール値 - プロパティの型が 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: 前回のレポートの生成以降にデバイス上のアプリの状態に生じた変更を含むレポートをアップロードします。このメソッドは、特定のデバイスに対して 24 時間ごとに最大 3 回呼び出すことができます。
get: デバイスの詳細を取得します。
getState: Google サービスへのデバイスのアクセスが有効か、または有効かを取得します無効です。デバイスの状態が有効になるのは、Google 管理コンソールで Android デバイスに対する EMM ポリシーの適用が有効になっている場合のみです。それ以外の場合、デバイスの状態は無視され、すべてのデバイスにアクセス権が付与されます。 Google サービスに接続できますこれは Google 管理のユーザーでのみサポートされます。
list: ユーザーのすべてのデバイスの ID を取得します。
setState: デバイスの Google サービスへのアクセスを有効または無効にします。デバイスの状態が有効になるのは、Google 管理コンソールで Android デバイスに対する EMM ポリシーの適用が有効になっている場合のみです。それ以外の場合、デバイスの状態は無視され、すべてのデバイスにアクセス権が付与されます。 Google サービスに接続できますこれは、Google の管理対象ユーザーのみが使用できます。
update: デバイスポリシーを更新します。

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