ดูข้อมูลเกี่ยวกับฟีเจอร์ API ได้ที่ Chrome Management Security Insights API
คำขอทั้งหมดที่แสดงด้านล่างใช้ตัวแปรต่อไปนี้
$TOKEN- โทเค็น OAuth 2$CUSTOMER- รหัสลูกค้าหรือตัวอักษรmy_customer
ตรวจสอบสถานะการเปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน
หากต้องการตรวจสอบสถานะการเปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน ให้ใช้เมธอด checkEnablementStatus
ส่งคำขอ
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:checkEnablementStatus"
การตอบกลับ
{
"insightsState": "INSIGHTS_ENABLED"
}
เปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน
หากต้องการเปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน ให้ใช้เมธอด enable คุณสามารถเลือกกำหนดค่าตัวเชื่อมต่อ Chrome สำหรับชุด OU ที่เฉพาะเจาะจงได้โดยระบุ targetOus
หากไม่ได้ตั้งค่า targetOus ระบบจะกำหนดค่าตัวเชื่อมต่อ Chrome ที่ OU ระดับราก
ส่งคำขอ
curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"targetOus": [
"/corp/sales",
"/eng"
]
}' \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:enable"
การตอบกลับ
{
"insightsState": "INSIGHTS_ENABLED"
}
ปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน
หากต้องการปิดใช้ข้อมูลเชิงลึกสำหรับโดเมน ให้ใช้เมธอด disable
ส่งคำขอ
curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{}' \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:disable"
การตอบกลับ
{
"insightsState": "INSIGHTS_DISABLED"
}
ค้นหาสรุปการโอนเนื้อหาระดับสูงสำหรับโดเมน
หากต้องการดึงข้อมูลสรุประดับสูงของการโอนเนื้อหา ให้ใช้เมธอด queryContentTransfers
ส่งคำขอ
curl -G \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "filter=event_time >= \"2026-05-01T00:00:00Z\" AND event_time <= \"2026-05-02T00:00:00Z\"" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryContentTransfers"
การตอบกลับ
{
"summaries": [
{
"metric": "CONTENT_TRANSFERS_METRIC_TOTAL_SENSITIVE_TRANSFERS",
"count": "918"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_TOTAL_DOWNLOADS",
"count": "1537"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_TOTAL_UPLOADS",
"count": "1532"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_SENSITIVE_UPLOADS",
"count": "306"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS",
"count": "4596"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_SENSITIVE_PRINTS",
"count": "305"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_SENSITIVE_DOWNLOADS",
"count": "307"
},
{
"metric": "CONTENT_TRANSFERS_METRIC_TOTAL_PRINTS",
"count": "1527"
}
]
}
ค้นหาสรุปการโอนเนื้อหาพร้อมรายละเอียด
หากต้องการค้นหาการโอนเนื้อหาพร้อมรายละเอียดตามมิติข้อมูล (เช่น รายละเอียดตาม USER) ให้ใช้เมธอด queryContentTransfersBreakdowns
ส่งคำขอ
curl -G \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "breakdown=USER" \
--data-urlencode "metric=CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS" \
--data-urlencode "fixedTimeRange=FIXED_TIME_RANGE_FOUR_WEEKS" \
--data-urlencode "filter=user = \"user1\" AND event_time <= \"2026-05-01T00:00:00Z\"" \
--data-urlencode "pageSize=5" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryContentTransfersBreakdowns"
การตอบกลับ
{
"contentTransfersBreakdowns": [
{
"user": "user1",
"summary": {
"metric": "CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS",
"count": "20"
}
}
]
}
ค้นหาสรุปการเข้าชม URL ระดับสูงสำหรับโดเมน
หากต้องการดึงข้อมูลสรุประดับสูงของการเข้าชม URL ที่น่าสงสัย ให้ใช้เมธอด queryUrlVisits
ส่งคำขอ
curl -G \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "filter=event_time >= \"2026-05-01T00:00:00Z\" AND event_time <= \"2026-05-02T00:00:00Z\"" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryUrlVisits"
การตอบกลับ
{
"summaries": [
{
"metric": "URL_VISITS_METRIC_HIGH_RISK_URL_VISITS",
"count": "286"
},
{
"metric": "URL_VISITS_METRIC_LOW_RISK_URL_VISITS",
"count": "287"
},
{
"metric": "URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS",
"count": "859"
},
{
"metric": "URL_VISITS_METRIC_MEDIUM_RISK_URL_VISITS",
"count": "286"
}
]
}
ค้นหาสรุปการเข้าชม URL พร้อมรายละเอียด
หากต้องการค้นหาการเข้าชม URL พร้อมรายละเอียดตามมิติข้อมูล (เช่น รายละเอียดตาม EVENT_DOMAIN) ให้ใช้เมธอด queryUrlVisitsBreakdowns
ส่งคำขอ
curl -G \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "breakdown=EVENT_DOMAIN" \
--data-urlencode "metric=URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS" \
--data-urlencode "fixedTimeRange=FIXED_TIME_RANGE_ONE_WEEK" \
--data-urlencode "filter=event_domain = \"suspicious-domain.com\" AND event_time <= \"2026-05-01T00:00:00Z\"" \
--data-urlencode "pageSize=5" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryUrlVisitsBreakdowns"
การตอบกลับ
{
"urlVisitsBreakdowns": [
{
"eventDomain": "suspicious-domain.com",
"summary": {
"metric": "URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS",
"count": "132"
}
}
]
}