Google Drive API menyediakan resource revisions
sehingga Anda dapat mendownload dan memublikasikan revisi file. Untuk mengetahui detail selengkapnya tentang
terminologi revisi, lihat Ringkasan perubahan dan revisi.
Panduan ini menjelaskan cara mengelola revisi file menggunakan Google Drive API.
Menentukan revisi yang akan disimpan dari penghapusan otomatis
Google Drive otomatis menghapus revisi lama yang tidak lagi menarik bagi pengguna.
Revisi file blob dapat disetel ke "Simpan Selamanya", yang berarti revisi tidak dapat dihapus secara otomatis. Hingga 200 revisi dapat disetel ke "Simpan Selamanya" dan akan mengurangi batas penyimpanan Anda. Revisi head tidak pernah dihapus otomatis.
Setiap revisi file blob, selain revisi head, yang tidak ditetapkan sebagai "Simpan Selamanya" dapat dihapus. Revisi yang dapat dihapus biasanya dipertahankan selama 30 hari, tetapi dapat dihapus lebih awal jika file memiliki 100 revisi yang tidak ditetapkan sebagai "Pertahankan Selamanya" dan revisi baru diupload.
Anda dapat menetapkan kolom boolean keepForever
dari resource revisions
ke true
untuk menandai revisi yang tidak ingin dihapus oleh Drive. Setelah revisi file blob disetel ke
"Simpan Selamanya", revisi tersebut hanya dapat didownload atau dihapus. Untuk mengetahui informasi selengkapnya, lihat
Mendownload revisi atau Menghapus revisi.
Mendownload revisi
Anda hanya dapat mendownload revisi konten file blob yang ditandai sebagai "Simpan Selamanya". Jika Anda ingin mendownload revisi, pastikan untuk menyetelnya ke "Simpan Selamanya" terlebih dahulu. Untuk mengetahui informasi selengkapnya, lihat Menentukan revisi yang akan disimpan dari penghapusan otomatis.
Untuk mendownload revisi konten file blob atau mengekspor revisi konten dokumen Google Workspace, lihat Mendownload dan mengekspor file.
Menghapus revisi
Anda dapat memanggil metode revisions.delete
untuk menghapus revisi file blob secara permanen, meskipun revisi tersebut ditandai sebagai
"Simpan Selamanya".
Jika Anda menggunakan Drive API v2 yang lebih lama, gunakan kolom pinned
dari
resource revisions
.
Memublikasikan revisi
Untuk memublikasikan revisi Google Dokumen, Google Spreadsheet, dan Google Slide, tetapkan properti published
untuk file tersebut di resource revisions
. Properti ini tidak dapat disetel
untuk revisi Google Sites menggunakan Drive API.
Google Slide dan Google Gambar tidak mendukung publikasi revisi tertentu. Hanya publikasi ulang otomatis revisi terbaru yang didukung. Untuk memublikasikan Slide dan Gambar, tetapkan publishAuto
ke true
.
Jika file dibuat di domain Google Workspace, properti
publishedOutsideDomain
menunjukkan apakah revisi dapat diakses
oleh siapa saja atau apakah aksesnya dibatasi untuk pengguna domain. Untuk file Sites, properti ini menunjukkan apakah izin type=anyone
ada. Untuk
mengetahui informasi selengkapnya, lihat kolom
type
pada
resource permissions
.
Revisi yang dipublikasikan tidak mencerminkan perubahan yang dilakukan pada file kecuali jika properti
publishAuto
ditetapkan. Jika properti disetel ke true
, revisi file yang lebih baru akan dipublikasikan secara otomatis, sehingga menimpa revisi sebelumnya.
Slide dan Gambar hanya mendukung publikasi ulang otomatis dan memerlukan properti publishAuto
ditetapkan ke true
. Untuk
file Sites, publishAuto
selalu false
.
Publikasi otomatis juga dikontrol oleh kotak centang "Publikasikan ulang secara otomatis saat perubahan dilakukan" di UI Dokumen dan Spreadsheet. Untuk mengetahui informasi selengkapnya, lihat Menjadikan Google Dokumen, Spreadsheet, Slide & Formulir bersifat publik.