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