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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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