Method: customers.reports.countInstalledApps

Générer un rapport sur les installations d'applications

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Obligatoire. Numéro client ou "my_customer" pour utiliser le client associé au compte à l'origine de la demande.

Paramètres de requête

Paramètres
orgUnitId

string

ID de l'unité organisationnelle.

pageSize

integer

Nombre maximal de résultats sur une page. La valeur maximale et la valeur par défaut sont 100.

pageToken

string

Jeton permettant de spécifier la page de la requête à renvoyer.

filter

string

Chaîne de requête pour filtrer les résultats, et les champs séparés par ET (ET) dans une syntaxe EBNF.

Remarque: Les opérations OR ne sont pas prises en charge par ce filtre.

Champs de filtre compatibles:

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

string

Champ permettant de classer les résultats.

Ordre de tri accepté par champs:

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

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse contenant les détails des applications installées interrogées.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Champs
installedApps[]

object (InstalledApp)

Liste des applications installées correspondant à la requête.

nextPageToken

string

Jeton permettant de spécifier la page suivante de la requête.

totalSize

integer

Nombre total d'applications installées correspondant à la requête.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

InstalledApp

Décrit une application installée.

Représentation 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
  ]
}
Champs
appId

string

Uniquement en sortie. Identifiant unique de l'application. Pour les applications et les extensions Chrome, il s'agit de l'ID à 32 caractères (par exemple, ehoadneljpdggcbbknedodolkkjodefl). Pour les applications Android, il s'agit du nom du package (par exemple, com.evernote).

appType

enum (AppType)

Uniquement en sortie. Type de l'application.

browserDeviceCount

string (int64 format)

Uniquement en sortie. Nombre de navigateurs sur lesquels cette application est installée.

osUserCount

string (int64 format)

Uniquement en sortie. Nombre d'utilisateurs de ChromeOS ayant installé cette application.

appInstallType

enum (AppInstallType)

Uniquement en sortie. La manière dont l'application a été installée.

disabled

boolean

Uniquement en sortie. Indique si l'application est désactivée.

appSource

enum (AppSource)

Uniquement en sortie. Source de l'application installée.

displayName

string

Uniquement en sortie. Nom de l'application installée.

description

string

Uniquement en sortie. Description de l'application installée.

homepageUri

string

Uniquement en sortie. URI de la page d'accueil de l'application installée.

permissions[]

string

Uniquement en sortie. Autorisations de l'application installée.

AppInstallType

La manière dont l'application a été installée. Si toutes les instances de cette application installée n'ont pas le même type d'installation, le type d'installation est MULTIPLE.

Enums
APP_INSTALL_TYPE_UNSPECIFIED Type d'installation de l'application non spécifié.
MULTIPLE Plusieurs types d'installations d'applications
NORMAL Type d'installation d'application normal.
ADMIN Type d'installation de l'application administrateur
DEVELOPMENT Type d'installation de l'application de développement
SIDELOAD Type d'installation de l'application téléchargée indépendamment.
OTHER Autre type d'installation de l'application.

AppSource

Source de l'application installée.

Enums
APP_SOURCE_UNSPECIFIED Source de l'application non spécifiée.
CHROME_WEBSTORE Généralement pour les extensions et les applications Chrome.
PLAY_STORE l'application Play Store.