Security Insights API ช่วยให้คุณเปิดหรือปิดใช้ฟีเจอร์ข้อมูลเชิงลึกด้านความปลอดภัยของ Chrome, ตรวจสอบสถานะการเปิดใช้ และค้นหาข้อมูลเชิงลึก (เช่น การโอนเนื้อหาและการเข้าชม URL) ได้
ภาพรวมโดยย่อของเมธอด API
URL จะเกี่ยวข้องกับ
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| คำอธิบาย | URL แบบสัมพัทธ์ | เมธอด HTTP | พารามิเตอร์คำขอที่อนุญาต |
|---|---|---|---|
| เปิดใช้ข้อมูลเชิงลึกสำหรับโดเมนและกำหนดค่าเครื่องมือเชื่อมต่อ Chrome สำหรับ OU ระดับบนสุด/ชุด OU ที่เฉพาะเจาะจงในโดเมน | /enterprise/securityInsights:enable | POST | ไม่บังคับ: targetOus |
| ปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน | /enterprise/securityInsights:disable | POST | |
| ตรวจสอบสถานะการเปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน | /enterprise/securityInsights:checkEnablementStatus | รับ | |
| ค้นหาสรุปการโอนเนื้อหาระดับสูงสำหรับโดเมนของคุณ | /enterprise/securityInsights:queryContentTransfers | รับ | ไม่บังคับ: ตัวกรอง |
| ค้นหาสรุปการโอนเนื้อหาพร้อมรายละเอียดตามหมวดหมู่ผู้ใช้/โดเมน/เนื้อหา | /enterprise/securityInsights:queryContentTransfersBreakdowns | รับ | ไม่บังคับ: ตัวกรอง เมตริก การแบ่งย่อย fixedTimeRange, pageSize, pageToken |
| ค้นหาสรุปการเข้าชม URL ระดับสูงสำหรับโดเมน | /enterprise/securityInsights:queryUrlVisits | รับ | ไม่บังคับ: ตัวกรอง |
| ค้นหาสรุปการเข้าชม URL พร้อมรายละเอียดตามผู้ใช้/โดเมน | /enterprise/securityInsights:queryUrlVisitsBreakdowns | รับ | ไม่บังคับ: ตัวกรอง เมตริก การแบ่งย่อย fixedTimeRange, pageSize, pageToken |
ดูตัวอย่างโค้ดสำหรับ ตัวอย่างคำขอและการตอบกลับ
ข้อกำหนดในการสมัครใช้บริการ
เมธอด API ต่อไปนี้กำหนดให้ต้องมีการสมัครใช้บริการ Chrome Enterprise Premium ที่ใช้งานอยู่ หากลูกค้าไม่ได้สมัครใช้บริการนี้ ระบบจะไม่บล็อกคำขอ แต่ผลการค้นหาจะว่างเปล่า
queryUrlVisitsqueryUrlVisitsBreakdowns
สิทธิ์ของผู้ดูแลระบบ
ต้องมีสิทธิ์ของผู้ดูแลระบบที่แตกต่างกัน ขึ้นอยู่กับวิธีการที่เรียกใช้
| วิธีการ | ต้องมีสิทธิ์ของผู้ดูแลระบบ |
|---|---|
| เปิดใช้ | "หน่วยขององค์กร > อ่าน" "บริการ > การจัดการ Chrome > การตั้งค่า > จัดการการตั้งค่าของผู้ใช้" "บริการ > Chrome DLP > จัดการการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
| ปิดใช้ | "หน่วยขององค์กร > อ่าน" "บริการ > การจัดการ Chrome > การตั้งค่า > จัดการการตั้งค่าของผู้ใช้" "บริการ > Chrome DLP > จัดการการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
| checkEnablementStatus | "หน่วยขององค์กร > อ่าน" "บริการ > Chrome DLP > จัดการการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" หรือ "บริการ > Chrome DLP > ดูการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
| queryContentTransfers | "บริการ > Chrome DLP > ดูการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
| queryContentTransfersBreakdowns | "บริการ > Chrome DLP > ดูการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
| queryUrlVisits | "บริการ > Chrome DLP > ดูการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
| queryUrlVisitsBreakdowns | "บริการ > Chrome DLP > ดูการตั้งค่าข้อมูลเชิงลึกของแอปพลิเคชัน Chrome DLP" |
หากต้องการจัดการบทบาทและสิทธิ์ของผู้ดูแลระบบ ให้ไปที่ "คอนโซลผู้ดูแลระบบ -> บทบาทผู้ดูแลระบบ"
ขอบเขต API
การเปิดใช้และปิดใช้ API ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/chrome.management.securityinsights
สำหรับ checkEnablementStatus และวิธีการค้นหาทั้งหมด คุณสามารถใช้ขอบเขตใดก็ได้ต่อไปนี้
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์