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