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şturacak ve yönetecekse uygulamanıza ortak Drive desteğini uygulamanız gerekir. Uygulamanızın karmaşıklığı, uygulamanızın işlevine 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 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 korpusa arama yapması gereken uygulamalar için ek ortak Drive işlevleri gerekir. Bu dokümanın 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 özgü aşağıdaki alanları ve sorgu modlarını içerir:

  • driveId: Aramaya dahil edilecek ortak Drive'ın kimliği.

  • includeItemsFromAllDrives: Ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceğini belirtir. Bu parametre mevcut değilse veya yanlış olarak ayarlandıysa ortak Drive öğeleri döndürülmez.

  • corpora: Sorgunun geçerli olduğu öğelerin (dosyalar/belgeler) gövdeleri. Desteklenen kuruluşlar user, domain, drive ve allDrives şeklindedir. Verimlilik için allDrives yerine user veya drive'ü tercih edin.

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

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

includeItemsFromAllDrives corpora Sorgu Açıklaması
true user Hem ortak Drive hem de Drive'ım dosyaları dahil olmak üzere kullanıcının eriştiği dosyaları sorgulayın.
true drive Belirtilen ortak Drive'daki tüm öğeleri sorgulayan işlevdir. driveId istekte belirtilmelidir.
true allDrives Kullanıcının eriştiği dosyaları ve üyesi olduğu tüm ortak Drive'ları sorgulayın. Yanıtta incompleteSearch : true bulunabilir. Bu, bazı dil veri kümelerinin bu istek için aranmadığını gösterir.
true domain Hem ortak Drive hem de Drive'ım dosyaları dahil, alanla paylaşılan dosyaları sorgular.

Ortak Drive'daki değişiklikleri izleme

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 için Kullanıcılar ve ortak Drive'lar için değişiklikleri izleme başlıklı makaleyi inceleyin. changes.list yöntemi, ortak Drive'a özgü aşağıdaki alanları ve sorgu modlarını içerir:

  • driveId: Değişikliklerin döndürüldüğü ortak Drive. Belirtilen değişiklik kimlikleri, kullanıcıya gösterilen dosyalardaki değişiklikleri değil, ortak Drive'daki değişiklikleri ifade eder. Belirli bir ortak Drive değişikliğini belirtmek için tanımlayıcı olarak hem ortak Drive kimliği hem de değişiklik kimliği kullanılmalıdır.
  • supportsAllDrives — İstekte bulunan uygulamanın ortak sürücüleri destekleyip desteklemediği. Yanlış ise 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'daki öğelerde yapılan değişiklikleri yansıtır.

Değişiklik günlüğü davranışı hakkında daha fazla 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ştir

Drive kullanıcı arayüzünü kullanarak ortak Drive içeriğine erişmek için Google API Konsolu'nda "Ortak Drive desteği"ni işaretlediğinizden emin olun. Daha fazla bilgi edinmek için Drive kullanıcı arayüzü entegrasyonunu yapılandırma bölümünü inceleyin.

Dosya seçiciyi ortak Drive'larla kullanma

Dosya seçici, ortak Drive'lardaki öğelerin seçilmesini destekler. Ortak Drive desteğini etkinleştirme ve dosya seçicide ortak Drive görünümü ekleme hakkında ayrıntılı bilgi için Google Picker API başlıklı makaleyi 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 bölümüne gidin.