ה-Reports API מאפשר ליצור דוחות שמספקים מידע מצטבר על הפריסה של מכשיר ChromeOS המנוהל / של דפדפן Chrome.
סקירה כללית מהירה על שיטות ה-API
כתובות ה-URL הן יחסיות ל-https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| תיאור | כתובת URL יחסית | שיטת Http | פרמטרים מותרים של בקשות |
|---|---|---|---|
| ספירת דפדפני Chrome שדורשים התייחסות בדומיין שלך | /reports:countChromebrowsers אלימותAttention | GET | אופציונלי: orgUnitId |
| ספירת מכשירי Chrome שמגיעים לתאריך התפוגה האוטומטי בדומיין שלך | /reports:countChromeDevicesReachingAutoExpirationDate | GET | אופציונלי: orgUnitId, minAueDate, maxAueDate |
| ספירת מכשירי Chrome שדורשים התייחסות בדומיין שלך | /reports:countChromeDevicesSetupRequireAttention | 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' |
כדי לנהל תפקידים והרשאות של אדמין, עבור אל 'מסוף Admin -> תפקידי אדמין'.
היקפי ההרשאות של ה-API
ל-Reports API נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/chrome.management.reports.readonly
מידע נוסף זמין בסקירה הכללית על אימות.