รายงานกิจกรรมของผู้ดูแลระบบจะแสดงข้อมูลเกี่ยวกับกิจกรรมในคอนโซลผู้ดูแลระบบของผู้ดูแลระบบบัญชีทุกคน แต่ละรายงานใช้คำขอปลายทางของรายงานพื้นฐานร่วมกับพารามิเตอร์เฉพาะรายงาน เช่น ชื่อของผู้ดูแลระบบหรือเหตุการณ์ในคอนโซลผู้ดูแลระบบที่เจาะจง ระยะเวลาสูงสุดสำหรับแต่ละรายงานคือ 180 วันที่ผ่านมา
รายงานกิจกรรมของผู้ดูแลระบบจะใช้เพื่อจุดประสงค์ที่ถูกต้องตามกฎหมายตามข้อตกลงของลูกค้าเท่านั้น รายงานเหล่านี้จะใช้กับบัญชี Google Workspace, Education และ ISP
เรียกข้อมูลกิจกรรมการดูแลระบบทั้งหมด
หากต้องการดึงรายงานเกี่ยวกับกิจกรรมการดูแลระบบทั้งหมดที่ทำสำหรับบัญชี ให้ใช้คำขอ HTTP GET
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารการให้สิทธิ์ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและพร็อพเพอร์ตี้การตอบกลับที่หัวข้อข้อมูลอ้างอิง API ตัวอย่างต่อไปนี้จึงจัดรูปแบบด้วยรูปแบบการขึ้นบรรทัดใหม่เพื่อให้อ่านง่าย
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
ตัวอย่างต่อไปนี้ได้รับรายงานเกี่ยวกับกิจกรรมการดูแลระบบทั้งหมดของบัญชีในช่วง 180 วันที่ผ่านมา ซึ่งเป็นระยะเวลาสูงสุดของรายงาน และสตริงคำค้นหา maxResults
จะระบุว่ารายงานนี้มีเหตุการณ์ 2 รายการต่อหน้ารายงาน ดูตัวอย่างการตอบกลับจาก API ได้ที่ตัวอย่างการตอบสนอง JSON
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
ตัวอย่างต่อไปนี้จะได้รับรายงานเกี่ยวกับกิจกรรมการดูแลระบบทั้งหมดของลูกค้าในช่วง 180 วันที่ผ่านมา customerId
จะระบุลูกค้าที่จะเรียกดูรายงาน
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
เรียกข้อมูลกิจกรรมทั้งหมดโดยผู้ดูแลระบบ
หากต้องการเรียกดูรายงานของกิจกรรมในคอนโซลผู้ดูแลระบบทั้งหมดที่ทำโดยผู้ดูแลระบบที่เฉพาะเจาะจง ให้ใช้คำขอ HTTP GET
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารการให้สิทธิ์ userKey
เป็นอีเมลหลักของผู้ดูแลระบบในรายงาน โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและพร็อพเพอร์ตี้การตอบกลับที่หัวข้อข้อมูลอ้างอิง API ตัวอย่างต่อไปนี้จึงจัดรูปแบบด้วยรูปแบบการขึ้นบรรทัดใหม่เพื่อให้อ่านง่าย
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
ตัวอย่างต่อไปนี้ได้รับรายงานเกี่ยวกับการเปลี่ยนแปลงทั้งหมดที่ดำเนินการกับแอปพลิเคชันคอนโซลผู้ดูแลระบบที่ทำโดย john@example.com
และคำตอบจะถูกกรองเพื่อแสดงกิจกรรมที่มี OLD_VALUE
เท่ากับ ALLOW_CAMERA
ดูตัวอย่างการตอบกลับจาก API ได้ที่ตัวอย่างการตอบสนอง JSON และดูข้อมูลเกี่ยวกับกิจกรรมได้ที่ชื่อกิจกรรมของผู้ดูแลระบบ
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
ดึงข้อมูลกิจกรรมทั้งหมดตามชื่อเหตุการณ์
หากต้องการเรียกรายงานกิจกรรมทั้งหมดสําหรับชื่อเหตุการณ์หนึ่งๆ ให้ใช้คําขอ HTTP GET
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารประกอบการให้สิทธิ์ โปรดดูข้อมูลเกี่ยวกับ eventName
ที่ข้อมูลอ้างอิงชื่อกิจกรรมของผู้ดูแลระบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและพร็อพเพอร์ตี้การตอบกลับที่หัวข้อข้อมูลอ้างอิง API ตัวอย่างต่อไปนี้จึงจัดรูปแบบด้วยรูปแบบการขึ้นบรรทัดใหม่เพื่อให้อ่านง่าย
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
ตัวอย่างต่อไปนี้จะเรียกข้อมูลรายงานสำหรับอินสแตนซ์ทั้งหมดในคอนโซลผู้ดูแลระบบที่มีการเปลี่ยนนามสกุลของผู้ใช้ ดูตัวอย่างการตอบกลับจาก API ได้ที่ตัวอย่างการตอบสนอง JSON
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
ดึงข้อมูลกิจกรรมทั้งหมดตามกิจกรรมและผู้ดูแลระบบ
ในการเรียกดูรายงานการเปลี่ยนแปลงทั้งหมดในคอนโซลผู้ดูแลระบบสำหรับชื่อเหตุการณ์หนึ่งๆ ที่ผู้ดูแลระบบกำหนด ให้ใช้คำขอ HTTP GET
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารการให้สิทธิ์ userKey
เป็นอีเมลหลักของผู้ดูแลระบบในรายงาน โปรดดูข้อมูลเกี่ยวกับ eventName
ที่ข้อมูลอ้างอิงชื่อกิจกรรมของผู้ดูแลระบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและพร็อพเพอร์ตี้การตอบกลับที่หัวข้อข้อมูลอ้างอิง API ตัวอย่างต่อไปนี้จึงจัดรูปแบบด้วยรูปแบบการขึ้นบรรทัดใหม่เพื่อให้อ่านง่าย
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
ตัวอย่างต่อไปนี้จะดึงรายงานสำหรับการเปลี่ยนแปลงทั้งหมดในคอนโซลผู้ดูแลระบบโดยใช้นามสกุลของผู้ใช้ที่ระบุโดย john@example.com
ดูตัวอย่างการตอบกลับจาก API ได้ที่ตัวอย่างการตอบสนอง JSON
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
ตัวอย่างการตอบกลับ JSON ตัวอย่างกิจกรรมของผู้ดูแลระบบ
การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200 นอกจากรหัสสถานะแล้ว การตอบสนองจะแสดงรายงาน โปรดดูข้อมูลเกี่ยวกับ eventName
ที่ข้อมูลอ้างอิงชื่อกิจกรรมของผู้ดูแลระบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหา URL ของคำขอและพร็อพเพอร์ตี้การตอบกลับที่หัวข้อข้อมูลอ้างอิง API
{ "kind": "reports#auditActivities", "nextPageToken": "the next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "report's unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in OAuth 2LO requests" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CHANGE_GROUP_SETTING", "parameters": [ { "name": "SETTING_NAME", "value": "WHO_CAN_JOIN", "intValue": "integer value of parameter", "boolValue": "boolean value of parameter" } ] } ] }, { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "reports unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in an OAuth 2LO request" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CREATE_GROUP", "parameters": [ { "name": "GROUP_EMAIL", "value": "helpdesk@example.com", "intValue": "", "boolValue": "" } ] } ] } ] }