Method: customers.reports.countInstalledApps

Genera un informe de las instalaciones de la app.

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

Parámetros
customer

string

Obligatorio. Es 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. La cantidad máxima y predeterminada es 100.
pageToken

string

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

string

Es la cadena de consulta para filtrar los resultados, con campos separados por AND en sintaxis de EBNF.

Nota: Las operaciones OR no se admiten en este filtro.

Campos de filtro admitidos:

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

string

Campo que se usa para ordenar los resultados.

Campos admitidos para ordenar:

  • nombre_de_la_app
  • 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

Es la respuesta que contiene detalles de las apps instaladas consultadas.

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

Es la cantidad total de apps instaladas que coinciden con la solicitud.

Permisos de autorización

Requiere el siguiente permiso 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. En el caso de las apps y extensiones de Chrome, es el ID de 32 caracteres (p.ej., ehoadneljpdggcbbknedodolkkjodefl). En el caso de las apps para Android, es el nombre del paquete (p.ej., com.evernote).
appType

enum (AppType)

Solo salida. Es el tipo de app.
browserDeviceCount

string (int64 format)

Solo salida. Es el recuento de dispositivos con navegador que tienen instalada esta app.
osUserCount

string (int64 format)

Solo salida. Es el recuento de usuarios de ChromeOS que tienen instalada esta app.
appInstallType

enum (AppInstallType)

Solo salida. Cómo se instaló la app.
disabled

boolean

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

enum (AppSource)

Solo salida. Es la fuente de la app instalada.
displayName

string

Solo salida. 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. Son los permisos de la app instalada.
riskAssessment

object (RiskAssessmentData)

Solo salida. Si está disponible, son los datos de la evaluación de riesgos sobre 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.

Enums
APP_INSTALL_TYPE_UNSPECIFIED No se especificó el tipo de instalación de la aplicación.
MULTIPLE Hay varios tipos de instalación de la app.
NORMAL Es el tipo de instalación normal de la app.
ADMIN Es el tipo de instalación de la app para administradores.
DEVELOPMENT Es el tipo de instalación de la app de desarrollo.
SIDELOAD Es el tipo de instalación de la app transferida.
OTHER Otro tipo de instalación de la app.

AppSource

Es la fuente de la app instalada.

Enums
APP_SOURCE_UNSPECIFIED No se especificó la fuente de la aplicación.
CHROME_WEBSTORE Generalmente, para extensiones y apps de Chrome.
PLAY_STORE App de Play Store

RiskAssessmentData

Son los datos de la 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)

Solo salida. Es el proveedor de la evaluación de riesgos del que proviene esta entrada.
riskAssessment

object (RiskAssessment)

Solo salida. Son los detalles de la evaluación de riesgos del proveedor.
riskLevel

enum (RiskLevel)

Solo salida. Es el nivel de riesgo agrupado para la evaluación de riesgos.

RiskAssessmentProvider

Proveedores de evaluación de riesgos

Enums
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.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Es la evaluación de riesgos de una extensión de Chrome.

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

string

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

string

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

string

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

RiskLevel

Es el nivel de riesgo agrupado para una extensión o una app.

Enums
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 riesgo alto.