Reports API

הממשק Reports API מאפשר לך ליצור דוחות שמספקים לך נתונים מצטברים מידע על הפריסה המנוהלת של מכשיר ChromeOS או של דפדפן Chrome.

סקירה כללית קצרה של שיטות API

כתובות ה-URL הן יחסיות ל-https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER

תיאור כתובת URL יחסית שיטת Http פרמטרים מותרים של בקשות
ספירה של דפדפני Chrome שדורשים התייחסות בדומיין /reports:countChromeBrowsersNeedingAttention הורדה אופציונלי: orgUnitId
ספירה של מכשירי Chrome שיגיעו לתאריך התפוגה האוטומטי בדומיין שלך /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 הורדה אופציונלי: filterOrgUnitId, filter, pageSize, pageToken, orderBy
קבלת סיכום של פעולות ההדפסה שבוצעו על ידי כל משתמש בדומיין /reports:countPrintJobsByUser הורדה אופציונלי: PrintOrgUnitId, filter, pageSize, pageToken, orderBy
קבלת דוח מפורט של משימות הדפסה בדומיין שלך /reports:enumeratePrintJobs הורדה אופציונלי: PrintOrgUnitId, filter, pageSize, pageToken, orderBy
הצגת רשימה של המכשירים שבהם מותקנת אפליקציה מסוימת /reports:findInstalledAppDevices הורדה אופציונלי: orgUnitId, filter, pageSize, pageToken, orderBy
קבלת ספירה של אירועי קריסה של Chrome /reports:countChromeCrashEvents הורדה אופציונלי: orgUnitId, filter, orderBy

ראו דוגמאות קוד לבקשות ולתשובות.

הרשאות אדמין

ממשק ה-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

למידע נוסף, ראו סקירה כללית על אימות.