Ortak Drive'ları arama

Bu kılavuzda, Google Drive API'nin paylaşılan sürücülerde arama yapmak için çeşitli yöntemleri nasıl desteklediği açıklanmaktadır.

Belirli bir grup ortak Drive'ı aramak için q sorgu dizesi alanını kullanın. list yöntemini drives kaynağında kullanarak bir veya daha fazla arama terimini birleştirerek döndürülecek sürücüleri filtreleyin.

Bir sorgu dizesi aşağıdaki üç bölümü içerir:

query_term operator values

Burada:

  • query_term, sorgu terimi veya aranacak alandır.

  • operator, sorgu terimi için koşulu belirtir.

  • values, arama sonuçlarınızı filtrelemek için kullanmak istediğiniz belirli değerlerdir.

Örneğin, aşağıdaki sorgu dizesi, aramayı yalnızca "Google Drive API kaynakları" adlı ortak drive'ları döndürecek şekilde filtreler.

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

Tüm ortak Drive sorgu terimlerini görüntülemek için Ortak Drive'a özel sorgu terimleri başlıklı makaleyi inceleyin.

Sorgu oluşturmak için kullanabileceğiniz tüm sorgu operatörlerini görüntülemek üzere Sorgu operatörleri başlıklı makaleyi inceleyin.

Sorgu dizesi örnekleri

Aşağıdaki tabloda, paylaşılan sürücüler için bazı temel sorgu dizeleri örnekleri verilmiştir. Gerçek kod, aramanız için kullandığınız istemci kitaplığına bağlı olarak değişir.

Sorgunun doğru şekilde çalışması için dosya adlarınızdaki özel karakterleri de kod dışına almanız gerekir. Örneğin, bir dosya adında hem kesme işareti (') hem de ters eğik çizgi ("\") karakteri varsa bunları kod dışı bırakmak için ters eğik çizgi kullanın: name contains 'quinn\'s paper\\essay'.

Hangi sorgular gönderilebilir? Örnek useDomainAdminAccess ayar
Dize eşleşme operatörü (contains)
Kullanıcının üyesi olduğu tüm ortak drive'lar arasında başlığında "gizli" kelimesi geçen ortak drive'lar name contains 'confidential' false
Eşitlik ve eşitsizlik operatörleri (=, !=)
Varsayılan görünümde görünen ortak Drive'lar hidden = false false
Ortak Drive'lar varsayılan görünümde gizlenir. hidden = true false
Düzenleyeni atanmamış ortak drive'lar organizerCount = 0 true
Tam olarak bir üyesi olan ortak drive'lar memberCount = 1 true
Kuruluş birimi kimliğine ait ortak Drive'lar orgUnitId = 'C03az79cb' true
Kuruluş birimi kimliğini içermeyen ortak Drive'lar orgUnitId != 'C03az79cb' true
Adları belirli bir adla eşleşmeyen ortak drive'lar name != 'Archived Projects' true
Karşılaştırma operatörleri (>, >=, <, <=)
1 Haziran 2017'den sonra oluşturulan ortak drive'lar createdTime > '2017-06-01T12:00:00' true
1 Ocak 2023'ten önce oluşturulan ortak drive'lar createdTime < '2023-01-01T00:00:00' true
Birden fazla üyesi olan ortak Drive'lar memberCount > 1 true
5'ten az üyesi olan ortak Drive'lar memberCount < 5 true
3 veya daha az düzenleyeni olan ortak Drive'lar organizerCount <= 3 true
Mantıksal operatörler (and, or, not)
Başlığında "gizli" kelimesi geçen ve 20 veya daha fazla üyesi olan ortak drive'lar name contains 'confidential' and memberCount >= 20 true
Kuruluşun tüm ortak Drive'ları arasında başlığında "gizli" kelimesi geçen ortak Drive'lar name contains 'confidential' and orgUnitId = 'C03az79cb' true
Adında "Project" veya "Archive" geçen ortak sürücüler name contains 'Project' or name contains 'Archive' true
Adında "Taslak" kelimesi bulunmayan ortak drive'lar not name contains 'Draft' true
Hedef kuruluş birimine ait olmayan ve belirli bir tarihten sonra oluşturulan ortak Drive'lar orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Parantez kullanarak birden fazla terimi sorgulama

Birden fazla sorgu terimini gruplandırmak için parantez kullanabilirsiniz. Örneğin, belirli bir tarihten sonra oluşturulan ve beşten fazla düzenleyeni ya da 20'den fazla üyesi olan ortak drive'ları aramak için şu sorguyu kullanın:

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

Bu arama, 1 Ocak 2019'dan sonra oluşturulan ve beşten fazla düzenleyeni ya da 20'den fazla üyesi olan tüm ortak Drive'ları döndürür.

Drive API, and ve or operatörlerini soldan sağa doğru değerlendirir. Bu nedenle, parantez içermeyen aynı arama şu sonucu döndürür:

  • Yalnızca 1 Ocak 2019'dan sonra oluşturulan ve beşten fazla düzenleyeni olan ortak Drive'lar.
  • 20'den fazla üyesi olan tüm ortak Drive'lar (1 Ocak 2019'dan önce oluşturulanlar dahil).