รายงานกิจกรรมของผู้ดูแลระบบ

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