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:countChromeProfileVersions | הורדה | אופציונלי: orgUnitId, filter, pageSize, pageToken |
| ספירת גרסאות 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 |
| איפה אפשר למצוא דוחות שימוש ב-SaaS בדומיין | /reports:findSaasUsage | הורדה | אופציונלי: filter, pageSize, pageToken, orderBy |
| איפה מוצאים דוחות שימוש ב-SaaS בדומיין שלכם, שמקובצים לפי דפדפנים | /reports:findSaasUsageBrowsers | הורדה | חובה: אפליקציה; אופציונלי: filter, pageSize, pageToken, orderBy |
| איתור דוחות שימוש ב-SaaS בדומיין שלכם, מקובצים לפי פרופילים | /reports:findSaasUsageProfiles | הורדה | חובה: אפליקציה; אופציונלי: filter, pageSize, pageToken, 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" |
| countChromeProfileVersions | "Services -> Chrome Management -> View Chrome Versions Report"
או "Services -> ChromeOS -> Settings -> View Chrome Versions 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' |
| findSaasUsage | "Services -> Chrome Management -> View SaaS Usage Report"
או "Services -> ChromeOS -> Settings -> View SaaS Usage Report" |
| findSaasUsageBrowsers | "Services -> Chrome Management -> View SaaS Usage Report"
או "Services -> ChromeOS -> Settings -> View SaaS Usage Report" |
| findSaasUsageProfiles | "Services -> Chrome Management -> View SaaS Usage Report"
או "Services -> ChromeOS -> Settings -> View SaaS Usage Report" |
כדי לנהל תפקידים והרשאות של אדמין, עוברים אל 'מסוף Admin -> תפקידי אדמין'.
היקפי API
נדרש היקף ההרשאות הבא של OAuth ל-Reports API:
https://www.googleapis.com/auth/chrome.management.reports.readonly
מידע נוסף מופיע במאמר סקירה כללית על אימות.