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 requête.

Paramètres de requête

Paramètres
orgUnitId

string

ID de l'unité organisationnelle.
pageSize

integer

Nombre maximal de résultats à renvoyer. La valeur maximale et par défaut est 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, champs séparés par AND dans la syntaxe EBNF.

Remarque: Les opérations OU ne sont pas acceptées dans 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
  • risk_score
orderBy

string

Champ utilisé pour classer les résultats.

Champs acceptés pour le tri:

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

Corps de la requête

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

Corps de la réponse

Réponse contenant des informations sur les 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
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
Champs
appId

string

Uniquement en sortie. Identifiant unique de l'application. Pour les applications et extensions Chrome, il s'agit d'un identifiant de 32 caractères (par exemple, ehoadneljpdggcbbknedodolkkjodefl). Pour les applications Android, le 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 d'appareils avec navigateur 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. Comment 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.
riskAssessment

object (RiskAssessmentData)

Uniquement en sortie. Si disponibles, les données d'évaluation des risques concernant cette extension.

AppInstallType

Comment 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 Le type d'installation de l'application n'est pas spécifié.
MULTIPLE Plusieurs types d'installation 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 en parallèle.
OTHER Autre type d'installation d'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 Application Play Store

RiskAssessmentData

Données d'évaluation des risques concernant une extension/une application

Représentation JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Champs
entries[]

object (RiskAssessmentEntry)

Évaluations des risques individuelles
overallRiskLevel

enum (RiskLevel)

Niveau de risque global évalué pour toutes les entrées. Il s'agit du niveau de risque le plus élevé de toutes les entrées.

RiskAssessmentEntry

Une entrée d'évaluation des risques.

Représentation JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Champs
provider

enum (RiskAssessmentProvider)

Fournisseur d'évaluation des risques à l'origine de cette entrée.
riskAssessment

object (RiskAssessment)

Détails de l'évaluation des risques du fournisseur.
riskLevel

enum (RiskLevel)

Niveau de risque groupé pour l'évaluation des risques.

RiskAssessmentProvider

Fournisseurs d'évaluation des risques

Enums
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Valeur par défaut lorsqu'aucun fournisseur n'est spécifié.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security

RiskAssessment

Évaluation des risques pour une extension Chrome

Représentation JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Champs
assessment

string

Évaluation des risques liés à l'extension. Actuellement, il s'agit d'une valeur numérique, dont l'interprétation est propre à chaque fournisseur d'évaluation des risques.
detailsUrl

string

URL permettant à l'utilisateur d'obtenir plus d'informations sur l'évaluation des risques.
version

string

Version de l'extension à laquelle cette évaluation s'applique.

RiskLevel

Niveau de risque d'une extension/application.

Enums
RISK_LEVEL_UNSPECIFIED Niveau de risque non spécifié.
RISK_LEVEL_LOW Extension présentant un faible risque
RISK_LEVEL_MEDIUM Extension présentant un risque moyen.
RISK_LEVEL_HIGH Extension présentant un risque élevé