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

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 ที่สําคัญที่สุดหรือเป็นตัวแทนของ Action

ดูข้อมูลเพิ่มเติมได้ที่รูปแบบข้อมูลของ Drive Activity API

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

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

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

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

เริ่มต้นใช้งาน

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