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

รายงานกิจกรรมของผู้ดูแลระบบจะแสดงข้อมูลเกี่ยวกับ กิจกรรมในคอนโซลผู้ดูแลระบบของผู้ดูแลระบบทั้งหมดในบัญชี รายงานแต่ละรายการใช้คำขอปลายทางของรายงานพื้นฐานที่มีพารามิเตอร์เฉพาะของรายงาน เช่น ชื่อผู้ดูแลระบบหรือเหตุการณ์ในคอนโซลผู้ดูแลระบบที่เฉพาะเจาะจง ระยะเวลาสูงสุดของแต่ละรายงานคือ 180 วันที่ผ่านมา

คุณใช้รายงานกิจกรรมของผู้ดูแลระบบได้เฉพาะเพื่อวัตถุประสงค์ที่ชอบด้วยกฎหมายตามข้อตกลงลูกค้า และรายงานเหล่านี้มีผลกับบัญชี Google Workspace, Education และ ISP

เรียกข้อมูลกิจกรรมการดูแลระบบทั้งหมด

หากต้องการดึงข้อมูลรายงานกิจกรรมการดูแลระบบทั้งหมดที่ดำเนินการสำหรับบัญชี ให้ใช้GETคำขอ HTTP ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ ที่อธิบายไว้ในเอกสารประกอบการให้สิทธิ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคำขอและ พร็อพเพอร์ตี้การตอบกลับได้ที่ การอ้างอิง 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

ดึงข้อมูลกิจกรรมทั้งหมดโดยผู้ดูแลระบบ

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

ดึงข้อมูลกิจกรรมทั้งหมดตามชื่อเหตุการณ์

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

ดึงข้อมูลกิจกรรมทั้งหมดตามเหตุการณ์และผู้ดูแลระบบ

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