รายงานกิจกรรมในไดรฟ์จะแสดงข้อมูลกิจกรรมของผู้ใช้ เมื่อผู้ใช้จัดการ แก้ไข และแชร์ไฟล์ใน 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" } ] } ] }, ] }