Chrome Management Chrome Browsers API

‫Chrome Management Chrome Browsers API מאפשר לאדמינים לראות נתונים ולנהל דפדפני Chrome שרשומים ב-Chrome Enterprise Core. אפשר להשתמש בקבוצת ממשקי ה-API הזו כדי להציג רשימה של דפדפני Chrome רשומים, לאחזר דפדפן Chrome, לעדכן מידע על הערות בדפדפן Chrome, להעביר דפדפני Chrome בין יחידות ארגוניות (OU) ולמחוק את הנתונים שנאספו מדפדפן Chrome.

סקירה מהירה של שיטות API

כתובות ה-URL הן יחסיות אל https://chromemanagement.googleapis.com/v1/customers/{customer_id}

תיאור כתובת URL יחסית שיטת HTTP
רשימת דפדפני Chrome רשומים ‎/chromeBrowsers הורדה
אחזור של דפדפן Chrome /chromeBrowsers/{browser_permanent_id} הורדה
עדכון פרטי ההערה של דפדפן Chrome /chromeBrowsers/{browser_permanent_id} PATCH
העברת דפדפני Chrome ליחידה ארגונית (OU) חדשה /chromeBrowsers:move POST
מחיקת הנתונים שנאספו מדפדפן Chrome /chromeBrowsers/{browser_permanent_id} מחיקה

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

המערכת מסננת את התוצאות

כשמציגים רשימה של דפדפני Chrome באמצעות השיטה ‎/chromeBrowsers, אפשר לצמצם את התוצאות באמצעות הפרמטר של השאילתה filter. כל הפרמטרים של המסנן חייבים להיות עם תווי בריחה (escape) של כתובת URL כשהם נשלחים בבקשות HTTP. אפשר לשלב כמה תנאים באמצעות האופרטור AND.

  • שדות מסוג מחרוזת, מספר שלם ו-Enum: תומכים באופרטורים להשוואה = ו-:. יש תמיכה בתו כללי לחיפוש * (קידומת prefix*, סיומת *suffix, מחרוזת משנה *substring* או נוכחות *) עם = ו-: רק בשביל machine_name, annotated_asset_id ו-browser_version (לדוגמה, machine_name=LIX* או browser_version:"*6367*"). יש גם תמיכה בסינון מחרוזות גלובליות פשוטות (ללא שם שדה): מונח יחיד כמו ABC תואם אם שדה מחרוזת כלשהו שנוסף לאינדקס מכיל את ABC, ומספר מונחים שמחוברים באמצעות AND או רווח (לדוגמה, machine AND 73 או machine 73) תואמים לדפדפנים שמכילים כל מונח שצוין בכל אחד משדות הטקסט שנוספו לאינדקס (בעוד שמחרוזת מרובת מילים במירכאות כמו "machine 73" תואמת לביטוי הרציף המדויק בתוך שדה יחיד).
  • שדות של חותמות זמן: תומכים באופרטורים להשוואה =,‏ <= ו->=. חותמות זמן צריכות להיות מחרוזת בפורמט RFC-3339 במירכאות כפולות (לדוגמה, "2020-01-01T12:00:00Z" או "2012-04-21T11:30:00-04:00"). אפשר לציין טווחים סגורים של חותמות זמן באמצעות השוואות.
  • סינון לפי יחידה ארגונית: אפשר לסנן דפדפנים ששייכים ליחידה ארגונית ספציפית על ידי ציון org_unit_path (לדוגמה, org_unit_path=/Marketing). יש תמיכה בהתאמה ליחידה ארגונית אחת.
  • סינון לפי קבוצה: אתם יכולים לסנן דפדפנים ששייכים לקבוצה ספציפית ב-Cloud Identity באמצעות הפונקציה in_group (לדוגמה, in_group("groups/00gjdgxs0lm8l7o")).

שדות שאפשר לסנן

שדה תיאור
browser_permanent_id המזהה הייחודי הקבוע של המכשיר עם דפדפן Chrome.
last_policy_fetch_time הפעם האחרונה שבה אוחזרה מדיניות במכשיר עם דפדפן Chrome.
os_platform פלטפורמת מערכת ההפעלה של המכשיר עם דפדפן Chrome (למשל WINDOWS, ‏ MAC, ‏ LINUX).
os_architecture ארכיטקטורת מערכת ההפעלה של המכשיר עם דפדפן Chrome.
os_version גרסת מערכת ההפעלה של המכשיר עם דפדפן Chrome.
machine_name שם המכונה שמשויכת למכשיר עם דפדפן Chrome.
annotated_location המיקום שצוין בהערה למכשיר עם דפדפן Chrome.
annotated_user המשתמש שנוסף לו הערה במכשיר עם דפדפן Chrome.
annotated_asset_id מזהה הנכס עם ההערות של המכשיר עם דפדפן Chrome.
annotated_note ההערות שנוספו למכשיר עם דפדפן Chrome.
org_unit_path הנתיב של היחידה הארגונית של המכשיר עם דפדפן Chrome (למשל, /Marketing).
org_unit_id מזהה היחידה הארגונית של המכשיר עם דפדפן Chrome.
last_registration_time זמן הרישום של מכשיר דפדפן Chrome.
os_platform_version הפלטפורמה של מערכת ההפעלה והגרסה הראשית של המכשיר עם דפדפן Chrome.
browser_version גרסת דפדפן Chrome שדווחה כמותקנת במכשיר.
last_status_report_time המועד של דוח הסטטוס האחרון של המכשיר עם דפדפן Chrome.
extension_count מספר התוספים שמותקנים במכשיר עם דפדפן Chrome.
policy_count מספר כללי המדיניות שחלים על המכשיר עם דפדפן Chrome.
last_device_user המשתמש האחרון שנכנס לחשבון במחשב.
last_activity_time הפעם האחרונה שבה הייתה פעילות במכשיר עם דפדפן Chrome (אחזור מדיניות או דיווח).
device_id_collision אם מזהה המכשיר משותף בין כמה מכונות שדפדפן Chrome מזהה כמכונה אחת (true או false).

פונקציות סינון

פונקציה תיאור
in_group(string) סינון רשימת המכשירים עם דפדפן Chrome לאלה ששייכים לשם המשאב של קבוצת Cloud Identity שצוינה (בפורמט: in_group("groups/{group_id}")).

סידור התוצאות

אפשר לציין את סדר התוצאות באמצעות פרמטר השאילתה orderBy. כברירת מחדל, המיון הוא בסדר עולה. כדי לציין סדר יורד לשדה, מוסיפים את הסיומת " desc" לשם השדה (לדוגמה, last_activity_time desc).

אם לא מציינים ערך, ברירת המחדל היא סדר עולה של browser_permanent_id.

שדות נתמכים לסידור

  • browser_permanent_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_version

הרשאות אדמין

‫Chrome Browsers API מכבד את הקצאת התפקידים של האדמין.

שיטה נדרשות הרשאות אדמין
ListChromeBrowsers "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים"
או "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים -> קריאה"
GetChromeBrowser "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים"
או "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים -> קריאה"
UpdateChromeBrowser "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים"
MoveChromeBrowsers "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים"
DeleteChromeBrowser "שירותים -> ניהול Chrome -> הגדרות -> דפדפנים מנוהלים"

כדי לנהל את התפקידים וההרשאות של האדמינים, צריך להיכנס אל "מסוף Admin‏ -> תפקידי אדמין".

היקפי הרשאות ל-API

כדי להשתמש ב-Chrome Management Chrome Browsers API, צריך את היקפי ההרשאות הבאים של OAuth:

שיטה היקפי ההרשאות הנדרשים של OAuth
ListChromeBrowsers thought https://www.googleapis.com/auth/chrome.management.browsers
או https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser thought https://www.googleapis.com/auth/chrome.management.browsers
או https://www.googleapis.com/auth/chrome.management.browsers.readonly
UpdateChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
MoveChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
DeleteChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers

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