Kelola revisi file

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.