Bu başvuru kılavuzunda; dosyaları, klasörleri ve ortak drive'ları filtrelemek için Google Drive API'siyle kullanabileceğiniz sorgu terimleri ve operatörler açıklanmaktadır.
Dosya arama örnekleri için Dosya ve klasör arama başlıklı makaleye bakın.
Ortak drive aramalarıyla ilgili örnek olarak Ortak drive'ları arama başlıklı makaleye göz atın.
Sorgu dizesi söz dizimi
Bir sorgu dizesi aşağıdaki üç bölümü içerir:
query_term operator values
Burada:
query_term
, aranacak 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 listelenmektedir:
Operatör | Kullanım |
---|---|
contains |
Bir dizenin içeriği diğerinde de bulunur. |
= |
Bir dizenin veya boole'nin içeriği diğerine eşittir. |
!= |
Bir dizenin veya boole'nin içeriği diğerine eşit değil. |
< |
Değer, başka bir değerden küçük. |
<= |
Değer başka bir değerden küçük veya ona eşit. |
> |
Bir değer başka bir değerden büyük. |
>= |
Değer başka bir değerden büyük veya ona eşit. |
in |
Koleksiyon içinde bir öğe bulunur. |
and |
Her iki sorguyla da eşleşen öğeleri döndür. |
or |
Herhangi bir sorguyla eşleşen öğeleri döndürü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 sorgusu terimleri listelenmektedir. 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. \' içeren sorgularda (ör. 'Valentine\'s Day' ) tek tırnak için çıkış yapın. |
fullText |
contains |
name , description , indexableText özelliklerinin veya dosyanın içeriğindeki ya da meta verilerindeki metnin eşleşip eşleşmediği. Tek tırnak işareti (' ) içine alın. \' içeren sorgularda (ör. 'Valentine\'s Day' ) tek tırnak için çıkış yapın. |
mimeType |
contains , = != |
Dosyanın MIME türü. Tek tırnak işareti (' ) içine alın. \' içeren sorgularda (ör. 'Valentine\'s Day' ) tek tırnak için çıkış yapın. MIME türleri hakkında daha fazla bilgi edinmek için Google Workspace ve Google Drive tarafından desteklenen MIME türleri başlıklı makaleye göz atın. |
modifiedTime |
<= , < , = , != , > , >= |
Dosyada yapılan son değişiklik tarihi. RFC 3339 biçimindedir, varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). date türündeki alanlar birbiriyle karşılaştırılamaz, yalnızca sabit tarihlerle karşılaştırılabilir. |
viewedByMeTime |
<= , < , = , != , > , >= |
Kullanıcının bir dosyayı son görüntülediği tarih. RFC 3339 biçimindedir, varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). date türündeki 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 koleksiyonun 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ını inceleyin. |
readers |
in |
Dosyayı okuma izni olan kullanıcılar veya gruplar. permissions kaynak referansını inceleyin. |
sharedWithMe |
= , != |
Kullanıcının "Benimle paylaşılanlar" koleksiyonundaki dosyalar. Dosyanın tüm 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 |
Gizli özel dosya özellikleri'ni tıklayın. |
visibility |
= , != |
Dosyanın görünürlük düzeyi. Geçerli değerler anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink ve limited değerleridir. Metni tek tırnak 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 gerçekleştirir. Örneğin, adınızınHelloWorld
olduğunu varsayalım.name contains 'Hello'
sorgusu bir sonuç döndürür, ancakname contains 'World'
sorgusu sonuç döndürür.contains
operatörü yalnızcafullText
terimi için tüm dize jetonlarında eşleşme gerçekleştirir. Örneğin, bir dokümanın tam metni "HelloWorld" dizesini içeriyorsa yalnızcafullText contains 'HelloWorld'
sorgusu bir sonuç döndürür.contains
operatörü, çift tırnak içine alınmışsa tam alfanümerik ifadeyle eşleşir. Örneğin, bir dokümanınfullText
kısmı "Merhaba dünya" dizesini içeriyorsafullText contains '"Hello there"'
sorgusu bir sonuç döndürür, ancakfullText contains '"Hello world"'
sorgusu döndürmez. 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 dolaylı olarakpermissions
listesine yansıtılır ve izinderole
a referansta bulunur. Rol izinlerinin tam listesi için Roller ve izinler bölümüne bakın.
Sorgu dizesi aramalarına ilişkin 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 listelenmektedir. 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çimindedir, varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00 ). |
true |
hidden |
= , != |
Ortak Drive'ın gizlenmiş olup olmadığını belirtir. true veya false olabilir. |
false |
memberCount |
<= , < , = , != , > , >= |
Ortak drive'ın üyesi olan kullanıcı ve grup 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. \' içeren sorgularda (ör. 'Valentine\'s Day' ) tek tırnak için çıkış yapın. |
true |
organizerCount |
<= , < , = , != , > , >= |
Ortak Drive'ı düzenleyen kullanıcı ve grup 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ına ilişkin 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'ları arama
- Google Workspace ve Google Drive tarafından desteklenen MIME türleri
- Roller ve izinler