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

เมื่อคุณส่งGETคำขอ HTTP ไปยัง 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"
      }
      ]
     }
    ]
   },
  ]
 }