A API Reports permite 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 os 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 os dispositivos Chrome que precisam de atenção no seu domínio | /reports:countChromeDevicesThatNeedAttention | GET | Opcional: orgUnitId, readMask |
| Contar os dispositivos da frota de hardware Chrome no seu domínio | /reports:countChromeHardwareFleetDevices | GET | Opcional: orgUnitId, readMask |
| Contar as versões do Chrome implantadas nos perfis do seu domínio | /reports:countChromeProfileVersions | GET | Opcional: orgUnitId, filter, pageSize, pageToken |
| Contar as versões do Chrome implantadas nos dispositivos do seu domínio | /reports:countChromeVersions | GET | Opcional: orgUnitId, filter, pageSize, pageToken |
| Contar os apps informados instalados nos seus dispositivos e navegadores | /reports:countInstalledApps | GET | Opcional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Conferir um resumo da impressão feita por cada impressora no seu domínio | /reports:countPrintJobsByPrinter | GET | Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Conferir um resumo da impressão feita por cada usuário no seu domínio | /reports:countPrintJobsByUser | GET | Opcional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Gerar um relatório detalhado dos jobs 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 |
| Contar os eventos de falha do Chrome | /reports:countChromeCrashEvents | GET | Opcional: orgUnitId, filter, orderBy |
Confira exemplos de código para solicitações e respostas.
Privilégios de admin
A API Reports respeita a delegação de papéis de admin. Dependendo dos relatórios que o admin quer gerar, são necessários privilégios diferentes.
| Método | Privilégios de admin 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" |
| countChromeProfileVersions | "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" |
| 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 falhas do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de falhas do Chrome" |
Para gerenciar papéis e privilégios de admin, acesse "Admin Console -> Papéis de admin".
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.