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