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