Mendownload dan memublikasikan revisi file

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.

Catatan: Akses ke revisi historis dibatasi berdasarkan peran. Periksa Kolom capabilities.canReadRevisions pada file sebelum mencoba mengaksesnya.

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

Catatan: Jika Anda menggunakan Drive API v2 versi lama, Anda harus mengirim file GET ke properti downloadUrl-nya. Google Drive membuat ini URL berumur pendek saat Anda meminta revisi — jangan mengandalkannya untuk digunakan nanti. Anda juga dapat mengekspor revisi dalam salah satu format yang didukung dengan mencentang exportLinks.

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.