Com a API Reports, é possível gerar relatórios com informações agregadas sobre a implantação do seu dispositivo ChromeOS ou 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 |
| Contabilizar dispositivos Chrome que atingem a data de expiração automática no domínio | /reports:countChromeDevicesReachingAutoExpirationDate (em inglês) | GET | Opcional: orgUnitId, minAueDate, maxAueDate |
| Contar dispositivos Chrome que precisam de atenção no seu domínio | /reports:countChromeDevicesThatNeedAttention | GET | Opcional: orgUnitId, readMask |
| Contar os dispositivos da frota de hardware do Chrome no seu domínio | /reports:countChromeHardwareFleetDevices (em inglês) | GET | Opcional: orgUnitId, readMask |
| Contar versões do Chrome implantadas nos dispositivos no seu domínio | /reports:countChromeVersions (link em inglês) | GET | Opcional: orgUnitId, filter, pageSize, pageToken |
| Contabilizar os apps informados instalados nos seus dispositivos e navegadores | /reports:countInstallApps (link em inglês) | GET | Opcional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Receba um resumo das impressões feitas por cada impressora no seu domínio | /reports:countPrintJobsByPrinter | GET | Opcional: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| Receber um resumo das impressões feitas por cada usuário no seu domínio | /reports:countPrintJobsByUser | GET | Opcional: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| Receber um relatório detalhado dos trabalhos de impressão no seu domínio | /reports:enumeratePrintJobs | GET | Opcional: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| Listar os dispositivos em que um app específico está instalado | /reports:findInstallAppDevices (link em inglês) | GET | Opcional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Receber uma contagem de eventos de falha do Chrome | /reports:countChromeCrashEvents (em inglês) | GET | Opcional: orgUnitId, filter, orderBy |
Consulte exemplos de código para solicitações e respostas de exemplo.
Privilégios de administrador
A API Reports respeita a delegação de funções de administrador. Dependendo dos relatórios que o administrador quer gerar, são necessários privilégios de administrador 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 -> Acessar 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 -> Acessar 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 -> Acessar relatório de erros do Chrome"
ou "Serviços -> ChromeOS -> Configurações -> Ver relatório de erros do Chrome" |
Para gerenciar funções e privilégios de administrador, acesse "Admin Console -> Funções do administrador".
Escopos da API
A API Reports requer o seguinte escopo do OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Para saber mais, consulte a Visão geral da autenticação.