Chrome Management API

‫Chrome Management API הוא חבילה של שירותים שמאפשרים לאדמינים של Chrome להציג ולנהל את מכשירי Chrome OS ודפדפן Chrome שלהם, ולקבל תובנות לגביהם.

שירות: chromemanagement.googleapis.com

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.

מסמך Discovery

מסמך גילוי הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי API ל-REST. היא משמשת לבניית ספריות לקוח, תוספים ל-IDE וכלים אחרים שמתקשרים עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמכי הגילוי הבאים:

נקודת קצה של שירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה (endpoint) משלו, וכל כתובות ה-URI שבהמשך הן יחסיות לנקודת הקצה הזו:

  • https://chromemanagement.googleapis.com

משאב REST: ‏ v1alpha1.customers.enterprise.securityInsights

Methods
checkEnablementStatus GET /v1alpha1/{customer=customers/*}/enterprise/securityInsights:checkEnablementStatus
מקבל את מצב ההגדרה של תכונת התובנות עבור הלקוח.
disable POST /v1alpha1/{customer=customers/*}/enterprise/securityInsights:disable
התובנות לגבי הלקוח מושבתות.
enable POST /v1alpha1/{customer=customers/*}/enterprise/securityInsights:enable
הפעלת תובנות לגבי הלקוח והגדרת מחברים נדרשים ל-Chrome.
queryContentTransfers GET /v1alpha1/{customer=customers/*}/enterprise/securityInsights:queryContentTransfers
מחזירה סיכום ברמה גבוהה של העברות תוכן עבור לקוח נתון.
queryContentTransfersBreakdowns GET /v1alpha1/{customer=customers/*}/enterprise/securityInsights:queryContentTransfersBreakdowns
מחזירה סיכומים של העברות תוכן למדד נתון ולמאפיין פירוט.
queryUrlVisits GET /v1alpha1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisits
מחזירה סיכום כללי של ביקורים בכתובת URL של לקוח נתון.
queryUrlVisitsBreakdowns GET /v1alpha1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisitsBreakdowns
מחזירה סיכומים של ביקורים בכתובות URL עבור מדד נתון ומאפיין פירוט.

משאב REST: ‏ v1alpha1.customers.profiles

Methods
delete DELETE /v1alpha1/{name=customers/*/profiles/*}
מחיקת הנתונים שנאספו מפרופיל בדפדפן Chrome.
get GET /v1alpha1/{name=customers/*/profiles/*}
מקבל פרופיל של דפדפן Chrome עם מזהה לקוח ומזהה קבוע של הפרופיל.
list GET /v1alpha1/{parent=customers/*}/profiles
מציג רשימה של פרופילים בדפדפן Chrome של לקוח על סמך קריטריוני החיפוש והמיון שצוינו.

משאב REST: ‏ v1alpha1.customers.telemetry.devices

Methods
get GET /v1alpha1/{name=customers/*/telemetry/devices/*}
קבלת נתוני טלמטריה של המכשיר.
list GET /v1alpha1/{parent=customers/*}/telemetry/devices
רשימה של כל מכשירי הטלמטריה.

משאב REST: ‏ v1alpha1.customers.telemetry.events

Methods
list GET /v1alpha1/{parent=customers/*}/telemetry/events
מציג את אירועי הטלמטרייה.

משאב REST: ‏ v1alpha1.customers.telemetry.notificationConfigs

Methods
create POST /v1alpha1/{parent=customers/*}/telemetry/notificationConfigs
יצירת הגדרת התראות טלמטריה.
delete DELETE /v1alpha1/{name=customers/*/telemetry/notificationConfigs/*}
מחיקת הגדרת התראות טלמטריה.
list GET /v1alpha1/{parent=customers/*}/telemetry/notificationConfigs
הצגת רשימה של כל הגדרות ההתראות על טלמטריה.
patch PATCH /v1alpha1/{telemetryNotificationConfig.name=customers/*/telemetry/notificationConfigs/*}
עדכון של הגדרת התראות טלמטריה.

משאב REST: ‏ v1alpha1.customers.telemetry.users

Methods
get GET /v1alpha1/{name=customers/*/telemetry/users/*}
קבלת משתמש טלמטריה.
list GET /v1alpha1/{parent=customers/*}/telemetry/users
הצגת רשימה של כל משתמשי הטלמטרייה.

משאב REST: ‏ v1.customers.apps

Methods
countChromeAppRequests GET /v1/{customer=customers/*}/apps:countChromeAppRequests
יצירת סיכום של בקשות להתקנת אפליקציות.
fetchDevicesRequestingExtension GET /v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
קבלת רשימה של מכשירים שביקשו להתקין תוסף.
fetchUsersRequestingExtension GET /v1/{customer=customers/*}/apps:fetchUsersRequestingExtension
קבלת רשימה של משתמשים שביקשו להתקין תוסף.

משאב REST: v1.customers.apps.android

Methods
get GET /v1/{name=customers/*/apps/android/*}
אפשר לקבל אפליקציה ספציפית ללקוח לפי שם המשאב שלה.

משאב REST: ‏ v1.customers.apps.chrome

Methods
get GET /v1/{name=customers/*/apps/chrome/*}
אפשר לקבל אפליקציה ספציפית ללקוח לפי שם המשאב שלה.

משאב REST: ‏ v1.customers.apps.web

Methods
get GET /v1/{name=customers/*/apps/web/*}
אפשר לקבל אפליקציה ספציפית ללקוח לפי שם המשאב שלה.

משאב REST: ‏ v1.customers.certificateProvisioningProcesses

Methods
claim POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:claim
הצהרה על תהליך הקצאת אישורים.
get GET /v1/{name=customers/*/certificateProvisioningProcesses/*}
מאחזר תהליך הקצאת אישורים.
setFailure POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:setFailure
מסמן תהליך הקצאת אישורים כנכשל.
signData POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:signData
מבקש מהלקוח שהתחיל תהליך הקצאת אישורים לחתום על נתונים.
uploadCertificate POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:uploadCertificate
מעלה אישור שהונפק בהצלחה לתהליך הקצאת אישורים.

משאב REST: ‏ v1.customers.certificateProvisioningProcesses.operations

Methods
get GET /v1/{name=customers/*/certificateProvisioningProcesses/*/operations/*}
אחזור המצב העדכני של פעולה ממושכת.

משאב REST: ‏ v1.customers.profiles

Methods
delete DELETE /v1/{name=customers/*/profiles/*}
מחיקת הנתונים שנאספו מפרופיל בדפדפן Chrome.
get GET /v1/{name=customers/*/profiles/*}
מקבל פרופיל של דפדפן Chrome עם מזהה לקוח ומזהה קבוע של הפרופיל.
list GET /v1/{parent=customers/*}/profiles
מציג רשימה של פרופילים בדפדפן Chrome של לקוח על סמך קריטריוני החיפוש והמיון שצוינו.

משאב REST: ‏ v1.customers.profiles.commands

Methods
create POST /v1/{parent=customers/*/profiles/*}/commands
יוצר פקודה מרחוק לפרופיל בדפדפן Chrome.
get GET /v1/{name=customers/*/profiles/*/commands/*}
מקבל פקודה מרחוק לפרופיל בדפדפן Chrome.
list GET /v1/{parent=customers/*/profiles/*}/commands
מציג רשימה של פקודות מרחוק של פרופיל בדפדפן Chrome.

משאב REST: v1.customers.reports

Methods
countActiveDevices GET /v1/{customer=customers/*}/reports:countActiveDevices
קבלת ספירה של מכשירים פעילים לפי מסגרות זמן מוגדרות.
countChromeBrowsersNeedingAttention GET /v1/{customer=customers/*}/reports:countChromeBrowsersNeedingAttention
מספר דפדפני Chrome שנרשמו לאחרונה, שיש להם מדיניות חדשה לסנכרון או שלא זוהתה בהם פעילות אחרונה.
countChromeCrashEvents GET /v1/{customer=customers/*}/reports:countChromeCrashEvents
קבלת ספירה של אירועי קריסה של Chrome.
countChromeDevicesReachingAutoExpirationDate GET /v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
יצירת דוח של מספר המכשירים שהתוקף שלהם פג בכל חודש במסגרת הזמן שנבחרה.
countChromeDevicesThatNeedAttention GET /v1/{customer=customers/*}/reports:countChromeDevicesThatNeedAttention
מספר מכשירי ChromeOS שלא סונכרנה בהם מדיניות, שלא הייתה בהם פעילות משתמש ב-28 הימים האחרונים, שהם לא עדכניים או שלא עומדים בדרישות.
countChromeHardwareFleetDevices GET /v1/{customer=customers/*}/reports:countChromeHardwareFleetDevices
מספר המכשירים עם מפרט חומרה ספציפי מסוג החומרה המבוקש (לדוגמה, שם הדגם, סוג המעבד).
countChromeVersions GET /v1/{customer=customers/*}/reports:countChromeVersions
יצירת דוח של גרסאות Chrome שהותקנו.
countDevicesPerBootType GET /v1/{customer=customers/*}/reports:countDevicesPerBootType
קבלת מספר המכשירים לפי סוג האתחול.
countDevicesPerReleaseChannel GET /v1/{customer=customers/*}/reports:countDevicesPerReleaseChannel
מקבלים את מספר המכשירים לכל ערוץ.
countInstalledApps GET /v1/{customer=customers/*}/reports:countInstalledApps
יצירת דוח של התקנות אפליקציות.
countPrintJobsByPrinter GET /v1/{customer=customers/*}/reports:countPrintJobsByPrinter
לקבל סיכום של ההדפסות שבוצעו בכל מדפסת.
countPrintJobsByUser GET /v1/{customer=customers/*}/reports:countPrintJobsByUser
קבלת סיכום של פעולות ההדפסה שבוצעו על ידי כל משתמש.
enumeratePrintJobs GET /v1/{customer=customers/*}/reports:enumeratePrintJobs
קבלת רשימה של עבודות הדפסה.
findInstalledAppDevices GET /v1/{customer=customers/*}/reports:findInstalledAppDevices
יצירת דוח של מכשירים מנוהלים עם דפדפן Chrome שמותקנת בהם אפליקציה מסוימת.
findInstalledAppProfiles GET /v1/{customer=customers/*}/reports:findInstalledAppProfiles
יצירת דוח של פרופילים מנוהלים ב-Chrome שמותקנת בהם אפליקציה מסוימת.

משאב REST: ‏ v1.customers.telemetry.devices

Methods
get GET /v1/{name=customers/*/telemetry/devices/*}
קבלת נתוני טלמטריה של המכשיר.
list GET /v1/{parent=customers/*}/telemetry/devices
רשימה של כל מכשירי הטלמטריה.

משאב REST: ‏ v1.customers.telemetry.events

Methods
list GET /v1/{parent=customers/*}/telemetry/events
מציג את אירועי הטלמטרייה.

משאב REST: ‏ v1.customers.telemetry.notificationConfigs

Methods
create POST /v1/{parent=customers/*}/telemetry/notificationConfigs
יצירת הגדרת התראות טלמטריה.
delete DELETE /v1/{name=customers/*/telemetry/notificationConfigs/*}
מחיקת הגדרת התראות טלמטריה.
list GET /v1/{parent=customers/*}/telemetry/notificationConfigs
הצגת רשימה של כל הגדרות ההתראות על טלמטריה.

משאב REST: ‏ v1.customers.telemetry.users

Methods
get GET /v1/{name=customers/*/telemetry/users/*}
קבלת משתמש טלמטריה.
list GET /v1/{parent=customers/*}/telemetry/users
הצגת רשימה של כל משתמשי הטלמטריה.

משאב REST: ‏ v1.customers.thirdPartyProfileUsers

Methods
move POST /v1/{name=customers/*/thirdPartyProfileUsers/*}:move
העברה של משתמש בפרופיל Chrome מצד שלישי ליחידה ארגונית ליעד.

משאב REST: ‏ v1.operations

Methods
cancel POST /v1/{name=operations/**}:cancel
מתחילה ביטול אסינכרוני של פעולה ממושכת.
delete DELETE /v1/{name=operations/**}
מוחק פעולה ממושכת.
list GET /v1/{name=operations}
רשימת פעולות שתואמות למסנן שצוין בבקשה.