Chrome Management API

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

שירות: chromemanagement.googleapis.com

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

מסמך Discovery

Discovery Document הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי 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.connectorConfigs

Methods
create POST /v1/{parent=customers/*}/connectorConfigs
יוצר הגדרת מחבר.
delete DELETE /v1/{name=customers/*/connectorConfigs/*}
מחיקת הגדרות של מחבר.
get GET /v1/{name=customers/*/connectorConfigs/*}
מקבלים את הגדרות המחבר עם מזהה הלקוח ומזהה ההגדרה.
list GET /v1/{parent=customers/*}/connectorConfigs
מחזירה את הגדרות המחבר של רשימות לקוחות.
patch PATCH /v1/{connectorConfig.name=customers/*/connectorConfigs/*}
מעדכן את ההגדרות של מחבר.

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

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

משאב 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
מספר המכשירים עם מפרט חומרה ספציפי מסוג החומרה המבוקש (לדוגמה, שם הדגם, סוג המעבד).
countChromeProfileVersions GET /v1/{customer=customers/*}/reports:countChromeProfileVersions
יצירת דוח של גרסאות Chrome שמותקנות בפרופילים מנוהלים.
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 שמותקנת בהם אפליקציה מסוימת.
findSaasUsage GET /v1/{customer=customers/*}/reports:findSaasUsage
למצוא דוחות שימוש ב-SaaS של לקוח על סמך קריטריוני החיפוש והמיון שצוינו.
findSaasUsageBrowsers GET /v1/{customer=customers/*}/reports:findSaasUsageBrowsers
חיפוש דוחות שימוש ב-SaaS של לקוח מסוים, מקובצים לפי דפדפנים על סמך קריטריוני החיפוש והמיון שצוינו.
findSaasUsageProfiles GET /v1/{customer=customers/*}/reports:findSaasUsageProfiles
Find SaaS usage reports of a customer grouped by profiles based on the given search and sorting criteria.

משאב 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}
רשימת פעולות שתואמות למסנן שצוין בבקשה.