Method: customers.reports.countInstalledApps

アプリのインストールに関するレポートを生成します。

HTTP リクエスト

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countInstalledApps

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customer

string

必須。リクエストを行うアカウントに関連付けられている顧客を使用する場合は、顧客 ID または「my_customer」。

クエリ パラメータ

パラメータ
orgUnitId

string

組織部門の ID。
pageSize

integer

ページあたりの結果数の上限です。デフォルト値は 100 で、これは指定できる最大の値です。
pageToken

string

返されるリクエストのページを指定するトークン。
filter

string

結果をフィルタするクエリ文字列。EBNF 構文の AND 区切りフィールド。

注: このフィルタでは OR 演算はサポートされていません。

サポートされているフィルタ フィールド:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • risk_score
orderBy

string

結果の並べ替えに使用されるフィールド。

サポートされている並べ替えフィールド:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

クエリされたインストール済みアプリの詳細を含むレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
フィールド
installedApps[]

object (InstalledApp)

リクエストに一致するインストール済みアプリのリスト。
nextPageToken

string

リクエストの次のページを指定するトークン。
totalSize

integer

リクエストに一致するインストール済みアプリの合計数。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

InstalledApp

インストール済みのアプリについて説明します。

JSON 表現 
{
  "appId": string,
  "appType": enum (AppType),
  "browserDeviceCount": string,
  "osUserCount": string,
  "appInstallType": enum (AppInstallType),
  "disabled": boolean,
  "appSource": enum (AppSource),
  "displayName": string,
  "description": string,
  "homepageUri": string,
  "permissions": [
    string
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
フィールド
appId

string

出力専用。アプリの固有識別子。Chrome アプリと拡張機能の場合は、32 文字の ID（例: ehoadneljpdggcbbknedodolkkjodefl）。Android アプリの場合はパッケージ名（例: com.evernote）。
appType

enum (AppType)

出力専用。アプリのタイプ。
browserDeviceCount

string (int64 format)

出力専用。このアプリがインストールされているブラウザ デバイスの数。
osUserCount

string (int64 format)

出力専用。このアプリをインストールしている ChromeOS ユーザーの数。
appInstallType

enum (AppInstallType)

出力専用。アプリのインストール方法。
disabled

boolean

出力専用。アプリが無効かどうか。
appSource

enum (AppSource)

出力専用。インストール済みのアプリのソース。
displayName

string

出力専用。インストール済みのアプリの名前。
description

string

出力専用。インストール済みのアプリの説明。
homepageUri

string

出力専用。インストール済みのアプリのホームページ URI。
permissions[]

string

出力専用。インストール済みのアプリの権限。
riskAssessment

object (RiskAssessmentData)

出力専用。この拡張機能に関するリスク評価データ（利用可能な場合）。

AppInstallType

アプリのインストール方法。インストールされているこのアプリのすべてのインスタンスのインストール タイプが同じでない場合、インストール タイプは MULTIPLE になります。

列挙型
APP_INSTALL_TYPE_UNSPECIFIED アプリのインストール タイプが指定されていません。
MULTIPLE 複数のアプリ インストール タイプ。
NORMAL 通常のアプリのインストール タイプ。
ADMIN 管理者アプリのインストール タイプ。
DEVELOPMENT 開発アプリのインストール タイプ。
SIDELOAD サイドローディングされたアプリのインストール タイプ。
OTHER その他のアプリのインストール タイプ。

AppSource

インストール済みのアプリのソース。

列挙型
APP_SOURCE_UNSPECIFIED アプリケーション ソースが指定されていません。
CHROME_WEBSTORE 通常は拡張機能と Chrome アプリ用です。
PLAY_STORE Google Play ストア アプリ。

RiskAssessmentData

拡張機能/アプリのリスク評価データ。

JSON 表現 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
フィールド
entries[]

object (RiskAssessmentEntry)

個々のリスク評価。
overallRiskLevel

enum (RiskLevel)

すべてのエントリで評価された全体的なリスクレベル。これが、すべてのエントリの中で最も高いリスクレベルになります。

RiskAssessmentEntry

リスク評価エントリ 1 つ。

JSON 表現 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
フィールド
provider

enum (RiskAssessmentProvider)

出力専用。このエントリの作成元であるリスク評価プロバイダ。
riskAssessment

object (RiskAssessment)

出力専用。プロバイダのリスク評価の詳細。
riskLevel

enum (RiskLevel)

出力専用。リスク評価のバケット化されたリスクレベル。

RiskAssessmentProvider

リスク評価プロバイダ。

列挙型
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED プロバイダが指定されていない場合のデフォルト値。
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator。
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai。
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security。
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Chrome 拡張機能のリスク評価。

JSON 表現 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
フィールド
assessment

string

拡張機能のリスク評価。現在、これは数値であり、その解釈はリスク評価プロバイダごとに異なります。
detailsUrl

string

ユーザーがリスク評価の詳細を確認できる URL。
version

string

この評価が適用される拡張機能のバージョン。

RiskLevel

拡張機能/アプリのリスクレベルをバケット化します。

列挙型
RISK_LEVEL_UNSPECIFIED リスクレベルが指定されていません。
RISK_LEVEL_LOW リスクが低いことを示す拡張機能。
RISK_LEVEL_MEDIUM 中程度のリスクを表す拡張機能。
RISK_LEVEL_HIGH 高リスクを表す拡張機能。