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 "mio_cliente" per utilizzare il cliente associato all'account che ha effettuato la richiesta.

Parametri di query

Parametri
orgUnitId

string

L'ID dell'unità organizzativa.

pageSize

integer

Numero massimo di risultati da restituire. Il valore massimo e quello predefinito sono 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
orderBy

string

Campo utilizzato per ordinare i risultati.

Campi supportati per l'ordine per:

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

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta contenente i dettagli delle app installate per cui è stata eseguita la 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 che corrispondono 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
  ]
}
Campi
appId

string

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

appType

enum (AppType)

Solo output. Tipo di app.

browserDeviceCount

string (int64 format)

Solo output. Numero di dispositivi browser su cui è installata questa app.

osUserCount

string (int64 format)

Solo output. Numero di utenti di ChromeOS che hanno installato questa app.

appInstallType

enum (AppInstallType)

Solo output. Come è stata installata l'app.

disabled

boolean

Solo output. Indica se l'app è disabilitata.

appSource

enum (AppSource)

Solo output. L'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.

AppInstallType

Come è stata installata l'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 da parte dell'amministratore.
DEVELOPMENT Tipo di installazione di app di sviluppo.
SIDELOAD Tipo di installazione di app trasferita tramite sideload.
OTHER Altro tipo di installazione di app.

AppSource

L'origine dell'app installata.

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