Method: customers.reports.countInstalledApps

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
orderBy

string

Field used to order results.

Supported order by fields:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

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
  ]
}
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.

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.