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 à renvoyer. La valeur maximale 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 permettant de filtrer les résultats. Les champs sont séparés par un opérateur AND dans la syntaxe EBNF.

Remarque : Les opérations OR ne sont pas acceptées dans ce filtre.

Champs de filtre acceptés :

  • 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 trier les résultats.

Champs "order by" acceptés :

  • 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 de l'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 d'application.
browserDeviceCount

string (int64 format)

Uniquement en sortie. Nombre d'appareils de navigation 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. Mode d'installation de l'application.
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. Données d'évaluation des risques concernant cette extension, si disponibles.

AppInstallType

Mode d'installation de l'application. 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'installation d'applications.
NORMAL Type d'installation d'application normal.
ADMIN Type d'installation de l'application par l'administrateur.
DEVELOPMENT Type d'installation de l'application de développement.
SIDELOAD Type d'installation d'application transférée.
OTHER Autre type d'installation d'application.

AppSource

Source de l'application installée.

Enums
APP_SOURCE_UNSPECIFIED La source de l'application n'est pas 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 ou une application.

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

object (RiskAssessmentEntry)

Évaluations individuelles des risques.
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)

Uniquement en sortie. Fournisseur d'évaluation des risques dont provient cette entrée.
riskAssessment

object (RiskAssessment)

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

enum (RiskLevel)

Uniquement en sortie. Niveau de risque regroupé pour l'évaluation des risques.

RiskAssessmentProvider

Fournisseurs d'évaluations 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.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

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. Il s'agit actuellement d'une valeur numérique, et son interprétation est spécifique à chaque fournisseur d'évaluation des risques.
detailsUrl

string

URL vers laquelle un utilisateur peut accéder pour en savoir plus sur l'évaluation des risques.
version

string

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

RiskLevel

Niveau de risque par tranche pour une extension/application.

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