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

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

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

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

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

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

เรียกข้อมูลกิจกรรมการตรวจสอบอุปกรณ์ตามชื่อเหตุการณ์

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

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