Reports API: รายงานกิจกรรมของไดรฟ์

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

รายงานกิจกรรมของ Google ไดรฟ์จะใช้เพื่อวัตถุประสงค์ที่ถูกต้องตามกฎหมายในบัญชีที่มีการมอบหมายใบอนุญาตเท่านั้น

ดูข้อมูลเกี่ยวกับสตริงการค้นหาของคําขอและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง API ดูข้อมูลเกี่ยวกับเหตุการณ์ที่เฉพาะเจาะจงที่เกี่ยวข้องกับ Google ไดรฟ์ได้ที่ชื่อเหตุการณ์ของไดรฟ์

ดึงข้อมูลเหตุการณ์ใน Google ไดรฟ์สําหรับโดเมน

คุณสามารถใช้รายงานกิจกรรมในไดรฟ์เพื่อแสดงข้อมูลเกี่ยวกับเอกสารในไดรฟ์ ตัวอย่างเช่น คุณสามารถขอรายงานที่แสดงเหตุการณ์ล่าสุด 25 รายการในไดรฟ์ของบัญชี ซึ่งครอบคลุมระยะเวลาสูงสุด 180 วัน หากต้องการดูรายงานนี้ ให้รับโทเค็นการให้สิทธิ์ตามที่อธิบายไว้ในคำแนะนำการให้สิทธิ์ จากนั้นใช้คำขอ HTTP GET ต่อไปนี้

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

คุณดูตัวอย่างการตอบกลับสำหรับการเรียก API นี้ได้

ตัวอย่างต่อไปนี้จะดึงข้อมูลรายงานเหตุการณ์ทั้งหมดในไดรฟ์ในช่วง 180 วันที่ผ่านมา ซึ่งเป็นระยะเวลาสูงสุด

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

ดึงข้อมูลเหตุการณ์ใน Google ไดรฟ์ตามผู้ใช้

หากต้องการเรียกข้อมูลรายงานกิจกรรมใน Google ไดรฟ์ของผู้ใช้รายใดรายหนึ่ง ให้ใช้คำขอ HTTP GET ที่มีโทเค็นการให้สิทธิ์ตามที่อธิบายไว้ในคู่มือคำแนะนำการให้สิทธิ์ ช่อง userKey คืออีเมลหลักของผู้ใช้ในรายงาน หรือ all สำหรับผู้ใช้ทั้งหมด

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

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

ดึงข้อมูลเหตุการณ์ใน Google ไดรฟ์สำหรับไดรฟ์ที่แชร์

คุณสามารถเรียกดูรายงานกิจกรรมใน Google ไดรฟ์สำหรับไดรฟ์ที่แชร์ได้โดยใช้คำขอ HTTP GET ที่มีโทเค็นการให้สิทธิ์ตามที่อธิบายไว้ในคู่มือการให้สิทธิ์ ระบุอีเมลของผู้ใช้ที่ต้องการเรียกใช้รายงานในช่อง userKey หรือระบุ all เพื่อเรียกใช้รายงานกับผู้ใช้ทั้งหมด

ตัวอย่างต่อไปนี้จะดึงข้อมูลรายงานการเปลี่ยนแปลงทั้งหมดสำหรับไดรฟ์ที่แชร์บางรายการ ดูตัวอย่างการตอบกลับของ API ได้ที่ตัวอย่างการตอบกลับ JSON

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>

หากต้องการเรียกข้อมูลเหตุการณ์สำหรับไดรฟ์ที่แชร์ ให้กรองโดยใช้ doc_type ตัวอย่างต่อไปนี้จะดึงข้อมูลเหตุการณ์ที่ส่งผลต่อไดรฟ์ที่แชร์ทั้งหมด

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive

หากต้องการเรียกข้อมูลเหตุการณ์สําหรับการเปลี่ยนแปลงการเป็นสมาชิก ให้ระบุ shared_drive_membership_change event ตัวอย่างต่อไปนี้จะดึงข้อมูลการเพิ่มสมาชิกทั้งหมดไปยังไดรฟ์ที่แชร์

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive

เรียกข้อมูลเหตุการณ์ใน Google ไดรฟ์ตามประเภทเหตุการณ์

หากต้องการเรียกข้อมูลรายงานอินสแตนซ์ทั้งหมดของเหตุการณ์ประเภทหนึ่งๆ เช่น การสร้างหรือการแก้ไขเอกสาร ให้ใช้คําขอ HTTP GET ที่มีโทเค็นการให้สิทธิ์ตามที่อธิบายไว้ในคู่มือการให้สิทธิ์ ช่อง userKey คืออีเมลหลักของผู้ใช้ในรายงาน หรือ all สำหรับผู้ใช้ทั้งหมด

ตัวอย่างต่อไปนี้จะดึงข้อมูลรายงานกิจกรรมการสร้างเอกสารประกอบของบัญชีทั้งหมด ดูตัวอย่างการตอบกลับของ API ได้ที่ตัวอย่างการตอบกลับ JSON

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

ตัวอย่างการตอบกลับ JSON

เมื่อคุณส่งคําขอ HTTP GET ไปยัง API การตอบกลับที่ประสบความสําเร็จจะแสดงรหัสสถานะ HTTP 200 นอกเหนือจากรหัสสถานะแล้ว การตอบกลับจะแสดงรายงานสำหรับไดรฟ์ด้วย รายงานเหล่านี้มีอยู่ในคอนโซลผู้ดูแลระบบด้วย โปรดดูข้อมูลเพิ่มเติมที่ศูนย์ช่วยเหลือสำหรับผู้ดูแลระบบ Google Workspace ดูข้อมูล eventName ได้ที่ข้อมูลอ้างอิงชื่อเหตุการณ์ของไดรฟ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาของคําขอและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง API

{
 "kind": "reports#auditActivities",
 "nextPageToken": "next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2014-03-17T15:39:18.460Z",
    "uniqQualifier": "report's unique ID",
    "applicationName": "drive",
    "customerId": "ABC123xyz"
   },
   "actor": {
   "callerType": "USER",
   "email": "kim@example.com",
   "profileId": "user's unique Google Workspace profile ID",
   "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "domain of the source owner",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "access",
     "name": "edit",
     "parameters": [
      {
        "name": "primary_event",
        "boolValue": true
      },
      {
        "name": "owner_is_shared_drive",
        "boolValue": false
      },      {
        "name": "doc_id",
        "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
      },
      {
        "name": "doc_title",
        "value": "Meeting notes"
      },
      {
        "name": "doc_type",
        "value": "document"
      },
      {
        "name": "owner",
        "value": "mary@example.com"
      }
      ]
     }
    ]
   },
  ]
 }