Reports API cho phép bạn tạo báo cáo cung cấp thông tin tổng hợp về việc triển khai thiết bị ChromeOS / Trình duyệt Chrome được quản lý.
Tổng quan nhanh về các phương thức API
Các URL liên quan đến https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Mô tả | URL tương đối | Phương thức HTTP | Tham số yêu cầu được phép |
|---|---|---|---|
| Đếm số trình duyệt Chrome cần chú ý trong miền của bạn | /reports:countChromeBrowsersNeedingAttention | NHẬN | Không bắt buộc: orgUnitId |
| Số thiết bị Chrome sắp đến ngày hết hạn tự động cập nhật trong miền của bạn | /reports:countChromeDevicesReachingAutoExpirationDate | NHẬN | Không bắt buộc: orgUnitId, minAueDate, maxAueDate |
| Đếm số thiết bị Chrome cần được chú ý trong miền của bạn | /reports:countChromeDevicesThatNeedAttention | NHẬN | Không bắt buộc: orgUnitId, readMask |
| Đếm số lượng thiết bị phần cứng Chrome trong miền của bạn | /reports:countChromeHardwareFleetDevices | NHẬN | Không bắt buộc: orgUnitId, readMask |
| Đếm số phiên bản Chrome được triển khai cho các thiết bị trong miền của bạn | /reports:countChromeVersions | NHẬN | Không bắt buộc: orgUnitId, filter, pageSize, pageToken |
| Đếm số ứng dụng được báo cáo đã cài đặt trên các thiết bị và trình duyệt của bạn | /reports:countInstalledApps | NHẬN | Không bắt buộc: orgUnitId, filter, pageSize, pageToken, orderBy |
| Xem thông tin tóm tắt về hoạt động in của từng máy in trong miền của bạn | /reports:countPrintJobsByPrinter | NHẬN | Không bắt buộc: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Xem thông tin tóm tắt về hoạt động in của từng người dùng trong miền của bạn | /reports:countPrintJobsByUser | NHẬN | Không bắt buộc: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Nhận báo cáo chi tiết về các lệnh in trong miền của bạn | /reports:enumeratePrintJobs | NHẬN | Không bắt buộc: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Liệt kê các thiết bị đã cài đặt một ứng dụng cụ thể | /reports:findInstalledAppDevices | NHẬN | Không bắt buộc: orgUnitId, filter, pageSize, pageToken, orderBy |
| Liệt kê các hồ sơ mà một ứng dụng cụ thể được cài đặt | /reports:findInstalledAppProfiles | NHẬN | Không bắt buộc: orgUnitId, filter, pageSize, pageToken, orderBy |
| Nhận số lượng sự kiện sự cố trên Chrome | /reports:countChromeCrashEvents | NHẬN | Không bắt buộc: orgUnitId, filter, orderBy |
Hãy xem mã mẫu để biết các yêu cầu và phản hồi mẫu.
Đặc quyền của quản trị viên
Reports API tuân thủ việc uỷ quyền vai trò quản trị viên. Tuỳ thuộc vào báo cáo mà quản trị viên muốn tạo, bạn sẽ cần có các đặc quyền quản trị khác nhau.
| Phương thức | Cần có đặc quyền của quản trị viên |
|---|---|
| countChromeBrowsersNeedingAttention | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết về Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết về Chrome" |
| countChromeDevicesReachingAutoExpirationDate | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết về Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết về Chrome" |
| countChromeDevicesThatNeedAttention | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết về Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết về Chrome" |
| countChromeHardwareFleetDevices | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết về Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết về Chrome" |
| countChromeVersions | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo về phiên bản Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo về phiên bản Chrome" |
| countInstalledApps | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo danh sách tiện ích"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo danh sách tiện ích" |
| countPrintJobsByPrinter | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo về máy in Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo về máy in Chrome" |
| countPrintJobsByUser | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo về máy in Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo về máy in Chrome" |
| enumeratePrintJobs | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo về máy in Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo về máy in Chrome" |
| findInstalledAppDevices | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo danh sách tiện ích"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo danh sách tiện ích" |
| findInstalledAppProfiles | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo danh sách tiện ích"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo danh sách tiện ích" |
| countChromeCrashEvents | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo sự cố của Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo sự cố của Chrome" |
Để quản lý vai trò và đặc quyền quản trị, hãy truy cập vào "Bảng điều khiển dành cho quản trị viên -> Vai trò quản trị".
Phạm vi API
Reports API yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Để biết thêm thông tin, hãy xem bài viết Tổng quan về quy trình xác thực.