Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

API Quản lý Chrome cho Trình duyệt Chrome

API Trình duyệt Chrome trong API Quản lý Chrome cho phép quản trị viên xem dữ liệu và quản lý các trình duyệt Chrome đã đăng ký trong Chrome Enterprise Core. Bạn có thể sử dụng nhóm API này để liệt kê các trình duyệt Chrome đã đăng ký, truy xuất trình duyệt Chrome, cập nhật thông tin chú thích cho trình duyệt Chrome, di chuyển trình duyệt Chrome giữa các Đơn vị tổ chức (OU) và xoá dữ liệu thu thập được từ trình duyệt Chrome.

Tổng quan nhanh về các phương thức API

URL liên quan đến https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Mô tả	URL tương đối	Phương thức HTTP
Liệt kê các trình duyệt Chrome đã đăng ký	/chromeBrowsers	NHẬN
Truy xuất trình duyệt Chrome	/chromeBrowsers/{browser_permanent_id}	NHẬN
Cập nhật thông tin chú thích cho trình duyệt Chrome	/chromeBrowsers/{browser_permanent_id}	PATCH
Di chuyển trình duyệt Chrome sang một đơn vị tổ chức (OU) mới	/chromeBrowsers:move	POST
Xoá dữ liệu thu thập được từ trình duyệt Chrome	/chromeBrowsers/{browser_permanent_id}	XÓA

Xem mã mẫu để biết các yêu cầu và phản hồi mẫu.

Đang lọc kết quả

Khi liệt kê các trình duyệt Chrome bằng phương thức /chromeBrowsers, bạn có thể thu hẹp kết quả bằng tham số truy vấn filter. Tất cả tham số bộ lọc phải được thoát URL khi gửi trong yêu cầu HTTP. Bạn có thể kết hợp nhiều điều kiện bằng toán tử AND.

Trường Chuỗi, Số nguyên và Enum: Hỗ trợ toán tử so sánh = và :. Ký tự đại diện * (tiền tố prefix*, hậu tố *suffix, chuỗi con *substring* hoặc sự hiện diện *) chỉ được hỗ trợ với = và : cho machine_name, annotated_asset_id và browser_version (ví dụ: machine_name=LIX* hoặc browser_version:"*6367*"). Tính năng lọc giá trị cố định chuỗi chung không được trang trí (không có tên trường) cũng được hỗ trợ: một cụm từ duy nhất như ABC sẽ khớp nếu bất kỳ trường chuỗi được lập chỉ mục nào chứa ABC và nhiều cụm từ được nối bằng AND hoặc khoảng trắng (ví dụ: machine AND 73 hoặc machine 73) sẽ khớp với các trình duyệt chứa mọi cụm từ được chỉ định trên bất kỳ trường văn bản được lập chỉ mục nào của chúng (trong khi một chuỗi nhiều từ được trích dẫn duy nhất như "machine 73" sẽ khớp với cụm từ liền kề chính xác trong một trường duy nhất).
Trường dấu thời gian: Hỗ trợ các toán tử so sánh =, <= và >=. Dấu thời gian cần có một chuỗi được định dạng theo RFC-3339 và nằm trong dấu ngoặc kép (ví dụ: "2020-01-01T12:00:00Z" hoặc "2012-04-21T11:30:00-04:00"). Bạn có thể chỉ định phạm vi dấu thời gian đóng bằng cách so sánh.
Lọc theo đơn vị tổ chức: Bạn có thể lọc các trình duyệt thuộc một đơn vị tổ chức cụ thể bằng cách chỉ định org_unit_path (ví dụ: org_unit_path=/Marketing). Bạn có thể so khớp một đơn vị tổ chức.
Lọc theo nhóm: Bạn có thể lọc các trình duyệt thuộc một nhóm Cloud Identity cụ thể bằng hàm in_group (ví dụ: in_group("groups/00gjdgxs0lm8l7o")).

Trường có thể lọc

Trường	Mô tả
`browser_permanent_id`	Giá trị nhận dạng riêng biệt cố định của thiết bị trình duyệt Chrome.
`last_policy_fetch_time`	Thời gian tìm nạp chính sách gần đây nhất cho thiết bị trình duyệt Chrome.
`os_platform`	Nền tảng hệ điều hành cho thiết bị trình duyệt Chrome (ví dụ: `WINDOWS`, `MAC`, `LINUX`).
`os_architecture`	Cấu trúc hệ điều hành của thiết bị trình duyệt Chrome.
`os_version`	Phiên bản hệ điều hành của thiết bị chạy trình duyệt Chrome.
`machine_name`	Tên của máy liên kết với thiết bị có trình duyệt Chrome.
`annotated_location`	Vị trí được chú thích cho thiết bị Trình duyệt Chrome.
`annotated_user`	Người dùng được chú thích cho thiết bị Trình duyệt Chrome.
`annotated_asset_id`	Mã tài sản được chú thích cho thiết bị Trình duyệt Chrome.
`annotated_note`	Ghi chú được chú thích cho thiết bị Trình duyệt Chrome.
`org_unit_path`	Đường dẫn đơn vị tổ chức cho thiết bị Trình duyệt Chrome (ví dụ: `/Marketing`).
`org_unit_id`	Mã đơn vị tổ chức của thiết bị trình duyệt Chrome.
`last_registration_time`	Thời gian đăng ký cho thiết bị trình duyệt Chrome.
`os_platform_version`	Nền tảng hệ điều hành và phiên bản lớn của thiết bị trình duyệt Chrome.
`browser_version`	Phiên bản trình duyệt Chrome được báo cáo là đã cài đặt trên thiết bị.
`last_status_report_time`	Thời gian báo cáo trạng thái gần đây nhất cho thiết bị trình duyệt Chrome.
`extension_count`	Số lượng tiện ích được cài đặt trên thiết bị có trình duyệt Chrome.
`policy_count`	Số lượng chính sách được áp dụng cho thiết bị trình duyệt Chrome.
`last_device_user`	Người dùng đăng nhập gần đây nhất trên máy.
`last_activity_time`	Lần gần đây nhất thiết bị dùng trình duyệt Chrome có hoạt động (tìm nạp chính sách hoặc báo cáo).
`device_id_collision`	Liệu mã thiết bị có được chia sẻ bởi nhiều máy mà Trình duyệt Chrome xác định là cùng một máy hay không (`true` hoặc `false`).

Hàm lọc

Chức năng	Mô tả
`in_group(string)`	Lọc danh sách thiết bị trình duyệt Chrome để chỉ hiển thị những thiết bị thuộc tên tài nguyên nhóm Cloud Identity được chỉ định (định dạng: `in_group("groups/{group_id}")`).

Sắp xếp kết quả

Bạn có thể chỉ định thứ tự của kết quả bằng tham số truy vấn orderBy. Theo mặc định, thứ tự sắp xếp là tăng dần. Để chỉ định thứ tự giảm dần cho một trường, hãy thêm hậu tố " desc" vào tên trường (ví dụ: last_activity_time desc).

Nếu bạn không chỉ định, thứ tự mặc định sẽ là thứ tự tăng dần của browser_permanent_id.

Các trường sắp xếp được hỗ trợ

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

Đặc quyền của quản trị viên

API Trình duyệt Chrome tuân thủ việc uỷ quyền vai trò của quản trị viên.

Phương thức	Cần có đặc quyền của quản trị viên
ListChromeBrowsers	"Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý" hoặc "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý -> Đọc"
GetChromeBrowser	"Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý" hoặc "Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý -> Đọc"
UpdateChromeBrowser	"Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý"
MoveChromeBrowsers	"Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý"
DeleteChromeBrowser	"Dịch vụ -> Quản lý Chrome -> Cài đặt -> Trình duyệt được quản lý"

Để quản lý vai trò và đặc quyền của quản trị viên, hãy truy cập vào "Bảng điều khiển dành cho quản trị viên -> Vai trò quản trị".

Phạm vi API

API Trình duyệt Chrome trong API Quản lý Chrome yêu cầu các phạm vi OAuth sau:

Phương thức	Cần có phạm vi OAuth
ListChromeBrowsers	https://www.googleapis.com/auth/chrome.management.browsers hoặc https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser	https://www.googleapis.com/auth/chrome.management.browsers hoặc 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

Để biết thêm thông tin, hãy xem phần Tổng quan về quy trình xác thực.