Bu başvuru kılavuzunda, Google Drive API ile dosya, klasör ve ortak Drive'ları filtrelemek için kullanabileceğiniz sorgu terimleri ve operatörler yer almaktadır.
Dosya arama örnekleri için Dosya ve klasör arama bölümüne bakın.
Ortak Drive'larla ilgili aramalar için Ortak Drive'ları arama başlıklı makaleyi inceleyin.
Sorgu dizesi söz dizimi
Bir sorgu dizesi aşağıdaki üç bölümden oluşur:
query_term operator values
Burada:
query_term
, arama için kullanılacak sorgu terimi veya alanıdır.operator
, sorgu teriminin koşulunu belirtir.values
, arama sonuçlarınızı filtrelemek için kullanmak istediğiniz belirli değerlerdir.
Sorgu operatörleri
Aşağıdaki tabloda geçerli sorgu operatörleri listelenmiştir:
Operatör | Kullanım |
---|---|
contains |
Bir dizenin içeriği diğerinde de var. |
= |
Bir dizenin veya boolenin içeriği diğerine eşittir. |
!= |
Bir dizenin veya boolenin içeriği diğeriyle eşit değil. |
< |
Bir değer başka bir değerden küçük. |
<= |
Bir değer başka bir değerden küçük veya ona eşit. |
> |
Bir değer başka bir değerden büyük. |
>= |
Bir değer başka bir değerden büyük veya ona eşit. |
in |
Bir öğe, koleksiyonda yer alıyor. |
and |
Her iki sorguyla da eşleşen öğeleri döndürür. |
or |
İki sorgudan biriyle eşleşen öğeleri döndür. |
not |
Bir arama sorgusunu olumsuzlar. |
has |
Bir koleksiyon, parametrelerle eşleşen bir öğe içerir. |
Dosyaya özgü sorgu terimleri
Aşağıdaki tabloda tüm geçerli dosya sorgu terimleri listelenmiştir. Veri türleri ve açıklamalar için files
kaynak referansına bakın.
Sorgu terimi | Geçerli operatörler | Kullanım |
---|---|---|
name |
contains , = != |
Dosyanın adı. Tek tırnak işareti (' ) içine alın. \' gibi sorgularda tek tırnak işareti kullanmayın (ör. 'Valentine\'s Day' ). |
fullText |
contains |
Dosyanın içeriğindeki veya meta verilerindeki name , description , indexableText özelliklerinin ya da metnin eşleşip eşleşmediği. Tek tırnak işareti (' ) içine alın. \' gibi sorgularda tek tırnak işareti kullanmayın (ör. 'Valentine\'s Day' ). |
mimeType |
contains , = != |
Dosyanın MIME türü. Tek tırnak işareti (' ) içine alın. \' gibi sorgularda tek tırnak işareti kullanmayın (ör. 'Valentine\'s Day' ). MIME türleri hakkında daha fazla bilgi için Google Workspace ve Google Drive tarafından desteklenen MIME türleri başlıklı makaleye bakın. |
modifiedTime |
<= , < , = , != , > , >= |
Dosyada yapılan son değişikliğin tarihi. RFC 3339 biçimi; varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). date türü alanlar birbiriyle karşılaştırılamaz, yalnızca sabit tarihlerle karşılaştırılabilir. |
viewedByMeTime |
<= , < , = , != , > , >= |
Kullanıcının bir dosyayı en son görüntülediği tarih. RFC 3339 biçimi; varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). date türü alanlar birbiriyle karşılaştırılamaz, yalnızca sabit tarihlerle karşılaştırılabilir. |
trashed |
= , != |
Dosyanın çöp kutusunda olup olmadığı. true veya false olabilir. |
starred |
= , != |
Dosyanın yıldızlı olup olmadığı. true veya false olabilir. |
parents |
in |
Üst öğe koleksiyonunun belirtilen kimliği içerip içermediği. |
owners |
in |
Dosyanın sahibi olan kullanıcılar. |
writers |
in |
Dosyayı değiştirme izni olan kullanıcılar veya gruplar. permissions kaynak referansına bakın. |
readers |
in |
Dosyayı okuma izni olan kullanıcılar veya gruplar. permissions kaynak referansına bakın. |
sharedWithMe |
= , != |
Kullanıcının "Benimle paylaşılanlar" koleksiyonundaki dosyalar. Tüm dosya kullanıcıları dosyanın Erişim Kontrol Listesi'nde (EKL) yer alır. true veya false olabilir. |
createdTime |
<= , < , = , != , > , >= |
Ortak Drive'ın oluşturulduğu tarih. RFC 3339 biçimini kullanın. Varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). |
properties |
has |
Herkese açık özel dosya özellikleri. |
appProperties |
has |
Özel özel dosya özellikleri. |
visibility |
= , != |
Dosyanın görünürlük düzeyi. Geçerli değerler anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink ve limited değerleridir. Tek tırnak işareti içine alın (' ). |
shortcutDetails.targetId |
= , != |
Kısayolun işaret ettiği öğenin kimliği. |
Aşağıda operatör ve sorgu terimi kombinasyonları gösterilmektedir:
contains
operatörü yalnızcaname
terimi için ön ek eşleştirme yapar. Örneğin, adınızınHelloWorld
olduğunu varsayalım.name contains 'Hello'
sorgusu bir sonuç döndürür ancakname contains 'World'
sorgusu bir sonuç döndürür.contains
operatörü, yalnızcafullText
terimi için tüm dize jetonları için eşleştirme yapar. Örneğin, bir dokümanın tam metni "HelloWorld" dizesini içeriyorsa yalnızcafullText contains 'HelloWorld'
sorgusu sonuç döndürür.contains
operatörü, çift tırnak işareti içine alınmışsa tam bir alfanümerik kelime öbeğiyle eşleşir. Örneğin, bir dokümanınfullText
öğesi "Merhaba dünya" dizesini içeriyorsafullText contains '"Hello there"'
sorgusu bir sonuç döndürür, ancakfullText contains '"Hello world"'
sorgusu bir sonuç döndürür. Ayrıca, arama alfanümerik olduğundan, bir dokümanın tam metni "Hello_world" dizesini içeriyorsafullText contains '"Hello world"'
sorgusu bir sonuç döndürür.owners
,writers
vereaders
terimleri,permissions
listesinde dolaylı olarak gösterilmiştir ve izindekirole
bölümüne referans verir. Rol izinlerinin tam listesi için Roller ve izinler bölümüne bakın.
Sorgu dizesi aramalarıyla ilgili daha fazla örnek için dosya sorgu dizesi örnekleri bölümüne bakın.
Ortak Drive'a özel sorgu terimleri
Aşağıdaki tabloda, geçerli tüm ortak Drive sorgu terimleri yer almaktadır. Veri türleri ve açıklamalar için drives
kaynak referansına bakın.
Sorgu terimi | Geçerli operatörler | Kullanım | useDomainAdminAccess ayar |
---|---|---|---|
createdTime |
<= , < , = , != , > , >= |
Ortak Drive'ın oluşturulduğu tarih. RFC 3339 biçimi; varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). |
true |
hidden |
= , != |
Ortak Drive'ın gizlenip gizlenmediğini belirtir. true veya false olabilir. |
false |
memberCount |
<= , < , = , != , > , >= |
Ortak drive'ın üyesi olan kullanıcıların ve grupların sayısı. Sayısal bir değer alır. | true |
name |
contains , = != |
Ortak drive'ın adı. Tek tırnak işareti (' ) içine alın. \' gibi sorgularda tek tırnak işareti kullanmayın (ör. 'Valentine\'s Day' ). |
true |
organizerCount |
<= , < , = , != , > , >= |
Ortak Drive'ı düzenleyen kullanıcı ve grupların sayısı. Sayısal bir değer alır. | true |
orgUnitId |
= , != |
Ortak drive'ın kuruluş birimi kimliği. Bir dize değeri alır. | true |
Sorgu dizesi aramalarıyla ilgili daha fazla örnek için ortak Drive sorgu dizesi örnekleri bölümüne bakın.
İlgili konular
- Dosya ve klasör arama
- Ortak Drive arama
- Google Workspace ve Google Drive tarafından desteklenen MIME türleri
- Roller ve izinler