Arama sorgusu terimleri ve operatörleri

Bu referans kılavuzunda, Dosya, klasör ve ortak Drive'ları filtrelemek için Google Drive API'yi kullanın.

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, aramanızı filtrelemek için kullanmak istediğiniz belirli değerlerdir sonuç.

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 kaynağına bakın bir referans noktası olarak kabul edilir.

Sorgu terimi Geçerli operatörler Kullanım
name contains, = != Dosyanın adı. Tek tırnak işareti içine alın ('). \' ile 'Valentine\'s Day' gibi sorgularda tek tırnak işareti kullanmaktan kaçının.
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 ('). \' ile 'Valentine\'s Day' gibi sorgularda tek tırnak işareti kullanmaktan kaçının.
mimeType contains, = != Dosyanın MIME türü. Tek tırnak işareti içine alın ('). \' ile 'Valentine\'s Day' gibi sorgularda tek tırnak işareti kullanmaktan kaçının. 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" bölümünde bulunan dosyalar koleksiyonu'nda kullanılabilir. 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ızca name terim. Örneğin, hesabınızda / HelloWorld. name contains 'Hello' sorgusu ancak name contains 'World' sorgusu döndürmüyor.

  • contains operatörü, aşağıdakiler için yalnızca dize jetonlarının tamamında eşleştirme yapar: fullText terimi. Örneğin, bir dokümanın tam metni "HelloWorld" dizesi, yalnızca fullText contains 'HelloWorld' sorgusu bir sonuç döndürür.

  • contains operatörü, çift tırnak içine alın. Örneğin, bir dokümanın fullText "Merhaba dünya" dizesini içeriyorsa fullText contains '"Hello there"' sorgusu bir sonuç döndürür, ancak fullText contains '"Hello world"' sorgusu bir sonuç döndürür. Ayrıca, arama alfanümerik olduğundan, bir dokümanın metni "Hello_world" dizesini ve ardından, fullText contains '"Hello world"' bir sonuç döndürür.

  • owners, writers ve readers terimleri, permissions listesini kontrol edin ve İzinde role. Rol izinlerinin tam listesi için şuraya bakın: Roller ve izinler.

Sorgu dizesi aramalarıyla ilgili daha fazla örnek için dosya sorgu dizesi örnekler.

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 kaynağına bakın bir referans noktası olarak kabul edilir.

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 ('). \' ile 'Valentine\'s Day' gibi sorgularda tek tırnak işareti kullanmaktan kaçının. 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 başlıklı makaleyi inceleyin. örnekler.