Com a API Reports, é possível gerar relatórios que incluem informações agregadas sobre a implantação do seu dispositivo ChromeOS / navegador Chrome gerenciado.
Visão geral rápida dos métodos da API
Os URLs são relativos a https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Descrição | URL relativo | Método HTTP | Parâmetros de solicitação permitidos |
|---|---|---|---|
| Contar navegadores Chrome que precisam de atenção no seu domínio | /reports:countChromeBrowsersNeedingAttention | GET | Opcional: orgUnitId |
| Contar os dispositivos Chrome que estão chegando à data de expiração automática no seu domínio | /reports:countChromeDevicesReachingAutoExpirationDate | GET | Opcional: orgUnitId, minAueDate, maxAueDate |
| Contar dispositivos Chrome que precisam de atenção no seu domínio | /reports:countChromeDevicesThatNeedAttention | GET | Opcional: orgUnitId, readMask |
| Contar dispositivos da frota de hardware Chrome no seu domínio | /reports:countChromeHardwareFleetDevices | GET | Opcional: orgUnitId, readMask |
| Contar versões do Chrome implantadas em dispositivos no seu domínio | /reports:countChromeVersions | GET | Opcional: orgUnitId, filter, pageSize, pageToken |
| Contar os apps instalados nos seus dispositivos e navegadores | /reports:countInstalledApps | GET | Opcional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Receber um resumo das impressões feitas por cada impressora no seu domínio | /reports:countPrintJobsByPrinter | GET | Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Receber um resumo das impressões feitas por cada usuário no seu domínio | /reports:countPrintJobsByUser | GET | Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Receber um relatório detalhado dos trabalhos de impressão no seu domínio | /reports:enumeratePrintJobs | GET | Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Listar os dispositivos em que um app específico está instalado | /reports:findInstalledAppDevices | GET | Opcional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Listar os perfis em que um app específico está instalado | /reports:findInstalledAppProfiles | GET | Opcional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Receber uma contagem de eventos de falha do Chrome | /reports:countChromeCrashEvents | GET | Opcional: orgUnitId, filter, orderBy |
Consulte exemplos de código para ver exemplos de solicitações e respostas.
Privilégios de admin
A API Reports respeita a delegação de função de administrador. Dependendo dos relatórios que o administrador quer gerar, são necessários privilégios diferentes.
| Método | Privilégios de administrador necessários |
|---|---|
| countChromeBrowsersNeedingAttention | "Serviços -> Gerenciamento do Chrome -> Ver relatório de insights do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de insights do Chrome" |
| countChromeDevicesReachingAutoExpirationDate | "Serviços -> Gerenciamento do Chrome -> Ver relatório de insights do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de insights do Chrome" |
| countChromeDevicesThatNeedAttention | "Serviços -> Gerenciamento do Chrome -> Ver relatório de insights do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de insights do Chrome" |
| countChromeHardwareFleetDevices | "Serviços -> Gerenciamento do Chrome -> Ver relatório de insights do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de insights do Chrome" |
| countChromeVersions | "Serviços -> Gerenciamento do Chrome -> Ver relatório de versões do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de versões do Chrome" |
| countInstalledApps | "Serviços -> Gerenciamento do Chrome -> Ver relatório da lista de extensões"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório da lista de extensões" |
| countPrintJobsByPrinter | "Serviços -> Gerenciamento do Chrome -> Ver relatório de impressoras do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de impressoras do Chrome" |
| countPrintJobsByUser | "Serviços -> Gerenciamento do Chrome -> Ver relatório de impressoras do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de impressoras do Chrome" |
| enumeratePrintJobs | "Serviços -> Gerenciamento do Chrome -> Ver relatório de impressoras do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de impressoras do Chrome" |
| findInstalledAppDevices | "Serviços -> Gerenciamento do Chrome -> Ver relatório da lista de extensões"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório da lista de extensões" |
| findInstalledAppProfiles | "Serviços -> Gerenciamento do Chrome -> Ver relatório da lista de extensões"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório da lista de extensões" |
| countChromeCrashEvents | "Serviços -> Gerenciamento do Chrome -> Ver relatório de falha do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de falha do Chrome" |
Para gerenciar funções e privilégios de administrador, acesse "Admin Console -> Funções de administrador".
Escopos da API
A API Reports requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Para saber mais, consulte a Visão geral da autenticação.