ข้อมูลเบื้องต้นเกี่ยวกับ API กิจกรรม Google ไดรฟ์

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