Belirli bir ortak Drive grubunu aramak için bir veya daha fazla arama terimini birleştirerek döndürülecek Drive'ları filtrelemek üzere drives.list ile sorgu dizesi q alanını kullanın.
Sorgu dizesi aşağıdaki üç bölümü içerir:
query_term operator values
Burada:
query_term, aranacak sorgu terimi veya alandır.operator, sorgu terimi için koşulu belirtir.values, arama sonuçlarınızı filtrelemek için kullanmak istediğiniz değerlerdir.
Ortak Drive'ları filtrelemek için kullanabileceğiniz sorgu terimlerini ve operatörlerini görüntülemek istiyorsanız Arama sorgu terimleri ve operatörleri başlıklı makaleyi inceleyin.
Ö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
Sorgu dizesi örnekleri
Aşağıdaki tabloda, paylaşılan sürücüler için bazı temel sorgu dizelerinin örnekleri listelenmiştir. Gerçek kod, aramanız için kullandığınız istemci kitaplığına bağlı olarak değişir.
Sorgunun doğru çalıştığından emin olmak için dosya adlarınızdaki özel karakterleri de kod dışına almanız gerekir. Örneğin, bir dosya adı hem apostrof (') hem de ters eğik çizgi ("\") karakteri içeriyorsa bu karakterleri kod dışı bırakmak için ters eğik çizgi kullanın: name
contains 'quinn\'s paper\\essay'.
| Sorgulamak istediğiniz veri | Örnek | useDomainAdminAccess ayar |
|---|---|---|
| 1 Haziran 2017'den sonra oluşturulan ortak Drive'lar | createdTime > '2017-06-01T12:00:00' |
true |
| Varsayılan görünümde görünen ortak Drive'lar | hidden = false |
false |
| Birden fazla üyesi olan ortak Drive'lar | memberCount > 1 |
true |
| Başlığında "gizli" kelimesi bulunan 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 bulunan ortak Drive'lar | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| Kullanıcının üyesi olduğu tüm ortak Drive'lar arasında başlığında "gizli" kelimesi bulunan ortak Drive'lar | name contains 'confidential' |
false |
| Atanmış düzenleyen olmayan ortak Drive'lar | organizerCount = 0 |
true |
| Kuruluş birimi kimliği içermeyen ortak Drive'lar | orgUnitId != 'C03az79cb' |
true |
Parantez kullanarak birden fazla terimi sorgulayın
Birden fazla sorgu terimini gruplandırmak için parantez kullanabilirsiniz. Örneğin, belirli bir tarihten sonra oluşturulan ve beşten fazla düzenleyen veya 20'den fazla üye içeren 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üzenleyen veya 20'den fazla üye içeren 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, parantezsiz aynı arama şu sonucu verir:
- Yalnızca 1 Ocak 2019'dan sonra oluşturulan ve beşten fazla düzenleyenin bulunduğu ortak Drive'lar.
- 1 Ocak 2019'dan önce oluşturulanlar da dahil olmak üzere 20'den fazla üyesi olan tüm ortak Drive'lar.