API Báo cáo cho phép bạn tạo các báo cáo cung cấp cho bạn thông tin tổng hợp về quá trình triển khai Trình duyệt Chrome / thiết bị ChromeOS được quản lý.
Tổng quan nhanh về các phương thức API
URL có liên quan đến https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Nội dung 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 | /report:countChromeBrowsersCần chú ý | GET | Không bắt buộc: orgUnitId |
| Đếm các thiết bị Chrome sắp đến ngày hết hạn tự động trong miền của bạn | /reporting:countChromeDevicesReachingAutoExpirationDate | GET | Không bắt buộc: orgUnitId, minAueDate, maxAueDate |
| Đếm các thiết bị Chrome cần chú ý trong miền của bạn | /Báo cáo:countChromeThiết bị ThatCầnChú ý | GET | Không bắt buộc: orgUnitId, readMask |
| Đếm thiết bị trong nhóm phần cứng Chrome trong miền của bạn | /báo cáo:countChromeHardwareFleetDevices | GET | Không bắt buộc: orgUnitId, readMask |
| Đếm các phiên bản Chrome được triển khai cho các thiết bị trong miền của bạn | /Báo cáo:countChromeVersions | GET | Không bắt buộc: orgUnitId, bộ lọc, pageSize, pageToken |
| Đếm số ứng dụng bị báo cáo được cài đặt trên các thiết bị và trình duyệt của bạn | /Báo cáo:countĐã cài đặtApps | GET | Không bắt buộc: orgUnitId, bộ lọc, pageSize, pageToken, orderBy |
| Nhận bản tóm tắt về quá trình in do từng máy in trong miền của bạn thực hiện | /báo cáo:countPrintTasksByPrinter | GET | Không bắt buộc: printOrgUnitId, bộ lọc, pageSize, pageToken, orderBy |
| Nhận bản tóm tắt về hoạt động in do mỗi người dùng trong miền của bạn thực hiện | /Báo cáo:countPrintTasksByUser | GET | Không bắt buộc: printOrgUnitId, bộ lọc, 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 | /Báo cáo:enumeratePrintEvents | GET | Không bắt buộc: printOrgUnitId, bộ lọc, pageSize, pageToken, orderBy |
| Liệt kê các thiết bị cài đặt một ứng dụng cụ thể | /Report:findCài đặtAppDevices | GET | Không bắt buộc: orgUnitId, bộ lọc, pageSize, pageToken, orderBy |
| Xem số sự kiện sự cố trên Chrome | /reporting:countChromeCrashEvents | GET | Không bắt buộc: orgUnitId, filter, orderBy |
Xem mã mẫu để tham khảo ví dụ về các yêu cầu và phản hồi.
Đặc quyền quản trị
API Báo cáo tuân theo 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, cần có các đặc quyền khác nhau của quản trị viên.
| 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 trên Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết trên Chrome" |
| countChromeDevicesReachingAutoExpirationDate | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết trên Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết trên Chrome" |
| countChromeDevicesThatNeedAttention | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết trên Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết trên Chrome" |
| countChromeHardwareFleetDevices | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo thông tin chi tiết trên Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo thông tin chi tiết trên Chrome" |
| countChromeVersions | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo về các phiên bản Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo về các 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" |
| countChromeCrashEvents | "Dịch vụ -> Quản lý Chrome -> Xem báo cáo sự cố trên Chrome"
hoặc "Dịch vụ -> ChromeOS -> Cài đặt -> Xem báo cáo sự cố trên Chrome" |
Để quản lý các đặc quyền và vai trò quản trị viên, 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
API Báo cáo yêu cầu phạm vi OAuth sau đây:
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ề hoạt động xác thực.