Google Drive API menyediakan resource Revision agar Anda dapat mendownload dan memublikasikan revisi file. Untuk detail selengkapnya tentang terminologi revisi, lihat Ringkasan perubahan dan revisi.
Tentukan revisi yang akan disimpan dari hapus otomatis
Google Drive otomatis menghapus revisi lama yang tidak lagi menarik bagi pengguna. Untuk mencegah hal ini terjadi, Anda dapat menetapkan tanda boolean keepRevisionForever ke true untuk menandai revisi yang tidak ingin Anda hapus 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 file sebelumnya yang masih tersimpan di cloud, Anda dapat memanggil revisions.list, yang mendapatkan semua revisionId.
Untuk mengunduh konten revisi, Anda perlu 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, serangkaian angka mungkin memiliki celah jika revisi dihapus, jadi Anda tidak boleh bergantung pada nomor urut saat mengambil revisi.
Publikasikan revisi
Untuk memublikasikan revisi Google Dokumen, Spreadsheet, dan Slide, Anda harus menetapkan properti published untuk file tersebut di properti Revisi. Properti ini tidak dapat disetel untuk revisi Google Sites melalui Drive API.
Jika file dibuat di Google Workspace domain,
properti publishedOutsideDomain menunjukkan apakah revisi
dapat diakses oleh siapa saja atau
jika dibatasi untuk pengguna domain. Untuk 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, menimpa revisi sebelumnya. Perilaku ini juga dikontrol oleh opsi "Publikasikan ulang secara otomatis saat perubahan dibuat" kotak centang di UI Drive. Untuk file Google Sites, publishAuto selalu false.