Belirli bir grup ortak Drive'ı aramak için sorgu dizesi q alanını kullanın. Bir veya daha fazla arama terimini birleştirerek döndürülecek sürücüleri filtrelemek için drives.list kullanın.
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.
Paylaşılan sürücüleri filtrelemek için kullanabileceğiniz sorgu terimlerini ve operatörleri görmek istiyorsanız Arama sorgusu 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 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'.
| Sorgulamak istediğiniz öğe | Ö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 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 |
| 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 |
| Düzenleyeni atanmamış ortak drive'lar | organizerCount = 0 |
true |
| Kuruluş birimi kimliğini içermeyen ortak Drive'lar | orgUnitId != 'C03az79cb' |
true |
Parantez kullanarak birden fazla terimi sorgulama
Birden çok 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 veya 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)