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. Identifiant 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 permettant de filtrer les résultats, champs séparés par l'opérateur ET dans la syntaxe EBNF.

Remarque: Les opérations OR ne sont pas compatibles avec ce filtre.

Champs de filtre compatibles:

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

string

Champ utilisé pour classer les résultats.

Champs "Trier par" acceptés:

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

Corps de la requête

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

Corps de la réponse

Réponse contenant des détails sur les applications installées qui ont fait l'objet d'une requête.

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 demande.

nextPageToken

string

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

totalSize

integer

Nombre total d'applications installées correspondant à la demande.

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, l'identifiant à 32 caractères (ehoadneljpdggcbbknedodolkkjodefl, par exemple). Pour les applications Android : nom du package (par exemple, com.evernote).

appType

enum (AppType)

Uniquement en sortie. Type d'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 ChromeOS ayant installé cette application.

appInstallType

enum (AppInstallType)

Uniquement en sortie. Façon 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

Façon 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 d'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 Il est généralement destiné aux extensions et aux applications Chrome.
PLAY_STORE l'application Play Store.