API de Reports

La API de informes te permite generar informes que te brindan información agregada sobre la implementación del navegador Chrome o tus dispositivos ChromeOS administrados.

Descripción general rápida de los métodos de la API

Las URLs son relativas a https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER

Descripción URL relativa Método HTTP Parámetros de solicitud permitidos
Cuenta los navegadores Chrome que necesitan atención en tu dominio /reports:countChromeBrowsersNeedingAttention GET Opcional: orgUnitId
Cuenta los dispositivos Chrome que se están acercando a la fecha de vencimiento automático en tu dominio /reports:countChromeDevicesReachingAutoExpirationDate GET Opcional: orgUnitId, minAueDate, maxAueDate
Cuenta los dispositivos Chrome que necesitan atención en tu dominio /reports:countChromeDevicesThatNeedAttention GET Opcional: orgUnitId, readMask
Cuenta los dispositivos de la flota de hardware de Chrome en tu dominio /reports:countChromeHardwareFleetDevices GET Opcional: orgUnitId, readMask
Cuenta las versiones de Chrome implementadas en los perfiles de tu dominio /reports:countChromeProfileVersions GET Opcional: orgUnitId, filter, pageSize, pageToken
Cuenta las versiones de Chrome implementadas en los dispositivos de tu dominio /reports:countChromeVersions GET Opcional: orgUnitId, filter, pageSize, pageToken
Cuenta las apps instaladas informadas en tus dispositivos y navegadores /reports:countInstalledApps GET Opcional: orgUnitId, filter, pageSize, pageToken, orderBy
Obtén un resumen de la impresión realizada por cada impresora de tu dominio /reports:countPrintJobsByPrinter GET Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy
Obtén un resumen de la impresión realizada por cada usuario de tu dominio /reports:countPrintJobsByUser GET Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy
Obtén un informe detallado de los trabajos de impresión en tu dominio /reports:enumeratePrintJobs GET Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy
Haz una lista de los dispositivos en los que está instalada una app en particular /reports:findInstalledAppDevices GET Opcional: orgUnitId, filter, pageSize, pageToken, orderBy
Haz una lista de los perfiles en los que está instalada una app en particular /reports:findInstalledAppProfiles GET Opcional: orgUnitId, filter, pageSize, pageToken, orderBy
Obtén un recuento de los eventos de falla de Chrome /reports:countChromeCrashEvents GET Opcional: orgUnitId, filter, orderBy

Consulta las muestras de código para ver ejemplos de solicitudes y respuestas.

Privilegios de administrador

La API de informes respeta la delegación de roles de administrador. Según los informes que el administrador quiera generar, se requieren diferentes privilegios de administrador.

Método Privilegios de administrador obligatorios
countChromeBrowsersNeedingAttention "Servicios -> Administración de Chrome -> Ver informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de estadísticas de Chrome"
countChromeDevicesReachingAutoExpirationDate "Servicios -> Administración de Chrome -> Ver informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de estadísticas de Chrome"
countChromeDevicesThatNeedAttention "Servicios -> Administración de Chrome -> Ver informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de estadísticas de Chrome"
countChromeHardwareFleetDevices "Servicios -> Administración de Chrome -> Ver informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de estadísticas de Chrome"
countChromeProfileVersions "Servicios -> Administración de Chrome -> Ver informe de versiones de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de versiones de Chrome"
countChromeVersions "Servicios -> Administración de Chrome -> Ver informe de versiones de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de versiones de Chrome"
countInstalledApps "Servicios -> Administración de Chrome -> Ver informe de lista de extensiones"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de lista de extensiones"
countPrintJobsByPrinter "Servicios -> Administración de Chrome -> Ver informe de impresoras de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de impresoras de Chrome"
countPrintJobsByUser "Servicios -> Administración de Chrome -> Ver informe de impresoras de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de impresoras de Chrome"
enumeratePrintJobs "Servicios -> Administración de Chrome -> Ver informe de impresoras de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de impresoras de Chrome"
findInstalledAppDevices "Servicios -> Administración de Chrome -> Ver informe de lista de extensiones"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de lista de extensiones"
findInstalledAppProfiles "Servicios -> Administración de Chrome -> Ver informe de lista de extensiones"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de lista de extensiones"
countChromeCrashEvents "Servicios -> Administración de Chrome -> Ver informe de fallas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de fallas de Chrome"

Para administrar los roles y privilegios de administrador, visita "Consola del administrador -> Roles de administrador".

Permisos de la API

La API de informes requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta la Descripción general de la autenticación.