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

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