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