Bu kılavuzda, dosya düzeltmelerini yönetmek için revisions
kaynağının nasıl kullanılacağı (ör. dosya düzeltmesi alma ve Google Workspace düzeltmesi yayınlama) açıklanmaktadır. Google Drive API, revizyonları indirmenize de olanak tanır. Düzeltme terminolojisi hakkında daha fazla bilgi için Değişiklikler ve düzeltmelere genel bakış başlıklı makaleyi inceleyin.
Düzeltme geçmişine erişmek için kullanıcının owner, organizer, fileOrganizer veya writer role olmalıdır.
Yanıt içinde döndürülecek alanları belirtmek için revisions kaynağının herhangi bir yöntemiyle fields
sistem parametresini
ayarlayabilirsiniz. Parametreyi atlarsanız sunucu, varsayılan bir alan grubu döndürür. Örneğin, revisions.list yöntemi yalnızca id, mimeType, kind ve modifiedTime alanlarını döndürür. Farklı alanlar döndürmek için Belirli alanları döndürme başlıklı makaleye bakın.
Otomatik silme işleminden hariç tutulacak düzeltmeleri belirtme
Google Drive, kullanıcının artık ilgilenmediği eski düzeltmeleri otomatik olarak siler.
Blob dosya revizyonu, "Sonsuza Kadar Sakla" olarak ayarlanabilir. Bu durumda revizyon otomatik olarak temizlenemez. En fazla 200 revizyon "Süresiz Sakla" olarak ayarlanabilir ve depolama alanı sınırınıza dahil edilir. Ana düzeltme hiçbir zaman otomatik olarak temizlenmez.
Baş düzeltme dışında, "Daima sakla" olarak belirlenmemiş tüm blob dosyası düzeltmeleri temizlenebilir. Silinebilir düzeltmeler genellikle 30 gün boyunca saklanır ancak bir dosyada "Sonsuza Kadar Sakla" olarak belirlenmemiş 100 düzeltme varsa ve yeni bir düzeltme yüklenirse daha önce silinebilir.
Drive'ın temizlemesini istemediğiniz düzeltmeleri işaretlemek için revisions kaynağının boolean keepForever alanını true olarak ayarlayabilirsiniz. Bir blob dosyası düzeltmesi "Sonsuza Kadar Sakla" olarak ayarlandıktan sonra yalnızca indirilebilir veya silinebilir. Daha fazla bilgi için Revizyon indirme veya Revizyon silme başlıklı makaleleri inceleyin.
Eski Drive API v2'yi kullanıyorsanız keepForever yerine revisions kaynağının pinned alanını kullanın.
Dosya düzeltmesi alma
Dosya düzeltmesinin meta verilerini veya içeriğini almak için fileId ve revisionId yol parametreleriyle revisions kaynağında get yöntemini kullanın. Düzeltme kimliğini bilmiyorsanız list yöntemini kullanarak bir dosyadaki tüm düzeltmeleri listeleyebilirsiniz.
Yöntem, düzeltmenin meta verilerini revisions kaynağının bir örneği olarak döndürür.
Bilinen kötü amaçlı yazılımları veya diğer kötüye kullanım amaçlı dosyaları indirmenin riskini kabul etmek için acknowledgeAbuse sorgu parametresini true olarak ayarlayın. Bu alan yalnızca alt=media parametresi ayarlandığında ve kullanıcının dosya sahibi ya da dosyanın bulunduğu ortak Drive'ın düzenleyicisi olması durumunda geçerlidir.
Bir dosyanın düzeltmelerini listeleme
Bir dosyanın düzeltmelerini listelemek için list yöntemini revisions kaynağında fileId yol parametresiyle birlikte kullanın. Yöntem, dosya düzeltmelerinin listesini döndürür.
Sayfalandırmayı özelleştirmek veya düzeltmeleri filtrelemek için aşağıdaki sorgu parametrelerini iletin:
pageSize: Sayfa başına döndürülecek maksimum düzeltme sayısı.pageToken: Önceki bir liste çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın.
Dosya düzeltmesini güncelleme
Bir dosyadaki düzeltmeyi güncellemek için fileId ve revisionId yol parametreleriyle revisions kaynağında update yöntemini kullanın.
Yöntem, revisions kaynağının bir örneğini döndürür.
Düzeltme indirme
Yalnızca "Daima sakla" olarak işaretlenen blob dosyası içeriği düzeltmelerini indirebilirsiniz. Bir revizyonu indirmek istiyorsanız önce "Daima sakla" olarak ayarladığınızdan emin olun. Daha fazla bilgi için Otomatik silme işleminden kurtarmak üzere kaydedilecek düzeltmeleri belirtme başlıklı makaleyi inceleyin.
Bir blob dosyası içerik revizyonunu indirmek veya bir Google Workspace dokümanı içerik revizyonunu dışa aktarmak için Dosyaları indirme ve dışa aktarma başlıklı makaleye bakın.
Dosya düzeltmesini silme
Bir dosya revizyonunu kalıcı olarak silmek için fileId ve revisionId yolu parametreleriyle revisions kaynağında delete yöntemini kullanın.
Yalnızca Drive'da ikili program içeriği bulunan blob dosyalarının (ör. resimler, videolar ve PDF'ler) revizyonlarını silebilirsiniz. "Daima sakla" olarak işaretlenen bir blob dosyası düzeltmesini silebilirsiniz. Diğer dosyaların (ör. Google Dokümanları veya E-Tablolar) düzeltmeleri ve ikili dosyanın son kalan düzeltmesi silinemez.
Düzeltme yayınlama
Google Dokümanlar, Google E-Tablolar ve Google Slaytlar revizyonunu yayınlamak için revisions kaynağında ilgili dosyanın published özelliğini ayarlayın. Bu özellik, Drive API kullanılarak Google Sites revizyonları için ayarlanamaz.
Yayınlanan düzeltmeler, publishAuto özelliği ayarlanmadığı sürece bir dosyada yapılan değişiklikleri yansıtmaz. Mülk true olarak ayarlanmışsa dosyanın daha yeni revizyonları otomatik olarak yayınlanır ve önceki revizyonların üzerine yazılır.
Slaytlar ve Çizimler yalnızca otomatik yeniden yayınlamayı destekler ve publishAuto özelliğinin true olarak ayarlanmasını gerektirir. Sites dosyaları için publishAuto her zaman false olur.
Dosya bir Google Workspace alanında oluşturulmuşsa publishedOutsideDomain özelliği, düzeltmeye herkesin erişip erişemeyeceğini veya düzeltmenin alan kullanıcılarıyla kısıtlanıp kısıtlanmadığını gösterir. Siteler dosyaları için bu özellik, type=anyone izninin olup olmadığını gösterir. Daha fazla bilgi için permissions kaynağındaki type alanına bakın.
Otomatik yayınlama, Dokümanlar ve E-Tablolar'ın kullanıcı arayüzündeki "Değişiklik yapıldığında otomatik olarak yeniden yayınla" onay kutusuyla da kontrol edilir. Daha fazla bilgi için Google Dokümanlar, E-Tablolar, Slaytlar ve Formlar dosyalarını herkese açık hale getirme başlıklı makaleyi inceleyin.