Panduan ini menjelaskan cara menggunakan resource revisions
untuk mengelola revisi file, seperti mendapatkan revisi file dan
menerbitkan revisi Google Workspace. Google Drive API juga memungkinkan Anda mendownload revisi. Untuk mengetahui detail selengkapnya tentang terminologi revisi, lihat Ringkasan perubahan dan revisi.
Untuk mengakses histori revisi, pengguna harus memiliki role owner, organizer, fileOrganizer, atau writer.
Untuk menentukan kolom yang akan ditampilkan dalam respons, Anda dapat menyetel fields
parameter sistem
dengan metode apa pun dari resource revisions. Jika
Anda menghapus parameter, server akan menampilkan kumpulan kolom default. Misalnya, metode revisions.list hanya menampilkan kolom id, mimeType, kind, dan
modifiedTime. Untuk menampilkan kolom yang berbeda, lihat Menampilkan kolom tertentu.
Menentukan revisi yang akan disimpan dari penghapusan otomatis
Google Drive otomatis menghapus revisi lama yang tidak lagi diminati 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.
Jika Anda menggunakan Drive API v2 yang lebih lama, gunakan kolom pinned dari
resource revisions, bukan
keepForever.
Mendapatkan revisi file
Untuk mendapatkan metadata atau konten revisi file, gunakan metode get pada
resource revisions dengan parameter jalur fileId dan
revisionId. Jika Anda tidak mengetahui ID revisi, Anda dapat mencantumkan
semua revisi pada file menggunakan metode list.
Metode ini menampilkan metadata revisi sebagai instance resource revisions.
Untuk mengonfirmasi risiko mendownload malware yang diketahui atau file
berbahaya lainnya, tetapkan parameter kueri
acknowledgeAbuse ke true. Kolom ini hanya berlaku jika parameter alt=media ditetapkan dan pengguna adalah pemilik file atau penyelenggara drive bersama tempat file berada.
Mencantumkan revisi file
Untuk mencantumkan revisi file, gunakan metode list
pada resource revisions dengan
parameter jalur fileId. Metode ini menampilkan daftar revisi file.
Teruskan parameter kueri berikut untuk menyesuaikan penomoran halaman atau memfilter revisi:
pageSize: Jumlah maksimum revisi yang akan ditampilkan per halaman.pageToken: Token halaman, diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.
Memperbarui revisi file
Untuk memperbarui revisi pada file, gunakan metode
update pada resource revisions dengan parameter jalur fileId dan revisionId.
Metode ini menampilkan instance resource revisions.
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 file
Untuk menghapus revisi file secara permanen, gunakan metode
delete pada resource revisions dengan parameter jalur fileId dan revisionId.
Anda hanya dapat menghapus revisi untuk file blob dengan konten biner di Drive, seperti gambar, video, dan PDF. Anda dapat menghapus revisi file blob jika ditandai sebagai "Simpan Selamanya". Revisi untuk file lain, seperti Google Dokumen atau Spreadsheet, dan revisi terakhir yang tersisa dari file biner, tidak dapat dihapus.
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.
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.
Jika file dibuat di domain Google Workspace, properti
publishedOutsideDomain menunjukkan apakah revisi dapat diakses
oleh siapa saja atau apakah revisi 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.
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.