คู่มือนี้อธิบายวิธีใช้ 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 หากระบุพารามิเตอร์ alt=media การตอบกลับจะมีเนื้อหาของการแก้ไขในเนื้อหาการตอบกลับ หากต้องการดาวน์โหลดไฟล์ BLOB โปรดดู
หัวข้อดาวน์โหลดเนื้อหาไฟล์ BLOB ในเวอร์ชันก่อนหน้า
หากต้องการรับทราบความเสี่ยงในการดาวน์โหลดมัลแวร์ที่ทราบหรือไฟล์ที่เป็นอันตรายอื่นๆ ให้ตั้งค่าพารามิเตอร์การค้นหา
acknowledgeAbuse เป็น true ช่องนี้ใช้ได้เฉพาะเมื่อตั้งค่าพารามิเตอร์ alt=media และผู้ใช้เป็นเจ้าของไฟล์หรือผู้จัดงานของไดรฟ์ที่แชร์ซึ่งไฟล์นั้นอยู่
แสดงรายการการแก้ไขของไฟล์
หากต้องการแสดงรายการการแก้ไขของไฟล์ ให้ใช้ list
เมธอดในทรัพยากร revisions พร้อม
fileId พารามิเตอร์เส้นทาง เมธอดจะแสดงรายการการแก้ไขไฟล์
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรองการแก้ไข
pageSize: จำนวนการแก้ไขสูงสุดที่จะแสดงผลต่อหน้าpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกรายการก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป
อัปเดตการแก้ไขไฟล์
หากต้องการอัปเดตการแก้ไขในไฟล์ ให้ใช้เมธอด
update ในทรัพยากร revisions พร้อมพารามิเตอร์เส้นทาง fileId และ revisionId
เมธอดจะแสดงผลอินสแตนซ์ของทรัพยากร revisions
ดาวน์โหลดการแก้ไข
คุณจะดาวน์โหลดได้เฉพาะการแก้ไขเนื้อหาไฟล์ BLOB ที่ทำเครื่องหมายเป็น "เก็บไว้ตลอดไป" หากต้องการดาวน์โหลดการแก้ไข โปรดตั้งค่าเป็น "เก็บไว้ตลอดไป" ก่อน ดูข้อมูลเพิ่มเติมได้ที่ ระบุการแก้ไขที่จะบันทึกจากการลบอัตโนมัติ ออก
หากต้องการดาวน์โหลดการแก้ไขเนื้อหาไฟล์ BLOB หรือส่งออกการแก้ไขเนื้อหาเอกสาร Google Workspace โปรดดูหัวข้อดาวน์โหลดและส่งออก ไฟล์
ลบการแก้ไขไฟล์
หากต้องการลบการแก้ไขไฟล์อย่างถาวร ให้ใช้เมธอด
delete ในทรัพยากร revisions พร้อมพารามิเตอร์เส้นทาง fileId และ revisionId path
คุณจะลบได้เฉพาะการแก้ไขไฟล์ BLOB ที่มีเนื้อหาไบนารีในไดรฟ์ เช่น รูปภาพ วิดีโอ และ PDF คุณสามารถลบการแก้ไขไฟล์ BLOB ได้เมื่อมีการทำเครื่องหมายเป็น "เก็บไว้ตลอดไป" แต่จะลบการแก้ไขไฟล์อื่นๆ เช่น Google เอกสารหรือชีต รวมถึงการแก้ไขสุดท้ายของไฟล์ไบนารีไม่ได้
เผยแพร่การแก้ไข
หากต้องการเผยแพร่การแก้ไข Google เอกสาร, Google ชีต และ Google สไลด์ ให้ตั้งค่า
พร็อพเพอร์ตี้ published สำหรับไฟล์นั้นในทรัพยากร
revisions คุณตั้งค่าพร็อพเพอร์ตี้นี้สำหรับการแก้ไข Google Sites โดยใช้ Drive API ไม่ได้
การแก้ไขที่เผยแพร่แล้วจะไม่แสดงการเปลี่ยนแปลงที่ทำกับไฟล์ เว้นแต่จะมีการตั้งค่าพร็อพเพอร์ตี้ publishAuto หากตั้งค่าพร็อพเพอร์ตี้เป็น true ระบบจะเผยแพร่การแก้ไขใหม่ๆ ของไฟล์โดยอัตโนมัติ ซึ่งจะเขียนทับการแก้ไขก่อนหน้า
สไลด์และภาพวาดรองรับเฉพาะการเผยแพร่ซ้ำอัตโนมัติและกำหนดให้ตั้งค่าพร็อพเพอร์ตี้ publishAuto เป็น true สำหรับไฟล์ Sites พร็อพเพอร์ตี้ publishAuto จะเป็น false เสมอ
หากสร้างไฟล์ในโดเมน Google Workspace พร็อพเพอร์ตี้ publishedOutsideDomain จะระบุว่าทุกคนเข้าถึงการแก้ไขได้หรือไม่ หรือจำกัดไว้สำหรับผู้ใช้ในโดเมน สำหรับไฟล์ Sites พร็อพเพอร์ตี้นี้จะระบุว่ามีสิทธิ์ type=anyone หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่
ช่อง
typeใน
permissionsทรัพยากร
การเผยแพร่โดยอัตโนมัติยังควบคุมโดยช่องทำเครื่องหมาย "เผยแพร่ซ้ำโดยอัตโนมัติเมื่อมีการเปลี่ยนแปลง" ใน UI ของเอกสารและชีต ดูข้อมูลเพิ่มเติมได้ที่ ทำให้ Google เอกสาร ชีต สไลด์ และฟอร์ม เป็นสาธารณะ