Reports API: รายงานกิจกรรมการตรวจสอบอุปกรณ์

รายงานกิจกรรมการตรวจสอบอุปกรณ์จะแสดงข้อมูลเกี่ยวกับกิจกรรมของอุปกรณ์ทั้งหมดภายใต้การจัดการอุปกรณ์ปลายทางของ Google รายงานแต่ละรายการใช้คําขอปลายทางรายงานพื้นฐานที่มีพารามิเตอร์เฉพาะรายงาน เช่น อีเมลของผู้ใช้ ระยะเวลาสูงสุดของแต่ละรายงานคือ 180 วันที่ผ่านมา

คุณใช้รายงานกิจกรรมการตรวจสอบอุปกรณ์ได้เฉพาะเพื่อวัตถุประสงค์ที่ชอบด้วยกฎหมายตามข้อตกลงลูกค้า ดูเปรียบเทียบ Google Workspace รุ่นต่างๆ เพื่อดูว่ารุ่นใดมีรายงานเหล่านี้

ดึงข้อมูลเหตุการณ์การตรวจสอบอุปกรณ์สำหรับโดเมน

หากต้องการเรียกเหตุการณ์การตรวจสอบอุปกรณ์ทั้งหมดสำหรับผู้ใช้ทั้งหมดภายในโดเมน ให้ใช้GETคำขอ HTTP ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารประกอบการให้สิทธิ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและพร็อพเพอร์ตี้การตอบกลับได้ที่ เหตุการณ์ของกิจกรรมการตรวจสอบอุปกรณ์ ตัวอย่างต่อไปนี้มีการจัดรูปแบบด้วยการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่าน

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

ตัวอย่างต่อไปนี้จะรับรายงานเกี่ยวกับเหตุการณ์การตรวจสอบอุปกรณ์ทั้งหมดของบัญชี ในช่วง 180 วันที่ผ่านมา พารามิเตอร์การค้นหา maxResults จะแสดงผลลัพธ์ 25 รายการต่อหน้า

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

ตัวอย่างต่อไปนี้จะรับรายงานเกี่ยวกับเหตุการณ์การตรวจสอบอุปกรณ์ทั้งหมดในช่วง 180 วันที่ผ่านมา customerId ระบุรายงานของลูกค้าที่จะดึงข้อมูล

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

ดึงข้อมูลเหตุการณ์การตรวจสอบอุปกรณ์ตามชื่อเหตุการณ์

ในบางกรณี คุณอาจต้องการดึงข้อมูลเหตุการณ์ที่เฉพาะเจาะจง เช่น เหตุการณ์กิจกรรมที่น่าสงสัย โดยใช้GETคำขอ HTTP ในรูปแบบต่อไปนี้

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

ตัวอย่างต่อไปนี้แสดงวิธีดึงข้อมูลเหตุการณ์กิจกรรมที่น่าสงสัยทั้งหมดสำหรับผู้ใช้ Android ในโดเมน

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25