API de Reports

La API de informes te permite generar informes que te proporcionan información agregada sobre tu implementación del navegador Chrome o tu dispositivo ChromeOS administrado.

Descripción general breve de los métodos de API

Las URLs se relacionan con https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER

Descripción URL relativa Método HTTP Parámetros de solicitud permitidos
Registrar los navegadores Chrome que requieren atención en tu dominio /reports:countChromeBrowsersNeedingAttention GET Opcional: orgUnitId
Registrar los dispositivos Chrome que alcanzan la fecha de vencimiento automática en tu dominio /reports:countChromeDevicesReachingAutoExpirationDate GET Opcional: orgUnitId, minAueDate, maxAueDate
Contar los dispositivos Chrome que requieren atención en tu dominio /reports:countChromeDevicesThatNeedAttention GET Opcional: orgUnitId, readMask
Contar los dispositivos de la flota de hardware de Chrome de tu dominio /reports:countChromeHardwareFleetDevices GET Opcional: orgUnitId, readMask
Contar las versiones de Chrome implementadas en los dispositivos de tu dominio /reports:countChromeVersions GET Opcional: orgUnitId, filter, pageSize, pageToken
Realiza un recuento de las apps informadas que se instalaron en tus dispositivos y navegadores /reports:countInstalledApps GET Opcional: orgUnitId, filter, pageSize, pageToken, orderBy
Obtener un resumen de las impresiones que realiza cada impresora de tu dominio /reports:countPrintJobsByPrinter GET Opcional: printOrgUnitId, filter, pageSize, pageToken, orderBy
Obtén un resumen de las impresiones que realiza cada usuario de tu dominio /reports:countPrintJobsByUser GET Opcional: printOrgUnitId, filter, pageSize, pageToken, orderBy
Obtener un informe detallado de los trabajos de impresión en tu dominio /reports:enumeratePrintJobs. GET Opcional: printOrgUnitId, filter, pageSize, pageToken, orderBy
Muestra una lista de los dispositivos en los que se instala una app en particular /reports:findInstalledAppDevices. GET Opcional: orgUnitId, filter, pageSize, pageToken, orderBy
Consultar un recuento de los eventos de fallas de Chrome /reports:countChromeCrashEvents GET Opcional: orgUnitId, filter, orderBy

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

Privilegios de administrador

La API de informes respeta la delegación de roles de administrador. En función de los informes que el administrador desee generar, se requieren diferentes privilegios de administrador.

Método Se requieren privilegios de administrador
countChromeBrowsersNeedingAttention "Servicios -> Administración de Chrome -> Ver el informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de estadísticas de Chrome"
countChromeDevicesReachingAutoExpirationDate "Servicios -> Administración de Chrome -> Ver el informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de estadísticas de Chrome"
countChromeDevicesThatNeedAttention "Servicios -> Administración de Chrome -> Ver el informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de estadísticas de Chrome"
countChromeHardwareFleetDevices "Servicios -> Administración de Chrome -> Ver el informe de estadísticas de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de estadísticas de Chrome"
countChromeVersions "Servicios -> Administración de Chrome -> Ver el informe de versiones de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver informe de las 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 el informe de las impresoras de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de las impresoras de Chrome"
countPrintJobsByUser "Servicios -> Administración de Chrome -> Ver el informe de las impresoras de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de las impresoras de Chrome"
enumeratePrintJobs "Servicios -> Administración de Chrome -> Ver el informe de las impresoras de Chrome"
o "Servicios -> ChromeOS -> Configuración -> Ver el informe de las 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"
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”.

Alcances de la API

La API de informes requiere el siguiente alcance de OAuth:

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

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