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

เอกสารนี้ให้ภาพรวมของ Google Drive Activity API

Drive Activity API ช่วยให้คุณค้นหาเหตุการณ์ล่าสุดได้ โดยคุณสามารถดึงประวัติโดยละเอียดของกิจกรรมทั้งหมด รวมถึงข้อมูลแบบละเอียดเกี่ยวกับแต่ละเหตุการณ์ ซึ่งมีประโยชน์สำหรับงานต่างๆ เช่น การตรวจสอบ เนื่องจากคุณสามารถดึงกิจกรรมที่แม่นยำซึ่งรวมถึงข้อมูล ActionDetail, Actor และ Target ได้

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

ส่งคำขอ

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

คำตอบ

การตอบกลับจะมีรายการกิจกรรมที่ตรงกับพารามิเตอร์ที่ระบุ โดย ทรัพยากร DriveActivity จะแสดงถึงแต่ละ กิจกรรม:

คำอธิบายข้อความในเนื้อหาการตอบกลับของ Drive Activity API
รูปที่ 1 คำอธิบายข้อความเนื้อหาการตอบกลับของ Drive Activity API

ทรัพยากร DriveActivity คือคอลเล็กชันของ Action ออบเจ็กต์ ซึ่งแต่ละออบเจ็กต์จะมีข้อมูลครบถ้วนในตัวเอง เหมือนกับ เหตุการณ์ Action ประกอบด้วย ActionDetail (เช่น Create หรือ Edit), Actor (เช่น User หรือ Administrator), Target (เช่น DriveItem หรือ Drive) และ Timestamp หรือ TimeRange

ทรัพยากร DriveActivity ยังมีข้อมูลสรุป เช่น Actor และ Target ทุกรายการจากการดำเนินการทั้งหมด, Timestamp หรือ TimeRange ที่รวมเป็นหนึ่งเดียว และ ActionDetail ที่สำคัญที่สุดหรือเป็นตัวแทนของ Action

ดูข้อมูลเพิ่มเติมได้ที่โมเดลข้อมูล Drive Activity API

การมองเห็นประวัติกิจกรรม

ระบบอาจไม่รายงานกิจกรรมบางอย่างในไดรฟ์เมื่อคุณใช้ Drive Activity API การที่ API จะรายงานการเปลี่ยนแปลงที่ระบุในออบเจ็กต์หรือไม่นั้นขึ้นอยู่กับว่าผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ในแอปของคุณจะมองเห็นการเปลี่ยนแปลงหรือข้อมูลเกี่ยวกับการเปลี่ยนแปลงนั้นหรือไม่

การมองเห็นจะอิงตามสิทธิ์ที่ตั้งไว้สำหรับออบเจ็กต์ มีสถานการณ์หลายอย่างเมื่อมีการแชร์ไฟล์และโฟลเดอร์ในไดรฟ์ ดังนี้

  • หากผู้เขียนแชร์เอกสาร ประวัติกิจกรรมของเอกสารจะปรากฏแก่ทั้งผู้สร้างและผู้ใช้ที่แชร์ด้วย

  • หากเอกสารมีการแชร์กับผู้ใช้แล้วเปลี่ยนเป็นส่วนตัว ผู้ใช้จะเห็นประวัติกิจกรรมทั้งหมดตั้งแต่ช่วงเวลาที่ตนมีสิทธิ์เข้าถึง แต่จะไม่เห็นหลังจากที่สิทธิ์ถูกจำกัด

  • หากไม่เคยแชร์เอกสารกับผู้ใช้ ผู้ใช้จะมองไม่เห็นประวัติกิจกรรมใดๆ

  • หากต้องการใช้ประโยชน์จาก Drive Activity API ให้ได้มากที่สุด ให้ผสานรวมแอป กับ Google Drive API ก่อน
  • หากต้องการดูข้อมูลเกี่ยวกับการพัฒนาด้วย Google Workspace API รวมถึงการสร้างโปรเจ็กต์หรือการจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ โปรดดูที่ พัฒนาบน Google Workspace
  • หากต้องการดูข้อมูลเกี่ยวกับกิจกรรม โปรดดูเอกสารอ้างอิง API