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