Method: customers.reports.countInstalledApps

Genera un informe de las instalaciones de la aplicación.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customer

string

Obligatorio. El ID de cliente o "my_customer" para usar el cliente asociado a la cuenta que realiza la solicitud

Parámetros de consulta

Parámetros
orgUnitId

string

Es el ID de la unidad organizativa.
pageSize

integer

Cantidad máxima de resultados que se mostrarán. El valor máximo y predeterminado es 100.
pageToken

string

Es un token para especificar la página de la solicitud que se mostrará.
filter

string

Cadena de consulta para filtrar resultados, campos separados por Y en sintaxis EBNF.

Nota: Este filtro no admite las operaciones OR.

Campos de filtro 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

Es el campo que se usa para ordenar los resultados.

Campos de orden admitidos:

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta que contiene detalles de las aplicaciones instaladas que se consultaron.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campos
installedApps[]

object (InstalledApp)

Es la lista de apps instaladas que coinciden con la solicitud.
nextPageToken

string

Es un token para especificar la siguiente página de la solicitud.
totalSize

integer

Cantidad total de apps instaladas que coinciden con la solicitud.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

InstalledApp

Describe una app instalada.

Representación 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)
  }
}
Campos
appId

string

Solo salida. Es el identificador único de la app. Para las apps y extensiones de Chrome, es el ID de 32 caracteres (p.ej., ehoadneljpdggcbbknedodolkkjodefl). En el caso de las apps para Android, el nombre del paquete (p.ej., com.evernote).
appType

enum (AppType)

Solo salida. Tipo de app.
browserDeviceCount

string (int64 format)

Solo salida. Cantidad de dispositivos de navegador que tienen instalada esta app.
osUserCount

string (int64 format)

Solo salida. Recuento de usuarios de ChromeOS que tienen esta app instalada.
appInstallType

enum (AppInstallType)

Solo salida. Indica cómo se instaló la app.
disabled

boolean

Solo salida. Indica si la app está inhabilitada.
appSource

enum (AppSource)

Solo salida. Fuente de la app instalada.
displayName

string

Solo salida. Es el nombre de la app instalada.
description

string

Solo salida. Es la descripción de la app instalada.
homepageUri

string

Solo salida. Es el URI de la página principal de la app instalada.
permissions[]

string

Solo salida. Permisos de la app instalada.
riskAssessment

object (RiskAssessmentData)

Solo salida. Si están disponibles, los datos de evaluación de riesgos de esta extensión.

AppInstallType

Cómo se instaló la app Si no todas las instancias de esta app instalada tienen el mismo tipo de instalación, el tipo de instalación es MULTIPLE.

Enumeraciones
APP_INSTALL_TYPE_UNSPECIFIED No se especificó el tipo de instalación de la aplicación.
MULTIPLE Varios tipos de instalación de apps
NORMAL Es el tipo de instalación de app normal.
ADMIN Tipo de instalación de app de administrador.
DEVELOPMENT Tipo de instalación de la app de desarrollo.
SIDELOAD Tipo de instalación de la app transferida.
OTHER Otro tipo de instalación de app.

AppSource

Fuente de la app instalada.

Enumeraciones
APP_SOURCE_UNSPECIFIED No se especificó la fuente de la aplicación.
CHROME_WEBSTORE Por lo general, para extensiones y apps de Chrome.
PLAY_STORE app de Play Store.

RiskAssessmentData

Datos de evaluación de riesgos sobre una extensión o app

Representación JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Campos
entries[]

object (RiskAssessmentEntry)

Evaluaciones de riesgos individuales
overallRiskLevel

enum (RiskLevel)

Es el nivel de riesgo general evaluado en todas las entradas. Este será el nivel de riesgo más alto de todas las entradas.

RiskAssessmentEntry

Una entrada de evaluación de riesgos

Representación JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Campos
provider

enum (RiskAssessmentProvider)

El proveedor de evaluación de riesgos del que proviene esta entrada.
riskAssessment

object (RiskAssessment)

Los detalles de la evaluación de riesgos del proveedor.
riskLevel

enum (RiskLevel)

El nivel de riesgo agrupado para la evaluación de riesgos.

RiskAssessmentProvider

Proveedores de evaluación de riesgos

Enumeraciones
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Es el valor predeterminado cuando no se especifica ningún proveedor.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.AI.

RiskAssessment

Evaluación de riesgos de una extensión de Chrome

Representación JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Campos
assessment

string

Evaluación de riesgos de la extensión Actualmente, este es un valor numérico, y su interpretación es específica de cada proveedor de evaluación de riesgos.
detailsUrl

string

Es una URL a la que un usuario puede navegar para obtener más información sobre la evaluación de riesgos.
version

string

Es la versión de la extensión a la que se aplica esta evaluación.

RiskLevel

Nivel de riesgo agrupado de una extensión o app.

Enumeraciones
RISK_LEVEL_UNSPECIFIED No se especificó el nivel de riesgo.
RISK_LEVEL_LOW Extensión que representa un riesgo bajo.
RISK_LEVEL_MEDIUM Extensión que representa un riesgo medio.
RISK_LEVEL_HIGH Extensión que representa un alto riesgo.