Method: customers.reports.countInstalledApps

Générez 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 sur une page. 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 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
  • 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 ID de 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 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. 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.
riskAssessment

object (RiskAssessmentData)

Uniquement en sortie. Le cas échéant, les données d'évaluation des risques concernant cette extension.

AppInstallType

La 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 de l'application téléchargée en parallèle.
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.

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é parmi 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 d'où provient cette entrée.
riskAssessment

object (RiskAssessment)

Détails de l'évaluation des risques effectuée par le 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

RiskAssessment

Évaluation des risques pour une extension Chrome.

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

string

Évaluation des risques pour l'extension. Actuellement, il s'agit d'une valeur numérique, et son 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 segmenté pour 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 qui représente un risque moyen.
RISK_LEVEL_HIGH Extension présentant un risque élevé