Method: customers.reports.countInstalledApps

  • The countInstalledApps method generates a report of app installations using a GET HTTP request to a specified URL with customer as a required path parameter.

  • Query parameters allow filtering and ordering the results based on various app properties like name, type, install type, number of permissions, total install count, latest profile active date, permission name, app ID, manifest versions, and risk score.

  • The response body, if successful, contains a list of InstalledApp objects with details such as app ID, type, install counts, install type, source, display name, description, homepage URI, permissions, and risk assessment data.

  • Risk assessment data for an installed app includes individual risk assessment entries from different providers, their details, and an overall risk level (Low, Medium, High) for the extension or app.

Generate report of app installations.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. Customer id or "my_customer" to use the customer associated to the account making the request.

Query parameters

Parameters
orgUnitId

string

The ID of the organizational unit.
pageSize

integer

Maximum number of results to return. Maximum and default are 100.
pageToken

string

Token to specify the page of the request to be returned.
filter

string

Query string to filter results, AND-separated fields in EBNF syntax.

Note: OR operations are not supported in this filter.

Supported filter fields:

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

string

Field used to order results.

Supported order by fields:

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

Request body

The request body must be empty.

Response body

Response containing details of queried installed apps.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Fields
installedApps[]

object (InstalledApp)

List of installed apps matching request.
nextPageToken

string

Token to specify the next page of the request.
totalSize

integer

Total number of installed apps matching request.

Authorization scopes

Requires the following OAuth scope:

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

InstalledApp

Describes an installed app.

JSON representation 
{
  "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)
  }
}
Fields
appId

string

Output only. Unique identifier of the app. For Chrome apps and extensions, the 32-character id (e.g. ehoadneljpdggcbbknedodolkkjodefl). For Android apps, the package name (e.g. com.evernote).
appType

enum (AppType)

Output only. Type of the app.
browserDeviceCount

string (int64 format)

Output only. Count of browser devices with this app installed.
osUserCount

string (int64 format)

Output only. Count of ChromeOS users with this app installed.
appInstallType

enum (AppInstallType)

Output only. How the app was installed.
disabled

boolean

Output only. Whether the app is disabled.
appSource

enum (AppSource)

Output only. Source of the installed app.
displayName

string

Output only. Name of the installed app.
description

string

Output only. Description of the installed app.
homepageUri

string

Output only. Homepage uri of the installed app.
permissions[]

string

Output only. Permissions of the installed app.
riskAssessment

object (RiskAssessmentData)

Output only. If available, the risk assessment data about this extension.

AppInstallType

How the app was installed. If not all instances of this installed app have the same install type, then the install type is MULTIPLE.

Enums
APP_INSTALL_TYPE_UNSPECIFIED Application install type not specified.
MULTIPLE Multiple app install types.
NORMAL Normal app install type.
ADMIN Administrator app install type.
DEVELOPMENT Development app install type.
SIDELOAD Sideloaded app install type.
OTHER Other app install type.

AppSource

Source of the installed app.

Enums
APP_SOURCE_UNSPECIFIED Application source not specified.
CHROME_WEBSTORE Generally for extensions and Chrome apps.
PLAY_STORE Play Store app.

RiskAssessmentData

Risk assessment data about an extension/app.

JSON representation 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Fields
entries[]

object (RiskAssessmentEntry)

Individual risk assessments.
overallRiskLevel

enum (RiskLevel)

Overall assessed risk level across all entries. This will be the highest risk level from all entries.

RiskAssessmentEntry

One risk assessment entry.

JSON representation 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Fields
provider

enum (RiskAssessmentProvider)

The risk assessment provider from which this entry comes from.
riskAssessment

object (RiskAssessment)

The details of the provider's risk assessment.
riskLevel

enum (RiskLevel)

The bucketed risk level for the risk assessment.

RiskAssessmentProvider

Risk assessment providers.

Enums
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Default value when no provider is specified.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.

RiskAssessment

Risk assessment for a Chrome extension.

JSON representation 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Fields
assessment

string

Risk assessment for the extension. Currently, this is a numerical value, and its interpretation is specific to each risk assessment provider.
detailsUrl

string

A URL that a user can navigate to for more information about the risk assessment.
version

string

The version of the extension that this assessment applies to.

RiskLevel

Bucketed risk level for an extension/app.

Enums
RISK_LEVEL_UNSPECIFIED Risk level not specified.
RISK_LEVEL_LOW Extension that represents a low risk.
RISK_LEVEL_MEDIUM Extension that represents a medium risk.
RISK_LEVEL_HIGH Extension that represents a high risk.