คำแนะนำนี้อธิบายวิธีใช้revisions
แหล่งข้อมูลเพื่อจัดการการแก้ไขไฟล์ เช่น การรับการแก้ไขไฟล์และการ
เผยแพร่การแก้ไข Google Workspace นอกจากนี้ Google Drive API ยังให้คุณ
ดาวน์โหลดการแก้ไขได้ด้วย ดูรายละเอียดเพิ่มเติมเกี่ยวกับคำศัพท์ในการแก้ไขได้ที่ภาพรวมของการเปลี่ยนแปลง
และการแก้ไข
หากต้องการเข้าถึงประวัติการแก้ไข ผู้ใช้ต้องมีroleของ owner,
organizer, fileOrganizer หรือ writer
หากต้องการระบุช่องที่จะแสดงผลในการตอบกลับ คุณสามารถตั้งค่าfields
พารามิเตอร์ของระบบ
ด้วยเมธอดใดก็ได้ของทรัพยากร revisions หาก
คุณละเว้นพารามิเตอร์ เซิร์ฟเวอร์จะแสดงผลชุดฟิลด์เริ่มต้น ตัวอย่างเช่น เมธอด revisions.list จะแสดงผลเฉพาะช่อง id, mimeType, kind และ modifiedTime หากต้องการแสดงช่องอื่น ให้ดูแสดงช่องที่เฉพาะเจาะจง
ระบุการแก้ไขที่จะบันทึกจากการลบอัตโนมัติ
Google ไดรฟ์จะลบการแก้ไขเวอร์ชันเก่าที่ผู้ใช้ไม่สนใจแล้วโดยอัตโนมัติ
การแก้ไขไฟล์ BLOB สามารถตั้งค่าเป็น "เก็บถาวร" ได้ ซึ่งหมายความว่าระบบจะไม่ล้างข้อมูลการแก้ไขโดยอัตโนมัติ คุณตั้งค่าให้เก็บฉบับแก้ไขได้สูงสุด 200 รายการแบบ "เก็บไว้ตลอด" และระบบจะนับรวมฉบับแก้ไขเหล่านั้นในโควต้าพื้นที่เก็บข้อมูล ของคุณ ระบบจะไม่ล้างข้อมูลการแก้ไขล่าสุดโดยอัตโนมัติ
การแก้ไขไฟล์ Blob ทั้งหมดนอกเหนือจากการแก้ไขล่าสุดที่ไม่ได้กำหนดเป็น "เก็บตลอดไป" จะล้างข้อมูลได้ โดยปกติแล้ว ระบบจะเก็บการแก้ไขที่ล้างข้อมูลได้ไว้เป็นเวลา 30 วัน แต่จะล้างข้อมูลก่อนหน้านี้ได้หากไฟล์มีการแก้ไข 100 รายการที่ไม่ได้ กำหนดเป็น "เก็บไว้ตลอด" และมีการอัปโหลดการแก้ไขใหม่
คุณตั้งค่าฟิลด์บูลีน keepForever ของทรัพยากร revisions เป็น true เพื่อทำเครื่องหมายการแก้ไขที่คุณไม่ต้องการให้ไดรฟ์ล้างได้ เมื่อตั้งค่าการแก้ไขไฟล์ Blob เป็น "เก็บไว้ตลอด" แล้ว คุณจะดาวน์โหลดหรือลบได้เท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ดาวน์โหลดฉบับแก้ไขหรือลบฉบับแก้ไข
หากคุณใช้ Drive API v2 เวอร์ชันเก่า ให้ใช้ฟิลด์ pinned ของทรัพยากร
revisions แทน
keepForever
รับการแก้ไขไฟล์
หากต้องการรับข้อมูลเมตาหรือเนื้อหาของไฟล์ที่แก้ไข ให้ใช้วิธี get ในทรัพยากร revisions ที่มีพารามิเตอร์เส้นทาง fileId และ revisionId หากไม่ทราบรหัสการแก้ไข คุณสามารถแสดง
การแก้ไขทั้งหมดในไฟล์โดยใช้วิธี list
เมธอดจะแสดงข้อมูลเมตาของการแก้ไขเป็นอินสแตนซ์ของทรัพยากร revisions
หากต้องการรับทราบความเสี่ยงในการดาวน์โหลดมัลแวร์ที่รู้จักหรือไฟล์อื่นๆ ที่ละเมิด ให้ตั้งค่าพารามิเตอร์การค้นหา acknowledgeAbuse เป็น true ฟิลด์นี้จะใช้ได้ก็ต่อเมื่อมีการตั้งค่าพารามิเตอร์ alt=media และผู้ใช้เป็นเจ้าของไฟล์หรือผู้จัดการไดรฟ์ที่แชร์ซึ่งมีไฟล์อยู่
แสดงรายการการแก้ไขของไฟล์
หากต้องการแสดงรายการการแก้ไขของไฟล์ ให้ใช้เมธอด list
ในทรัพยากร revisions โดยใช้
พารามิเตอร์เส้นทาง fileId เมธอดจะแสดงรายการการแก้ไขไฟล์
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรอง การแก้ไข
pageSize: จำนวนการแก้ไขสูงสุดที่จะแสดงต่อหน้าpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียก list ก่อนหน้า ระบุโทเค็นนี้ เพื่อดึงข้อมูลหน้าถัดไป
อัปเดตการแก้ไขไฟล์
หากต้องการอัปเดตการแก้ไขในไฟล์ ให้ใช้เมธอด
update ในทรัพยากร revisions ที่มีพารามิเตอร์เส้นทาง fileId และ revisionId
เมธอดจะแสดงอินสแตนซ์ของทรัพยากร revisions
ดาวน์โหลดการแก้ไข
คุณจะดาวน์โหลดได้เฉพาะการแก้ไขเนื้อหาไฟล์ Blob ที่ทำเครื่องหมายว่า "เก็บตลอดไป" หาก ต้องการดาวน์โหลดเวอร์ชัน ให้ตั้งค่าเป็น "เก็บไว้ตลอดไป" ก่อน ดูข้อมูลเพิ่มเติมได้ที่ระบุการแก้ไขที่จะบันทึกจากการลบอัตโนมัติ
หากต้องการดาวน์โหลดการแก้ไขเนื้อหาของไฟล์ Blob หรือส่งออกการแก้ไขเนื้อหาของเอกสาร Google Workspace โปรดดูดาวน์โหลดและส่งออก ไฟล์
ลบการแก้ไขไฟล์
หากต้องการลบการแก้ไขไฟล์อย่างถาวร ให้ใช้วิธี delete ในทรัพยากร revisions ที่มีพารามิเตอร์เส้นทาง fileId และ revisionId
คุณจะลบได้เฉพาะการแก้ไขไฟล์ BLOB ที่มีเนื้อหาไบนารีใน ไดรฟ์ เช่น รูปภาพ วิดีโอ และ PDF คุณสามารถลบการแก้ไขไฟล์ Blob ได้เมื่อมีการทำเครื่องหมายว่า "เก็บตลอดไป" คุณจะลบการแก้ไขไฟล์อื่นๆ เช่น Google เอกสารหรือชีต และการแก้ไขไฟล์ไบนารีที่เหลือล่าสุดไม่ได้
เผยแพร่การแก้ไข
หากต้องการเผยแพร่ฉบับแก้ไขของ Google เอกสาร, Google ชีต และ Google สไลด์ ให้ตั้งค่าพร็อพเพอร์ตี้ published สำหรับไฟล์นั้นในแหล่งข้อมูล revisions ตั้งค่าพร็อพเพอร์ตี้นี้ไม่ได้
สำหรับการแก้ไข Google Sites โดยใช้ Drive API
ฉบับที่เผยแพร่จะไม่แสดงการเปลี่ยนแปลงที่ทำกับไฟล์ เว้นแต่จะมีการตั้งค่าพร็อพเพอร์ตี้
publishAuto หากตั้งค่าพร็อพเพอร์ตี้เป็น true ระบบจะเผยแพร่การแก้ไขไฟล์เวอร์ชันใหม่กว่าโดยอัตโนมัติ ซึ่งจะเขียนทับเวอร์ชันก่อนหน้า
สไลด์และวาดรองรับเฉพาะการเผยแพร่ซ้ำโดยอัตโนมัติ
และกำหนดให้ตั้งค่าพร็อพเพอร์ตี้ publishAuto เป็น true สำหรับไฟล์ใน
Sites publishAuto จะเป็น false เสมอ
หากสร้างไฟล์ในโดเมน Google Workspace พร็อพเพอร์ตี้
publishedOutsideDomain จะระบุว่าทุกคนเข้าถึงฉบับแก้ไขได้หรือไม่
หรือจำกัดเฉพาะผู้ใช้ในโดเมน สำหรับไฟล์ของเว็บไซต์ พร็อพเพอร์ตี้นี้จะระบุว่ามีtype=anyoneสิทธิ์อยู่หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ฟิลด์ type ในทรัพยากร permissions
นอกจากนี้ การเผยแพร่โดยอัตโนมัติยังควบคุมได้ด้วยช่องทำเครื่องหมาย "เผยแพร่ซ้ำโดยอัตโนมัติเมื่อมีการเปลี่ยนแปลง" ใน UI ของเอกสารและชีต ดูข้อมูลเพิ่มเติมได้ที่หัวข้อทำให้ Google เอกสาร ชีต สไลด์ และฟอร์ม เป็นสาธารณะ