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}
| คำอธิบาย | Relative 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 พารามิเตอร์ตัวกรองทั้งหมดต้องเป็น URL-escaped เมื่อส่งในคำขอ 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_idlast_policy_fetch_timeannotated_userannotated_locationannotated_asset_idannotated_notesorg_unit_pathos_versionlast_registration_timeextension_countpolicy_countlast_device_usermachine_namebrowser_version_channelos_platform_versionlast_activity_timebrowser_version
สิทธิ์ของผู้ดูแลระบบ
Chrome Browsers API จะเป็นไปตามการมอบสิทธิ์บทบาทผู้ดูแลระบบ
| วิธีการ | ต้องมีสิทธิ์ของผู้ดูแลระบบ |
|---|---|
| ListChromeBrowsers | "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ" หรือ "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ -> อ่าน" |
| GetChromeBrowser | "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ" หรือ "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ -> อ่าน" |
| 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 |
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์