Ortak Drive desteğini uygulama

Ortak Drive'lar, Drive'ım'dan farklı kuruluş, paylaşım ve sahiplik modellerini kullanır. Uygulamanız ortak Drive'larda dosya oluşturup yönetecekse uygulamanızda ortak Drive desteğini uygulamanız gerekir. Uygulamanızın işlevine bağlı olarak uygulamanızın karmaşıklığı değişir.

Başlamak için uygulamanız aşağıdaki işlemleri gerçekleştirirken isteklerinize supportsAllDrives=true sorgu parametresini eklemeniz gerekir:

Drive API 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 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şlemek üzere tasarlandığını bildirir.

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

Ortak Drive'daki içerikleri arama

Ortak Drive'lardaki kullanıcı dosyalarını bulmak için files kaynağında list yöntemini kullanın. Ortak Drive'ı arama hakkında bilgi edinmek için Ortak Drive'ları arama başlıklı makaleyi inceleyin.

list yöntemi, ortak drive'a özgü şu sorgu parametrelerini içerir:

  • driveId: Aranacak ortak Drive'ın kimliği.

  • corpora: Sorgunun uygulandığı öğelerin (dosyalar veya dokümanlar) gövdeleri. Desteklenen gövdeler user, domain, drive ve allDrives'dir. Verimlilik için allDrives yerine user veya drive tercih edin. Varsayılan olarak, korpuslar user olarak ayarlanır.

  • includeItemsFromAllDrives: Hem Drive'ım hem de ortak drive öğelerinin sonuçlara dahil edilip edilmeyeceğini belirtir. Bu özellik yoksa veya yanlış olarak ayarlanmışsa ortak Drive öğeleri döndürülmez.

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

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

includeItemsFromAllDrives corpora Sorgu açıklaması
true user Kullanıcının eriştiği dosyaları (hem ortak Drive hem de Drive'ım dosyaları dahil) sorgular.
true domain Ortak Drive ve Drive'ım dosyaları da dahil olmak üzere alanla paylaşılan dosyaları sorgular.
true drive Belirtilen ortak drive'daki tüm öğeleri sorgular. İstek içinde driveId 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ı derlemlerin aranmadığını belirten incompleteSearch:true karakterini içerebileceğini unutmayın.

Bir ortak drive'daki değişiklikleri izleme

Ortak Drive'daki değişiklikleri izlemek için changes kaynağında list yöntemini kullanın. Daha fazla bilgi için Kullanıcılar ve paylaşılan sürücüler için değişiklikleri izleme başlıklı makaleyi inceleyin.

list yöntemi, ortak drive'a özgü şu sorgu parametrelerini içerir:

  • driveId: Değişikliklerin döndürüldüğü ortak drive. Belirtilmişse, değişiklik kimlikleri, bir dosyanın mevcut durumunu sağlayan ortak drive'daki öğelerde yapılan değişiklikleri ifade eder. Belirli bir ortak Drive değişikliğine başvurmak için hem ortak Drive kimliği hem de değişiklik kimliği tanımlayıcı olarak kullanılmalıdır.

  • includeItemsFromAllDrives: Ortak Drive dosyalarının veya değişikliklerin değişiklik listesine dahil edilip edilmeyeceği.

  • supportsAllDrives: İsteği gönderen uygulamanın ortak drive'ları destekleyip desteklemediği. Yanlışsa hem ortak drive'lar hem de ortak drive'daki dosyalar dahil olmak üzere ortak drive öğeleri döndürülmez.

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şikliklerin yanı sıra 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'daki öğelerde yapılan değişiklikleri yansıtır.

Değişiklik günlüğü davranışı hakkında daha fazla bilgi için Kullanıcılar ve ortak Drive'lar için değişiklikleri izleme başlıklı makaleyi inceleyin.

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

Drive kullanıcı arayüzünü kullanarak ortak sürücü içeriğine erişmek için Google Cloud Console'daki Google Drive API'nin Drive kullanıcı arayüzü entegrasyonu sekmesinde Ortak sürücü desteği kutusunu işaretlediğinizden emin olun. Daha fazla bilgi için Drive kullanıcı arayüzü entegrasyonu yapılandırma başlıklı makaleyi inceleyin.

Google Seçici'yi ortak drive'larla kullanma

Google Seçici, ortak drive'lardaki öğelerin seçilmesini destekler. Ortak Drive desteğini etkinleştirme ve seçiciye ortak Drive görünümleri ekleme hakkında ayrıntılı bilgi için Google Picker API başlıklı makaleyi inceleyin.