Google Drive Activity API ประกอบด้วยแหล่งข้อมูล DriveActivity ซึ่งแสดงถึงการเปลี่ยนแปลงที่ทำกับออบเจ็กต์ภายใน Google ไดรฟ์ของผู้ใช้ และเมธอด activity.query ซึ่งช่วยให้คุณเรียกดูข้อมูลเกี่ยวกับการเปลี่ยนแปลงเหล่านั้นได้
ส่งคำขอ
แอปของคุณขอข้อมูลกิจกรรมของผู้ใช้โดยใช้เมธอด activity.query คุณสามารถขอดูกิจกรรมของรายการในไดรฟ์ที่เฉพาะเจาะจง หรือของทุกอย่างที่อยู่ในโฟลเดอร์ในไดรฟ์ก็ได้ สำหรับคำขอหนึ่งๆ คุณเลือกที่จะจำกัดการตอบกลับตามข้อจำกัด เช่น ช่วงเวลาหรือประเภทการดำเนินการ และจะเลือกให้รวมกิจกรรมในคำตอบก็ได้ ดูข้อมูลเพิ่มเติมได้ที่ส่งคำขอใน 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
ระดับการแชร์ประวัติกิจกรรม
ระบบอาจไม่รายงานกิจกรรมบางอย่างในไดรฟ์เมื่อคุณใช้ API นี้ การที่ API กิจกรรมของไดรฟ์จะรายงานการเปลี่ยนแปลงออบเจ็กต์หนึ่งๆ หรือไม่นั้น ขึ้นอยู่กับว่าการเปลี่ยนแปลงหรือข้อมูลเกี่ยวกับการเปลี่ยนแปลงนั้นจะปรากฏต่อผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ในแอปพลิเคชันของคุณหรือไม่
การมองเห็นจะอิงตามสิทธิ์ที่กำหนดไว้สำหรับออบเจ็กต์ มีหลายสถานการณ์ที่ไฟล์และโฟลเดอร์มีการแชร์ในไดรฟ์ ดังนี้
- หากผู้เขียนแชร์เอกสาร ทั้งผู้สร้างและผู้ใช้ที่ตรวจสอบสิทธิ์แล้วจะสามารถมองเห็นประวัติกิจกรรมของเอกสารได้
- หากมีการแชร์เอกสารกับผู้ใช้แล้วทำให้เป็นแบบส่วนตัว ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วจะเห็นประวัติกิจกรรมทั้งหมดในขณะที่มีสิทธิ์เข้าถึง และตอนนี้สิทธิ์ถูกจํากัดแล้ว
- หากไม่เคยมีการแชร์เอกสารกับผู้ใช้ ผู้ใช้จะไม่เห็นประวัติกิจกรรมใดๆ
เริ่มต้นใช้งาน
หากต้องการใช้ Drive Activity API ให้ได้ประโยชน์สูงสุด ให้ผสานรวมแอปกับ Google Drive API ก่อน หากต้องการเริ่มต้นใช้งาน Drive Activity API ดูวิธีสร้างโปรเจ็กต์และให้สิทธิ์คำขอ หรือจะอ่านข้อมูลเกี่ยวกับกิจกรรมในเอกสารอ้างอิง API เลยก็ได้