Arama sorgusu terimleri ve operatörleri

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ızca name terimi için ön ek eşleştirme gerçekleştirir. Örneğin, adınızın HelloWorld olduğunu varsayalım. name contains 'Hello' sorgusu bir sonuç döndürür, ancak name contains 'World' sorgusu sonuç döndürür.

  • contains operatörü yalnızca fullText 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ızca fullText 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ın fullText kısmı "Merhaba dünya" dizesini içeriyorsa fullText contains '"Hello there"' sorgusu bir sonuç döndürür, ancak fullText contains '"Hello world"' sorgusu döndürmez. Ayrıca, arama alfanümerik olduğundan bir dokümanın tam metni "Hello_world" dizesini içeriyorsa fullText contains '"Hello world"' sorgusu bir sonuç döndürür.

  • owners, writers ve readers terimleri dolaylı olarak permissions listesine yansıtılır ve izinde rolea 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.