Method: customers.reports.countInstalledApps

Genera un report sulle installazioni di app.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customer

string

Obbligatorio. ID cliente o "my_customer" per utilizzare il cliente associato all'account che effettua la richiesta.

Parametri di query

Parametri
orgUnitId

string

L'ID dell'unità organizzativa.
pageSize

integer

Il numero massimo di risultati da restituire. Il valore massimo e predefinito è 100.
pageToken

string

Token per specificare la pagina della richiesta da restituire.
filter

string

Stringa di query per filtrare i risultati, campi separati da AND nella sintassi EBNF.

Nota: le operazioni OR non sono supportate in questo filtro.

Campi filtro supportati:

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

string

Campo utilizzato per ordinare i risultati.

Campi di ordinamento supportati:

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

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta contenente i dettagli delle app installate sottoposte a query.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campi
installedApps[]

object (InstalledApp)

Elenco di app installate corrispondenti alla richiesta.
nextPageToken

string

Token per specificare la pagina successiva della richiesta.
totalSize

integer

Numero totale di app installate corrispondenti alla richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

InstalledApp

Descrive un'app installata.

Rappresentazione 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)
  }
}
Campi
appId

string

Solo output. Identificatore univoco dell'app. Per le app e le estensioni di Chrome, l'ID di 32 caratteri (ad es. ehoadneljpdggcbbknedodolkkjodefl). Per le app per Android, il nome del pacchetto (ad es. com.evernote).
appType

enum (AppType)

Solo output. Tipo di app.
browserDeviceCount

string (int64 format)

Solo output. Conteggio dei dispositivi browser su cui è installata questa app.
osUserCount

string (int64 format)

Solo output. Numero di utenti ChromeOS con questa app installata.
appInstallType

enum (AppInstallType)

Solo output. La modalità di installazione dell'app.
disabled

boolean

Solo output. Indica se l'app è disattivata.
appSource

enum (AppSource)

Solo output. Origine dell'app installata.
displayName

string

Solo output. Nome dell'app installata.
description

string

Solo output. Descrizione dell'app installata.
homepageUri

string

Solo output. URI della home page dell'app installata.
permissions[]

string

Solo output. Autorizzazioni dell'app installata.
riskAssessment

object (RiskAssessmentData)

Solo output. Se disponibili, i dati dell'analisi del rischio relativi a questa estensione.

AppInstallType

La modalità di installazione dell'app. Se non tutte le istanze di questa app installata hanno lo stesso tipo di installazione, il tipo di installazione è MULTIPLE.

Enum
APP_INSTALL_TYPE_UNSPECIFIED Tipo di installazione dell'applicazione non specificato.
MULTIPLE Più tipi di installazione di app.
NORMAL Tipo di installazione di app normale.
ADMIN Tipo di installazione dell'app di amministrazione.
DEVELOPMENT Tipo di installazione dell'app di sviluppo.
SIDELOAD Tipo di installazione di app caricate lateralmente.
OTHER Altro tipo di installazione dell'app.

AppSource

Origine dell'app installata.

Enum
APP_SOURCE_UNSPECIFIED Origine dell'applicazione non specificata.
CHROME_WEBSTORE In genere per estensioni e app di Chrome.
PLAY_STORE App Play Store.

RiskAssessmentData

Dati di valutazione del rischio relativi a un'estensione/app.

Rappresentazione JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Campi
entries[]

object (RiskAssessmentEntry)

Valutazioni del rischio individuali.
overallRiskLevel

enum (RiskLevel)

Livello di rischio complessivo valutato in tutte le voci. Si tratta del livello di rischio più elevato tra tutte le voci.

RiskAssessmentEntry

Una voce di valutazione del rischio.

Rappresentazione JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Campi
provider

enum (RiskAssessmentProvider)

Il fornitore di servizi di valutazione del rischio da cui proviene questa voce.
riskAssessment

object (RiskAssessment)

I dettagli della valutazione del rischio del fornitore.
riskLevel

enum (RiskLevel)

Il livello di rischio raggruppato per la valutazione del rischio.

RiskAssessmentProvider

Fornitori di servizi di valutazione del rischio.

Enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Valore predefinito quando non viene specificato alcun provider.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX Sicurezza LayerX.

RiskAssessment

Valutazione del rischio per un'estensione di Chrome.

Rappresentazione JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Campi
assessment

string

Valutazione del rischio per l'estensione. Attualmente, si tratta di un valore numerico la cui interpretazione è specifica per ogni fornitore di servizi di valutazione del rischio.
detailsUrl

string

Un URL a cui un utente può accedere per ulteriori informazioni sulla valutazione del rischio.
version

string

La versione dell'estensione a cui si applica questa valutazione.

RiskLevel

Livello di rischio raggruppato per un'estensione/app.

Enum
RISK_LEVEL_UNSPECIFIED Livello di rischio non specificato.
RISK_LEVEL_LOW Estensione che rappresenta un rischio basso.
RISK_LEVEL_MEDIUM Estensione che rappresenta un rischio medio.
RISK_LEVEL_HIGH Estensione che rappresenta un rischio elevato.