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}

คำอธิบาย 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_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 -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ"

หากต้องการจัดการบทบาทและสิทธิ์ของผู้ดูแลระบบ ให้ไปที่ "คอนโซลผู้ดูแลระบบ -> บทบาทของผู้ดูแลระบบ"

ขอบเขต 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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์