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

Parametri di ricerca

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
orderBy

string

Campo utilizzato per ordinare i risultati.

Ordine supportato per campi:

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

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta contenente i dettagli delle app installate oggetto della 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)

Richiesta di corrispondenza dell'elenco delle app installate.

nextPageToken

string

Token per specificare la pagina successiva della richiesta.

totalSize

integer

Richiesta corrispondente al numero totale di app installate.

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 per 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 con questa app installata.

appInstallType

enum (AppInstallType)

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

AppInstallType

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 dell'app normale.
ADMIN Tipo di installazione app dell'amministratore.
DEVELOPMENT Tipo di installazione dell'app di sviluppo.
SIDELOAD Tipo di installazione dell'app con sideload.
OTHER Altro tipo di installazione di app.

AppSource

Origine dell'app installata.

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