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 กิจกรรม ตัวอย่างต่อไปนี้จะเรียกข้อมูลสมาชิกทั้งหมดที่เพิ่มลงในไดรฟ์ที่แชร์

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"
      }
      ]
     }
    ]
   },
  ]
 }