จัดการการแก้ไขไฟล์

Google Drive API มีแหล่งข้อมูล revisions เพื่อให้คุณดาวน์โหลดและเผยแพร่การแก้ไขไฟล์ได้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับ คำศัพท์เกี่ยวกับการแก้ไขได้ที่ภาพรวมการเปลี่ยนแปลงและการแก้ไข

คู่มือนี้อธิบายวิธีจัดการการแก้ไขไฟล์โดยใช้ Google Drive API

ระบุการแก้ไขที่จะบันทึกจากการลบอัตโนมัติ

Google ไดรฟ์จะลบการแก้ไขเวอร์ชันเก่าที่ผู้ใช้ไม่สนใจแล้วโดยอัตโนมัติ

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

การแก้ไขไฟล์ Blob ทั้งหมดนอกเหนือจากการแก้ไขล่าสุดที่ไม่ได้กำหนดเป็น "เก็บตลอดไป" จะล้างข้อมูลได้ โดยปกติแล้ว ระบบจะเก็บการแก้ไขที่ล้างข้อมูลได้ไว้เป็นเวลา 30 วัน แต่จะล้างข้อมูลก่อนหน้านี้ได้หากไฟล์มีการแก้ไข 100 รายการที่ไม่ได้ กำหนดเป็น "เก็บไว้ตลอด" และมีการอัปโหลดการแก้ไขใหม่

คุณตั้งค่าฟิลด์บูลีน keepForever ของทรัพยากร revisions เป็น true เพื่อทำเครื่องหมายการแก้ไขที่คุณไม่ต้องการให้ไดรฟ์ล้างได้ เมื่อตั้งค่าการแก้ไขไฟล์ Blob เป็น "เก็บไว้ตลอด" แล้ว คุณจะดาวน์โหลดหรือลบได้เท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ดาวน์โหลดฉบับแก้ไขหรือลบฉบับแก้ไข

ดาวน์โหลดการแก้ไข

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

หากต้องการดาวน์โหลดการแก้ไขเนื้อหาของไฟล์ Blob หรือส่งออกการแก้ไขเนื้อหาของเอกสาร Google Workspace โปรดดูดาวน์โหลดและส่งออก ไฟล์

ลบการแก้ไข

คุณเรียกใช้เมธอด revisions.delete เพื่อลบการแก้ไขไฟล์ Blob อย่างถาวรได้ แม้ว่าจะมีการทำเครื่องหมายเป็น "เก็บตลอดไป" ก็ตาม

หากคุณใช้ Drive API v2 เวอร์ชันเก่า ให้ใช้ฟิลด์ pinned ของแหล่งข้อมูล revisions แทน

เผยแพร่การแก้ไข

หากต้องการเผยแพร่ฉบับแก้ไขของ Google เอกสาร, Google ชีต และ Google สไลด์ ให้ตั้งค่าพร็อพเพอร์ตี้ published สำหรับไฟล์นั้นในแหล่งข้อมูล revisions ตั้งค่าพร็อพเพอร์ตี้นี้ไม่ได้ สำหรับการแก้ไข Google Sites โดยใช้ Drive API

Google สไลด์และ Google วาดไม่รองรับการเผยแพร่การแก้ไขที่เฉพาะเจาะจง ระบบรองรับเฉพาะการเผยแพร่ซ้ำอัตโนมัติของการแก้ไขล่าสุดเท่านั้น หากต้องการเผยแพร่สไลด์และวาดเขียน ให้ตั้งค่า publishAuto เป็น true ด้วย

หากสร้างไฟล์ในโดเมน Google Workspace พร็อพเพอร์ตี้ publishedOutsideDomain จะระบุว่าทุกคนเข้าถึงฉบับแก้ไขได้หรือไม่ หรือจำกัดเฉพาะผู้ใช้ในโดเมน สำหรับไฟล์ของเว็บไซต์ พร็อพเพอร์ตี้นี้จะระบุว่ามีtype=anyoneสิทธิ์อยู่หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ฟิลด์ type ในแหล่งข้อมูล permissions

ฉบับที่เผยแพร่จะไม่แสดงการเปลี่ยนแปลงที่ทำกับไฟล์ เว้นแต่จะมีการตั้งค่าพร็อพเพอร์ตี้ publishAuto หากตั้งค่าพร็อพเพอร์ตี้เป็น true ระบบจะเผยแพร่การแก้ไขไฟล์เวอร์ชันใหม่กว่าโดยอัตโนมัติ ซึ่งจะเขียนทับเวอร์ชันก่อนหน้า สไลด์และวาดภาพรองรับเฉพาะการเผยแพร่ซ้ำโดยอัตโนมัติ และกำหนดให้ตั้งค่าพร็อพเพอร์ตี้ publishAuto เป็น true สำหรับไฟล์ใน Sites publishAuto จะเป็น false เสมอ

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