ข้อมูลเบื้องต้นเกี่ยวกับ 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