Reports API מאפשר לכם ליצור דוחות שמספקים מידע מצטבר על הפריסה של מכשירי ChromeOS או דפדפן Chrome המנוהלים שלכם.
סקירה מהירה של שיטות API
כתובות ה-URL הן יחסיות ל-https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| תיאור | כתובת URL יחסית | שיטת HTTP | פרמטרים מותרים של בקשה |
|---|---|---|---|
| ספירת דפדפני Chrome שדורשים התייחסות בדומיין | /reports:countChromeBrowsersNeedingAttention | הורדה | אופציונלי: orgUnitId |
| מספר מכשירי Chrome בדומיין שמגיעים לסוף תקופת העדכון האוטומטי (AUE) | /reports:countChromeDevicesReachingAutoExpirationDate | הורדה | אופציונלי: orgUnitId, minAueDate, maxAueDate |
| ספירת מכשירי Chrome שנדרש לטפל בהם בדומיין | /reports:countChromeDevicesThatNeedAttention | הורדה | אופציונלי: orgUnitId, readMask |
| ספירת מכשירי חומרה של Chrome בדומיין | /reports:countChromeHardwareFleetDevices | הורדה | אופציונלי: orgUnitId, readMask |
| ספירת גרסאות Chrome שנפרסו במכשירים בדומיין | /reports:countChromeVersions | הורדה | אופציונלי: orgUnitId, filter, pageSize, pageToken |
| ספירת האפליקציות המדווחות שהותקנו במכשירים ובדפדפנים | /reports:countInstalledApps | הורדה | אופציונלי: orgUnitId, filter, pageSize, pageToken, orderBy |
| קבלת סיכום של פעולות ההדפסה שבוצעו בכל מדפסת בדומיין | /reports:countPrintJobsByPrinter | הורדה | אופציונלי: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| קבלת סיכום של פעולות ההדפסה שבוצעו על ידי כל משתמש בדומיין | /reports:countPrintJobsByUser | הורדה | אופציונלי: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| קבלת דוח מפורט של משימות הדפסה בדומיין | /reports:enumeratePrintJobs | הורדה | אופציונלי: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| הצגת רשימת המכשירים שבהם מותקנת אפליקציה מסוימת | /reports:findInstalledAppDevices | הורדה | אופציונלי: orgUnitId, filter, pageSize, pageToken, orderBy |
| הצגת רשימת הפרופילים שבהם מותקנת אפליקציה מסוימת | /reports:findInstalledAppProfiles | הורדה | אופציונלי: orgUnitId, filter, pageSize, pageToken, orderBy |
| קבלת ספירה של אירועי קריסה ב-Chrome | /reports:countChromeCrashEvents | הורדה | אופציונלי: orgUnitId, filter, orderBy |
דוגמאות לבקשות ולתגובות מופיעות בדוגמאות קוד.
הרשאות אדמין
ה-Reports API מכבד את ההרשאות שהוקצו לתפקידי אדמין. נדרשות הרשאות אדמין שונות בהתאם לדוחות שהאדמין רוצה ליצור.
| שיטה | נדרשות הרשאות אדמין |
|---|---|
| countChromeBrowsersNeedingAttention | "Services -> Chrome Management -> View Chrome Insights Report"
או "Services -> ChromeOS -> Settings -> View Chrome Insights Report" |
| countChromeDevicesReachingAutoExpirationDate | "Services -> Chrome Management -> View Chrome Insights Report"
או "Services -> ChromeOS -> Settings -> View Chrome Insights Report" |
| countChromeDevicesThatNeedAttention | "Services -> Chrome Management -> View Chrome Insights Report"
או "Services -> ChromeOS -> Settings -> View Chrome Insights Report" |
| countChromeHardwareFleetDevices | "Services -> Chrome Management -> View Chrome Insights Report"
או "Services -> ChromeOS -> Settings -> View Chrome Insights Report" |
| countChromeVersions | "Services -> Chrome Management -> View Chrome Versions Report"
או "Services -> ChromeOS -> Settings -> View Chrome Versions Report" |
| countInstalledApps | "Services -> Chrome Management -> View Extensions List Report"
או "Services -> ChromeOS -> Settings -> View Extensions List Report" |
| countPrintJobsByPrinter | "Services -> Chrome Management -> View Chrome Printers Report"
או "Services -> ChromeOS -> Settings -> View Chrome Printers Report" |
| countPrintJobsByUser | "Services -> Chrome Management -> View Chrome Printers Report"
או "Services -> ChromeOS -> Settings -> View Chrome Printers Report" |
| enumeratePrintJobs | "Services -> Chrome Management -> View Chrome Printers Report"
או "Services -> ChromeOS -> Settings -> View Chrome Printers Report" |
| findInstalledAppDevices | "Services -> Chrome Management -> View Extensions List Report"
או "Services -> ChromeOS -> Settings -> View Extensions List Report" |
| findInstalledAppProfiles | "Services -> Chrome Management -> View Extensions List Report"
או "Services -> ChromeOS -> Settings -> View Extensions List Report" |
| countChromeCrashEvents | 'Services -> Chrome Management -> View Chrome Crash Report'
או 'Services -> ChromeOS -> Settings -> View Chrome Crash Report' |
כדי לנהל תפקידים והרשאות של אדמין, עוברים אל 'מסוף Admin -> תפקידי אדמין'.
היקפי API
נדרש היקף ההרשאות הבא של OAuth ל-Reports API:
https://www.googleapis.com/auth/chrome.management.reports.readonly
מידע נוסף מופיע במאמר סקירה כללית על אימות.