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