รายงานกิจกรรมการเข้าสู่ระบบจะแสดงข้อมูลเกี่ยวกับกิจกรรมการลงชื่อเข้าใช้ของผู้ใช้บัญชีทุกคน แต่ละรายงานจะใช้คำขอปลายทางของรายงานพื้นฐานกับพารามิเตอร์ที่เจาะจงของรายงาน เช่น อีเมลของผู้ใช้ ช่วงเวลาสูงสุดสำหรับแต่ละรายงานคือ 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