รายงานกิจกรรมการเข้าสู่ระบบจะแสดงข้อมูลเกี่ยวกับกิจกรรมการเข้าสู่ระบบของผู้ใช้ทั้งหมดในบัญชี ของคุณ แต่ละรายงานใช้คำขอปลายทางรายงานพื้นฐานที่มี พารามิเตอร์เฉพาะรายงาน เช่น อีเมลของผู้ใช้ ระยะเวลาสูงสุดของแต่ละรายงานคือ 180 วันที่ผ่านมา
คุณใช้รายงานกิจกรรมการเข้าสู่ระบบได้ตามวัตถุประสงค์ที่ชอบด้วยกฎหมายเท่านั้นตามข้อตกลงลูกค้า
ดึงข้อมูลเหตุการณ์การเข้าสู่ระบบ Google Workspace สำหรับโดเมน
หากต้องการดึงข้อมูลการเข้าสู่ระบบทั้งหมดสำหรับบริการทั้งหมดของโดเมน ให้ใช้
GET คำขอ HTTP ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ใน
เอกสารประกอบการให้สิทธิ์
ดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและพร็อพเพอร์ตี้การตอบกลับได้ในการอ้างอิง API
ตัวอย่างต่อไปนี้มีการจัดรูปแบบด้วยการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่าน
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?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/login?maxResults=25
ตัวอย่างต่อไปนี้จะรับรายงานเกี่ยวกับเหตุการณ์การเข้าสู่ระบบทั้งหมดของลูกค้าในช่วง 180 วันที่ผ่านมา
customerId ระบุลูกค้าที่จะดึงข้อมูลรายงาน
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
ดึงข้อมูลเหตุการณ์การเข้าสู่ระบบ Google Workspace ตามชื่อเหตุการณ์
ในบางกรณี คุณอาจต้องการดึงข้อมูลเหตุการณ์ที่เฉพาะเจาะจง
เช่น การเข้าสู่ระบบที่สำเร็จแล้วซึ่งน่าสงสัย โดยใช้GETคำขอ HTTP ในรูปแบบต่อไปนี้
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
ตัวอย่างต่อไปนี้แสดงวิธีดึงข้อมูลการเข้าสู่ระบบที่สำเร็จทั้งหมดที่น่าสงสัย สำหรับโดเมน
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25