Reports API를 사용하면 관리형 ChromeOS 기기 / Chrome 브라우저 배포에 관한 집계 정보를 제공하는 보고서를 생성할 수 있습니다.
API 메서드의 간단한 개요
URL은 https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER 기준입니다.
| 설명 | 상대 URL | Http 메소드 | 허용되는 요청 매개변수 |
|---|---|---|---|
| 도메인에서 확인이 필요한 Chrome 브라우저 수 집계 | /reports:countChromeBrowsersNeedingAttention | GET | 선택사항: orgUnitId |
| 도메인의 자동 만료일에 도달하는 Chrome 기기 수 | /reports:countChromeDevicesReachingAutoExpirationDate | GET | 선택사항: orgUnitId, minAueDate, maxAueDate |
| 도메인에서 확인이 필요한 Chrome 기기 수 집계 | /reports:countChromeDevicesThatNeedAttention | GET | 선택사항: orgUnitId, readMask |
| 도메인의 Chrome 하드웨어 기기 수 집계 | /reports:countChromeHardwareFleetDevices | GET | 선택사항: orgUnitId, readMask |
| 도메인의 기기에 배포된 Chrome 버전 수 계산 | /reports:countChromeVersions | GET | 선택사항: orgUnitId, filter, pageSize, pageToken |
| 보고된 앱 중 모든 기기 및 브라우저에 설치된 앱의 수를 계산합니다. | /reports:countInstalledApps | GET | 선택사항: orgUnitId, filter, pageSize, pageToken, orderBy |
| 도메인의 각 프린터에서 수행한 인쇄 요약을 확인합니다. | /reports:countPrintJobsByPrinter | GET | 선택사항: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| 도메인의 각 사용자가 수행한 인쇄 요약을 확인합니다. | /reports:countPrintJobsByUser | GET | 선택사항: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| 도메인의 인쇄 작업에 대한 자세한 보고서 받기 | /reports:enumeratePrintJobs | GET | 선택사항: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| 특정 앱이 설치된 기기 나열 | /reports:findInstalledAppDevices | GET | 선택사항: orgUnitId, filter, pageSize, pageToken, orderBy |
| Chrome 비정상 종료 이벤트 수 확인 | /reports:countChromeCrashEvents | GET | 선택사항: orgUnitId, filter, orderBy |
요청 및 응답 예는 코드 샘플을 참조하세요.
관리자 권한
Reports API는 관리자 역할 위임을 따릅니다. 관리자가 생성하려는 보고서에 따라 다른 관리자 권한이 필요합니다.
| 메서드 | 관리자 권한 필요 |
|---|---|
| countChromeBrowsersNeedingAttention | '서비스 -> Chrome 관리 -> Chrome 통계 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 통계 보고서 보기' |
| countChromeDevicesReachingAutoExpirationDate | '서비스 -> Chrome 관리 -> Chrome 통계 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 통계 보고서 보기' |
| countChromeDevicesThatNeedAttention | '서비스 -> Chrome 관리 -> Chrome 통계 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 통계 보고서 보기' |
| countChromeHardwareFleetDevices | '서비스 -> Chrome 관리 -> Chrome 통계 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 통계 보고서 보기' |
| countChromeVersions | '서비스 -> Chrome 관리 -> Chrome 버전 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 버전 보고서 보기' |
| countInstalledApps | '서비스 -> Chrome 관리 -> 확장 프로그램 목록 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> 확장 프로그램 목록 보고서 보기' |
| countPrintJobsByPrinter | '서비스 -> Chrome 관리 -> Chrome 프린터 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 프린터 보고서 보기' |
| countPrintJobsByUser | '서비스 -> Chrome 관리 -> Chrome 프린터 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 프린터 보고서 보기' |
| enumeratePrintJobs | '서비스 -> Chrome 관리 -> Chrome 프린터 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 프린터 보고서 보기' |
| findInstalledAppDevices | '서비스 -> Chrome 관리 -> 확장 프로그램 목록 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> 확장 프로그램 목록 보고서 보기' |
| countChromeCrashEvents | '서비스 -> Chrome 관리 -> Chrome 비정상 종료 보고서 보기'
또는 '서비스 -> ChromeOS -> 설정 -> Chrome 비정상 종료 보고서 보기' |
관리자 역할 및 권한을 관리하려면 '관리 콘솔 -> 관리자 역할'로 이동하세요.
API 범위
Reports API를 사용하려면 다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/chrome.management.reports.readonly
자세한 내용은 인증 개요를 참조하세요.