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

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

คุณต้องทำตามขั้นตอนในข้อกำหนดเบื้องต้นของ Reports API ก่อนใช้ API เพื่อเรียกดูรายงาน

รายงานกิจกรรม 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"
      }
      ]
     }
    ]
   },
  ]
 }