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。

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 高いリスクを表す拡張機能。