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

คำแนะนำนี้อธิบายวิธีใช้revisions เพื่อจัดการการแก้ไขไฟล์ เช่น การรับการแก้ไขไฟล์และการ เผยแพร่การแก้ไขใน Google Workspace นอกจากนี้ Google ไดรฟ์ 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: โทเค็นหน้าเว็บที่ได้รับจากการเรียก 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จะระบุว่าทุกคนเข้าถึงฉบับร่างได้หรือไม่ หรือจำกัดเฉพาะผู้ใช้ในโดเมน สำหรับไฟล์ Sites พร็อพเพอร์ตี้นี้จะระบุว่ามีtype=anyoneสิทธิ์อยู่หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ฟิลด์ type ในแหล่งข้อมูล permissions

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