Chrome Management Chrome Browsers API

管理員可以使用 Chrome Management Chrome Browsers API，查看資料及管理已註冊 Chrome Enterprise 基本版的 Chrome 瀏覽器。這組 API 可用於列出已註冊的 Chrome 瀏覽器、擷取 Chrome 瀏覽器、更新 Chrome 瀏覽器的註解資訊、在組織單位之間移動 Chrome 瀏覽器，以及刪除從 Chrome 瀏覽器收集的資料。

API 方法快速總覽

網址與 https://chromemanagement.googleapis.com/v1/customers/{customer_id} 相關

說明 相對網址 HTTP 方法
列出已註冊的 Chrome 瀏覽器 /chromeBrowsers GET
擷取 Chrome 瀏覽器 /chromeBrowsers/{browser_permanent_id} GET
更新 Chrome 瀏覽器的註解資訊 /chromeBrowsers/{browser_permanent_id} PATCH
將 Chrome 瀏覽器移至新的組織單位 (OU) /chromeBrowsers:move POST
刪除從 Chrome 瀏覽器收集的資料 /chromeBrowsers/{browser_permanent_id} 刪除

如需要求和回應範例，請參閱程式碼範例。

正在篩選結果

使用 /chromeBrowsers 方法列出 Chrome 瀏覽器時，您可以使用 filter 查詢參數縮小結果範圍。在 HTTP 要求中傳送的所有篩選器參數都必須經過網址逸出處理。您可以使用 AND 運算子合併多個條件。

  • 字串、整數和列舉欄位：支援 = 和 : 比較運算子。萬用字元 * (前置字元 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)，篩選屬於特定組織單位的瀏覽器。系統支援單一組織單位比對。
  • 群組篩選：您可以使用 in_group 函式 (例如 in_group("groups/00gjdgxs0lm8l7o"))，篩選屬於特定 Cloud Identity 群組的瀏覽器。

可篩選的欄位

欄位 說明
browser_permanent_id Chrome 瀏覽器裝置的永久專屬 ID。
last_policy_fetch_time Chrome 瀏覽器裝置上次擷取政策的時間。
os_platform Chrome 瀏覽器裝置的 OS 平台 (例如 WINDOWS、MAC、LINUX)。
os_architecture Chrome 瀏覽器裝置的 OS 架構。
os_version Chrome 瀏覽器裝置的 OS 版本。
machine_name 與 Chrome 瀏覽器裝置相關聯的機器名稱。
annotated_location 註記的 Chrome 瀏覽器裝置位置。
annotated_user 註記的 Chrome 瀏覽器裝置使用者。
annotated_asset_id 註記的 Chrome 瀏覽器裝置資產 ID。
annotated_note Chrome 瀏覽器裝置的註記。
org_unit_path Chrome 瀏覽器裝置的組織單位路徑，例如 /Marketing。
org_unit_id Chrome 瀏覽器裝置的組織單位 ID。
last_registration_time Chrome 瀏覽器裝置的註冊時間。
os_platform_version Chrome 瀏覽器裝置的 OS 平台和主要版本。
browser_version 裝置上安裝的 Chrome 瀏覽器版本回報資訊。
last_status_report_time Chrome 瀏覽器裝置上次回報狀態的時間。
extension_count Chrome 瀏覽器裝置上安裝的擴充功能數量。
policy_count 套用至 Chrome 瀏覽器裝置的政策數量。
last_device_user 上次登入該電腦的使用者。
last_activity_time Chrome 瀏覽器裝置上次出現活動記錄 (擷取政策或提供報告) 的時間。
device_id_collision 裝置 ID 是否由多部裝置共用，而 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 「Services -> Chrome Management -> Settings -> Managed Browsers」
或「Services -> Chrome Management -> Settings -> Managed Browsers -> Read」
GetChromeBrowser 「Services -> Chrome Management -> Settings -> Managed Browsers」
或「Services -> Chrome Management -> Settings -> Managed Browsers -> Read」
UpdateChromeBrowser 「服務」->「Chrome 管理服務」->「設定」->「受管理的瀏覽器」
MoveChromeBrowsers 「服務」->「Chrome 管理服務」->「設定」->「受管理的瀏覽器」
DeleteChromeBrowser 「服務」->「Chrome 管理服務」->「設定」->「受管理的瀏覽器」

如要管理管理員角色和權限，請依序前往「管理控制台」->「管理員角色」。

API 範圍

Chrome Management Chrome Browsers API 需要下列 OAuth 範圍：

方法 必要的 OAuth 範圍
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
或 https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser 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

詳情請參閱「驗證總覽」。