Reports API: รายงานกิจกรรมการเข้าสู่ระบบ

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

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

ดึงข้อมูลเหตุการณ์การเข้าสู่ระบบ Google Workspace สำหรับโดเมน

ในการเรียกข้อมูลเข้าสู่ระบบทั้งหมดสำหรับบริการทั้งหมดของโดเมน ให้ใช้รายการต่อไปนี้ คำขอ HTTP GET และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ใน เอกสารการให้สิทธิ์ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาคำขอและพร็อพเพอร์ตี้การตอบกลับ ดูเอกสารอ้างอิง 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 ตามชื่อเหตุการณ์

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

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