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