Mendownload dan memublikasikan revisi file

Google Drive API menyediakan referensi Revisi sehingga Anda dapat mendownload dan memublikasikan revisi file. Untuk mengetahui detail selengkapnya tentang terminologi revisi, lihat Ringkasan perubahan dan revisi.

Tentukan revisi yang akan disimpan dari penghapusan otomatis

Google Drive akan otomatis menghapus revisi lama yang tidak lagi menarik bagi pengguna. Untuk mencegah hal ini terjadi, Anda dapat menyetel flag boolean keepRevisionForever ke true untuk menandai revisi yang tidak ingin dihapus permanen oleh Drive.

Mendownload revisi

Anda dapat menggunakan nilai kolom headRevisionId dari resource Files untuk mendownload revisi terbaru. Tindakan ini akan mengambil revisi yang sesuai dengan metadata file yang sebelumnya Anda ambil. Untuk mendownload data semua revisi sebelumnya dari file yang masih tersimpan di cloud, Anda dapat memanggil revisions.list, yang mendapatkan semua revisiId.

Untuk mendownload konten revisi, Anda harus memanggil metode revisions.get dengan parameter alt=media. Revisi untuk Google Dokumen, Spreadsheet, dan Slide tidak dapat didownload.

Revisi Google Dokumen, Google Gambar, dan Slide akan menambahkan angka revisi secara otomatis. Namun, rangkaian nomor mungkin memiliki celah jika revisi dihapus, jadi sebaiknya Anda tidak mengandalkan nomor urut saat mengambil revisi.

Memublikasikan revisi

Untuk memublikasikan revisi Google Dokumen, Spreadsheet, dan Slide, tetapkan properti published untuk file tersebut di properti Revisi. Properti ini tidak dapat ditetapkan untuk revisi Google Sites melalui Drive API.

Jika file dibuat di domain Google Workspace , properti publishedOutsideDomain akan menunjukkan apakah revisi dapat diakses oleh siapa saja atau terbatas untuk pengguna domain tersebut. Untuk file Google Sites, properti ini menunjukkan apakah izin type=anyone ada.

Revisi yang dipublikasikan tidak mencerminkan perubahan yang dibuat pada file kecuali jika properti publishAuto disetel. Jika properti tersebut disetel ke benar (true), revisi file yang lebih baru akan otomatis dipublikasikan, yang menimpa revisi sebelumnya. Perilaku ini juga dikontrol oleh kotak centang "Publikasikan ulang secara otomatis saat perubahan dibuat" di UI Drive. Untuk file Google Sites, publishAuto selalu false.