เอกสารนี้ให้ภาพรวมของ Google ไดรฟ์ Activity API
Drive Activity API ช่วยให้คุณค้นหาเหตุการณ์ล่าสุดได้ โดยคุณสามารถดึงข้อมูลประวัติกิจกรรมทั้งหมดโดยละเอียด รวมถึงข้อมูลแบบละเอียดเกี่ยวกับแต่ละเหตุการณ์ ซึ่งมีประโยชน์สำหรับงานต่างๆ เช่น การตรวจสอบ เนื่องจากคุณสามารถดึงข้อมูลกิจกรรมที่แม่นยำซึ่งรวมถึงข้อมูล ActionDetail, Actor และ Target ได้
Drive Activity API ประกอบด้วยทรัพยากร
DriveActivity ซึ่งแสดงถึง
การเปลี่ยนแปลงที่ทำกับออบเจ็กต์ภายใน Google ไดรฟ์ของผู้ใช้ และเมธอด
activity.query ซึ่งช่วยให้คุณดึง
ข้อมูลเกี่ยวกับการเปลี่ยนแปลงเหล่านั้นได้
ส่งคำขอ
แอปของคุณส่งคำขอข้อมูลกิจกรรมของผู้ใช้โดยใช้เมธอด activity.query คุณสามารถส่งคำขอข้อมูลกิจกรรมสำหรับรายการไดรฟ์ที่เฉพาะเจาะจงหรือสำหรับทุกรายการที่อยู่ในโฟลเดอร์ไดรฟ์ก็ได้ สำหรับคำขอที่ระบุ คุณสามารถเลือกจำกัดการ
ตอบกลับโดยใช้ตัวกรอง เช่น ช่วงเวลา
หรือประเภทการดำเนินการ และเลือกให้ระบบรวมกิจกรรมไว้ในการตอบกลับได้ ดูข้อมูลเพิ่มเติมได้ที่
ดู ส่งคำขอใน Google Drive Activity API
การตอบกลับ
การตอบกลับจะมีรายการกิจกรรมที่ตรงกับพารามิเตอร์ที่ระบุ โดย
ทรัพยากร DriveActivity จะแสดงถึงแต่ละ
กิจกรรม:
ทรัพยากร DriveActivity คือคอลเล็กชันของ
Action ออบเจ็กต์ ซึ่งแต่ละออบเจ็กต์จะมีข้อมูลครบถ้วนในตัวเอง
เหมือนกับ เหตุการณ์ Action ประกอบด้วย ActionDetail (เช่น Create หรือ Edit), Actor (เช่น User หรือ Administrator), Target (เช่น DriveItem หรือ Drive) และ
Timestamp
หรือ TimeRange
ทรัพยากร DriveActivity ยังมีข้อมูลสรุป เช่น
Actor และ Target ทุกรายการจากการดำเนินการทั้งหมด, Timestamp หรือ TimeRange ที่รวมเป็นหนึ่งเดียว
และ ActionDetail ที่สำคัญที่สุดหรือเป็นตัวแทนของ Action
ดูข้อมูลเพิ่มเติมได้ที่โมเดลข้อมูล Drive Activity API
การมองเห็นประวัติกิจกรรม
ระบบอาจไม่รายงานกิจกรรมบางอย่างในไดรฟ์เมื่อคุณใช้ Drive Activity API API จะรายงานการเปลี่ยนแปลงที่ทำกับออบเจ็กต์ที่ระบุหรือไม่นั้นขึ้นอยู่กับว่าผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ในแอปของคุณมองเห็นการเปลี่ยนแปลงหรือข้อมูลเกี่ยวกับการเปลี่ยนแปลงนั้นหรือไม่
การมองเห็นจะอิงตามสิทธิ์ที่ตั้งไว้สำหรับออบเจ็กต์ มีสถานการณ์หลายอย่างที่ไฟล์และโฟลเดอร์ได้รับการแชร์ในไดรฟ์ ดังนี้
หากผู้เขียนแชร์เอกสาร ประวัติกิจกรรมของเอกสารจะปรากฏแก่ทั้งผู้สร้างและผู้ใช้ที่แชร์ด้วย
หากเอกสารได้รับการแชร์กับผู้ใช้แล้วเปลี่ยนเป็นแบบส่วนตัว ผู้ใช้จะเห็นประวัติกิจกรรมทั้งหมดจากช่วงเวลาที่ตนมีสิทธิ์เข้าถึง แต่จะไม่เห็นหลังจากที่สิทธิ์ถูกจำกัด
หากเอกสารไม่เคยได้รับการแชร์กับผู้ใช้ ผู้ใช้จะมองไม่เห็นประวัติกิจกรรมใดๆ
หัวข้อที่เกี่ยวข้อง
- หากต้องการใช้ประโยชน์จาก Drive Activity API ให้ได้มากที่สุด ให้ผสานรวมแอป กับ Google Drive API ก่อน
- หากต้องการดูข้อมูลเกี่ยวกับการพัฒนาด้วย Google Workspace API รวมถึงการสร้างโปรเจ็กต์หรือการจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ โปรดดูที่ พัฒนาบน Google Workspace
- หากต้องการเรียนรู้เกี่ยวกับกิจกรรม โปรดดูเอกสารอ้างอิง API