Ortak Drive desteğini uygulama

Ortak Drive'lar, Drive'ım bölümündeki farklı kuruluş, paylaşım ve sahiplik modellerini takip eder. Uygulamanız ortak Drive'larda dosya oluşturup yönetecekse uygulamanızda ortak Drive desteğini eklemeniz gerekir. Uygulamanızın karmaşıklığı, uygulamanızın işlevselliğine bağlıdır.

Başlamak için, uygulamanız aşağıda listelenen işlemleri gerçekleştirdiğinde isteklerinize supportsAllDrives=true sorgu parametresini eklemeniz gerekir:

Drive API'si v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API'si v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

supportsAllDrives=true parametresi, Google Drive'a uygulamanızın ortak Drive'lardaki dosyaları işleyecek şekilde tasarlandığını bildirir.

İzinleri okuyan veya değiştiren, değişiklikleri izleyen ya da birden fazla şirkette arama yapması gereken uygulamalar için ek ortak Drive işlevleri gerekir. Bu belgenin geri kalanında, bu görevleri gerçekleştirmek için gereken ek değişiklikler vurgulanmaktadır.

Ortak Drive'da içerik arama

Ortak Drive'ları aramak için files.list yöntemini kullanın. Bu bölümde, files.list yöntemindeki ortak Drive'a özel alanlar ele alınmaktadır. Ortak Drive'ı aramak için Dosya ve klasör arama başlıklı makaleyi inceleyin.

files.list yöntemi, ortak Drive'a özel aşağıdaki alanları ve sorgu modlarını içerir:

  • driveId: Aranacak ortak Drive'ın kimliği.
  • includeItemsFromAllDrives: Ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceğini belirtir. Mevcut değilse veya yanlış değerine ayarlanırsa ortak Drive öğeleri döndürülmez.

  • corpora: Sorgunun geçerli olduğu öğe gövdeleri (dosyalar/dokümanlar). Desteklenen gövdeler: user, domain, drive ve allDrives. Verimlilik için allDrives olarak user veya drive tercih edin.

  • supportsAllDrives: İstekte bulunan uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği. Yanlış değerine ayarlanırsa ortak Drive öğeleri yanıta dahil edilmez.

Aşağıdaki sorgu modları ortak Drive'lara özeldir:

includeItemsFromAllDrives corpora Sorgu Açıklaması
true user Ortak Drive ve Drive'ım dosyaları da dahil olmak üzere kullanıcının eriştiği dosyaları sorgular.
true drive Belirtilen ortak Drive'daki tüm öğeleri sorgular. driveId istekte belirtilmelidir.
true allDrives Kullanıcının eriştiği dosyaları ve üyesi olduğu tüm ortak Drive'ları sorgular. Yanıtın, bu istek için bazı şirketlerin aranmadığını belirten incompleteSearch : true içerebileceğini unutmayın.
true domain Ortak Drive ve Drive'ım dosyaları da dahil olmak üzere alanla paylaşılan dosyaları sorgular.

Bir ortak drive'daki değişiklikleri izleme

Bir ortak Drive'daki değişiklikleri izlemek için changes.list yöntemini kullanın. Bu bölümde, changes.list yöntemindeki ortak Drive'a özel alanlar ele alınmaktadır. Daha fazla bilgi edinmek için Kullanıcılar ve ortak Drive'lar için değişiklikleri izleme başlıklı makaleye bakın. changes.list yöntemi, ortak Drive'a özel aşağıdaki alanları ve sorgu modlarını içerir:

  • driveId: Değişikliklerin geri döndürüldüğü ortak Drive. Belirtilmişse değişiklik kimlikleri, kullanıcıya gösterilen dosyalarda yapılan değişiklikleri değil, ortak Drive'daki değişiklikleri ifade eder. Belirli bir ortak Drive değişikliğini belirtmek için hem ortak Drive kimliği hem de değişiklik kimliği tanımlayıcı olarak kullanılmalıdır.
  • supportsAllDrives: İstekte bulunan uygulamanın ortak sürücüleri destekleyip desteklemediği. Yanlış değerine ayarlanırsa hem ortak Drive'lar hem de ortak Drive'daki dosyalar dahil olmak üzere ortak Drive öğeleri döndürülmez.
  • includeItemsFromAllDrives: Ortak Drive dosyalarının veya değişikliklerin, değişiklik listesine dahil edilip edilmeyeceğini belirtir.

Aşağıdaki sorgu modları ortak Drive'lara özeldir:

includeItemsFromAllDrives driveId Sorgu Açıklaması
true Hayır Değişiklikler, kullanıcının eriştiği ortak Drive'ların içindeki veya dışındaki dosyalarda yapılan değişiklikleri ve kullanıcının üyesi olduğu ortak Drive'larda yapılan değişiklikleri yansıtır.
true Evet Değişiklikler, belirtilen ortak Drive'da ve bu ortak Drive'da bulunan öğelerde yapılan değişiklikleri yansıtır.

Değişiklik günlüğü davranışı hakkında ek bilgi için Değişiklik Günlükleri bölümüne bakın.

Drive kullanıcı arayüzünde ortak Drive desteğini etkinleştirme

Drive kullanıcı arayüzünü kullanarak ortak Drive içeriğine erişmek için Google API Konsolu'ndaki "Ortak Drive desteği" seçeneğini işaretlediğinizden emin olun. Daha fazla bilgi edinmek için Drive kullanıcı arayüzü entegrasyonunu yapılandırma başlıklı makaleye bakın.

Dosya seçiciyi ortak Drive'larla kullanma

Dosya seçici, ortak Drive'larda öğe seçmeyi destekler. Ortak Drive'lar desteğini etkinleştirme ve dosya seçiciye ortak Drive görünümü eklemeyle ilgili ayrıntılar için Google Picker API'yi inceleyin.

Sonraki adımlar

Ortak Drive oluşturma ve ortak Drive izinlerini yönetme konusunda yardım almak için Ortak Drive'ları yönetme sayfasına gidin.