Bu kılavuzda, Google Drive API'yi kullanarak ortak Drive oluşturma, üyeleri ve izinleri yönetme gibi ortak Drive'ları yönetmeyle ilgili görevler yer almaktadır.
Yanıtla döndürülecek alanları belirtmek istiyorsanız drives
kaynağının herhangi bir yöntemiyle fields
system
parametresini
ayarlayabilirsiniz. fields
parametresini belirtmezseniz sunucu, yönteme özel varsayılan bir alan grubu döndürür. Örneğin, list
yöntemi her ortak Drive için yalnızca kind
, id
ve name
alanlarını döndürür. Daha fazla bilgi için Belirli alanları döndürme başlıklı makaleye bakın.
Ortak Drive klasör sınırları hakkında daha fazla bilgi edinmek için Ortak Drive klasör sınırları başlıklı makaleyi inceleyin.
Ortak Drive oluşturma
Ortak Drive oluşturmak için create
yöntemini drives
kaynağında requestId
parametresiyle birlikte kullanın.
requestId
parametresi, ortak Drive'ın idempotent oluşturulması için mantıksal girişimi tanımlar. İstek zaman aşımına uğrarsa veya belirsiz bir arka uç hatası döndürürse aynı istek tekrar gönderilebilir ve bu durumda kopya oluşturulmaz. İsteğin requestId
ve gövdesi aynı kalmalıdır.
Aşağıdaki kod örneğinde, ortak drive'ın nasıl oluşturulacağı gösterilmektedir:
Java
Python
Node.js
PHP
.NET
create
yöntemine yapılan çağrılar idempotent'tır.
Ortak Drive, önceki bir istekte veya yeniden deneme nedeniyle başarıyla oluşturulduysa yöntem, drives
kaynağının bir örneğini döndürür. Bazen, uzun bir süre sonra veya isteğin gövdesi değiştiyse 409
hata döndürülerek requestId
öğesinin atılması gerektiği belirtilebilir.
Ortak Drive edinme
Bir ortak Drive'ın meta verilerini almak için driveId
yol parametresiyle birlikte drives
kaynağında get
yöntemini kullanın. Drive kimliğini bilmiyorsanız list
yöntemini kullanarak tüm ortak Drive'ları listeleyebilirsiniz.
get
yöntemi, ortak drive'ı drives
kaynağının bir örneği olarak döndürür.
İsteği alan yöneticisi olarak yayınlamak için useDomainAdminAccess
sorgu parametresini true
olarak ayarlayın. Daha fazla bilgi için Ortak Drive'ları alan yöneticisi olarak yönetme başlıklı makaleyi inceleyin.
Ortak Drive'ları listeleme
Bir kullanıcının paylaşılan sürücülerini listelemek için drives
kaynağında list
yöntemini kullanın. Bu yöntem, ortak drive'ların listesini döndürür.
Ortak drive'ların sayfalara ayrılmasını özelleştirmek veya ortak drive'ları filtrelemek için aşağıdaki sorgu parametrelerini iletin:
pageSize
: Sayfa başına döndürülecek maksimum ortak sürücü sayısı.pageToken
: Önceki bir liste çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın.q
: Ortak drive'larda arama yapmak için kullanılan sorgu dizesi. Daha fazla bilgi için Ortak Drive'ları arama başlıklı makaleyi inceleyin.useDomainAdminAccess
: İsteği, alan yöneticisi olarak yayınlamak ve isteyenin yönetici olduğu alandaki tüm ortak sürücüleri döndürmek içintrue
olarak ayarlayın. Daha fazla bilgi için Ortak Drive'ları alan yöneticisi olarak yönetme başlıklı makaleyi inceleyin.
Ortak Drive'ı güncelleme
Bir ortak Drive'ın meta verilerini güncellemek için driveId
yol parametresiyle birlikte update
yöntemini drives
kaynağında kullanın.
Bu yöntem, ortak drive'ı drives
kaynağının bir örneği olarak döndürür.
İsteği alan yöneticisi olarak yayınlamak için useDomainAdminAccess
sorgu parametresini true
olarak ayarlayın. Daha fazla bilgi için Ortak Drive'ları alan yöneticisi olarak yönetme başlıklı makaleyi inceleyin.
Ortak Drive'ı gizleme ve gösterme
Bir ortak drive'ı varsayılan görünümden gizlemek için driveId
parametresiyle drives
kaynağında hide
yöntemini kullanın.
Bir ortak drive gizlendiğinde Drive, ortak drive kaynağını hidden=true
olarak işaretler. Gizli ortak drive'lar, Drive kullanıcı arayüzünde veya döndürülen dosyaların listesinde görünmez.
Bir ortak Drive'ı varsayılan görünüme geri yüklemek için driveId
parametresini içeren drives
kaynağında unhide
yöntemini kullanın.
Her iki yöntem de ortak drive'ı drives
kaynağının bir örneği olarak döndürür.
Ortak Drive'ı silme
Bir ortak Drive'ı kalıcı olarak silmek için driveId
parametresiyle birlikte drives
kaynağında delete
yöntemini kullanın.
Ortak Drive'ı silmeden önce içindeki tüm içeriklerin çöp kutusuna taşınması veya silinmesi gerekir. Kullanıcının, paylaşılan Drive klasöründe role=organizer
izni de olmalıdır. Daha fazla bilgi için Dosyaları ve klasörleri çöp kutusuna taşıma veya silme başlıklı makaleyi inceleyin.
Ortak drive'ları filtrelemek için aşağıdaki sorgu parametrelerini iletin:
useDomainAdminAccess
: İsteği, alan yöneticisi olarak yayınlamak ve isteyenin yönetici olduğu alandaki tüm ortak sürücüleri döndürmek içintrue
olarak ayarlayın. Daha fazla bilgi için Ortak Drive'ları alan yöneticisi olarak yönetme başlıklı makaleyi inceleyin.allowItemDeletion
: Ortak Drive'daki öğeleri silmek içintrue
olarak ayarlayın. YalnızcauseDomainAdminAccess
datrue
olarak ayarlandığında desteklenir.
Ortak Drive üyelerini ekleme veya kaldırma
permissions
kaynağını kullanarak ortak Drive üyelerini ekleyin veya kaldırın.
Üye eklemek için ortak Drive'da izin oluşturun. Üyelere ek ayrıcalıklar vermek veya üye olmayan kullanıcıların belirli öğeler üzerinde ortak çalışmasına izin vermek için ortak Drive'daki tek tek dosyalarda da izin yöntemleri kullanılabilir.
Daha fazla bilgi ve örnek kod için Dosya, klasör ve sürücü paylaşma başlıklı makaleyi inceleyin.
Ortak Drive'ları alan yöneticisi olarak yönetme
Bir kuruluş genelinde ortak Drive'ları yönetmek için drives
ve permissions
kaynaklarıyla birlikte useDomainAdminAccess
parametresini uygulayın.
Bu yöntemleri useDomainAdminAccess=true
ile çağıran kullanıcıların Drive and Docs
yönetici ayrıcalığına sahip olması gerekir.
Yöneticiler, herhangi bir ortak Drive'daki üyeliklerinden bağımsız olarak ortak Drive'ları arayabilir veya kuruluşlarına ait ortak Drive'ların izinlerini güncelleyebilir.
Hizmet hesaplarını kullanırken hizmet hesabı kimliğine bürünme özelliğini kullanarak kimliği doğrulanmış bir yöneticinin kimliğine bürünmeniz gerekebilir. Kullanıcı hesaplarının aksine, hizmet hesaplarının Google Workspace alanınıza ait olmadığını unutmayın. Google Workspace dokümanları veya etkinlikleri gibi Google Workspace varlıklarını Google Workspace alanınızın tamamıyla paylaşırsanız bu varlıklar hizmet hesaplarıyla paylaşılmaz. Daha fazla bilgi için Hizmet hesaplarına genel bakış başlıklı makaleyi inceleyin.
Düzenleyeni olmayan bir ortak Drive'ı kurtarma
Aşağıdaki kod örneğinde, artık düzenleyeni olmayan ortak sürücülerin nasıl kurtarılacağı gösterilmektedir.
Java
Python
Node.js
PHP
.NET
Kullanıcıların dosyanızı indirmesini, yazdırmasını veya kopyalamasını engelleme
Kullanıcıların ortak Drive'lardaki dosyaları indirme, yazdırma ve kopyalama şeklini sınırlayabilirsiniz.
Kullanıcının, ortak Drive'da düzenleyici tarafından uygulanan indirme kısıtlamalarını değiştirip değiştiremeyeceğini belirlemek için capabilities.canChangeDownloadRestriction
boolean alanını kontrol edin. capabilities.canChangeDownloadRestriction
, true
olarak ayarlanırsa ortak drive'a indirme kısıtlamaları uygulanabilir. Daha fazla bilgi için Dosya özelliklerini anlama başlıklı makaleyi inceleyin.
drives
kaynağı, bir işlemin ortak Drive'da gerçekleştirilip gerçekleştirilemeyeceğini belirtmek için kullanılan bir grup Boole restrictions
alanı içerir.
Kısıtlamalar, ortak drive'lar veya ortak drive'lardaki öğeler için geçerlidir.
Kısıtlamalar, drives.update
yöntemi kullanılarak ayarlanabilir.
Bir ortak drive'a indirme kısıtlamaları uygulamak için ortak drive yöneticisi, drives
kaynağının restrictions.downloadRestriction
alanını drives
DownloadRestriction
nesnesini kullanarak ayarlayabilir.
restrictedForReaders
boole alanını true
olarak ayarlamak, hem indirme hem de kopyalama işlemlerinin okuyucular için kısıtlandığını belirtir. restrictedForWriters
boolean alanını true
olarak ayarlamak, yazarlar için hem indirme hem de kopyalama işlemlerinin kısıtlandığını belirtir. restrictedForWriters
alanı true
ise okuyucular için indirme ve kopyalama işlemlerinin de kısıtlandığını unutmayın. Benzer şekilde, restrictedForWriters
değerini true
, restrictedForReaders
değerini ise false
olarak ayarlamak, hem restrictedForWriters
hem de restrictedForReaders
değerini true
olarak ayarlamaya eşdeğerdir.
Geriye dönük uyumluluk
DownloadRestriction
nesnesinin kullanıma sunulmasıyla birlikte, restrictions.copyRequiresWriterPermission
boolean alanının işlevselliği güncellendi.
Şimdi, restrictions.copyRequiresWriterPermission
ayarını true
olarak ayarlamak, okuyucuların hem indirme hem de kopyalama işlemlerinin kısıtlandığını belirtmek için DownloadRestriction
nesnesinin restrictedForReaders
boole alanını true
olarak günceller.
copyRequiresWriterPermission
alanını false
olarak ayarlamak hem restrictedForWriters
hem de restrictedForReaders
alanlarını false
olarak günceller. Bu, tüm kullanıcılar için indirme veya kopyalama kısıtlama ayarlarının kaldırıldığı anlamına gelir.
İndirme, yazdırma ve kopyalama özelliklerini kontrol eden alanlar
Aşağıdaki tabloda, indirme, yazdırma ve kopyalama işlevlerini etkileyen drives
kaynak alanları listelenmiştir:
Alan | Açıklama | Sürüm |
---|---|---|
capabilities.canCopy |
Geçerli kullanıcının ortak Drive'daki dosyaları kopyalayıp kopyalayamayacağı. | v2 ve v3 |
capabilities.canDownload |
Mevcut kullanıcının ortak Drive'daki dosyaları indirip indiremeyeceği. | v2 ve v3 |
capabilities.canChangeCopyRequiresWriterPermission |
Mevcut kullanıcının ortak Drive'ın copyRequiresWriterPermission kısıtlamasını değiştirip değiştiremeyeceği. |
v2 ve v3 |
capabilities.canResetDriveRestrictions |
Mevcut kullanıcının ortak drive kısıtlamalarını varsayılan ayarlara sıfırlayıp sıfırlayamayacağı. | v2 ve v3 |
capabilities.canChangeDownloadRestriction |
Mevcut kullanıcının, ortak drive'ın indirme kısıtlamasını değiştirip değiştiremeyeceği. | Yalnızca v3 |
restrictions.copyRequiresWriterPermission |
Okuyucular ve yorumcular için ortak Drive'daki dosyaları kopyalama, yazdırma veya indirme seçeneklerinin devre dışı bırakılıp bırakılmadığı true olduğunda, bu ortak drive'daki tüm dosyalar için benzer ada sahip alan true olarak ayarlanır. |
v2 ve v3 |
restrictions.downloadRestriction |
Ortak Drive yöneticileri tarafından uygulanan indirme kısıtlamaları. | Yalnızca v3 |
Klasör sınırlamaları
Ortak Drive klasörlerinde bazı depolama alanı sınırları vardır. Daha fazla bilgi için Google Drive'da ortak Drive sınırları başlıklı makaleyi inceleyin.
Öğe kapasitesi
Her kullanıcının ortak Drive'ı; dosyalar, klasörler ve kısayollar dahil olmak üzere 500.000 öğeyle sınırlıdır.
Sınıra ulaşıldığında ortak Drive artık öğe kabul edemez. Dosya almaya devam etmek için kullanıcıların öğeleri ortak Drive'dan kalıcı olarak silmesi gerekir. Çöp kutusundaki öğelerin sınıra dahil edildiğini, ancak kalıcı olarak silinen öğelerin dahil edilmediğini unutmayın. Daha fazla bilgi için Dosyaları ve klasörleri çöp kutusuna taşıma veya silme başlıklı makaleyi inceleyin.
Klasör derinliği sınırı
Ortak Drive'daki bir klasörde 100'den fazla iç içe yerleştirilmiş klasör olamaz. Bu nedenle, bir alt klasör 99 düzeyden daha derin bir klasörün altına depolanamaz. Bu sınırlama yalnızca alt klasörler için geçerlidir.
100'den fazla klasör düzeyi ekleme girişimleri teamDriveHierarchyTooDeep
HTTP durum kodu yanıtı döndürür.