Arama sorgusu terimleri ve operatörleri

Bu referans kılavuzunda, dosyaları, klasörleri ve ortak Drive'ları filtrelemek için Google Drive API ile kullanabileceğiniz sorgu terimleri ve operatörler yer almaktadır.

Dosya arama örnekleri için Dosya ve klasör arama başlıklı makaleyi inceleyin.

Ortak Drive'larda arama yapmayla ilgili örnekler 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, 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.

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 bulunuyor.
= Bir dizenin veya boole değerinin içeriği diğerine eşittir.
!= Bir dize veya boole değerinin içeriği diğerine eşit değil.
< Bir değer diğerinden küçük.
<= Bir değer, başka bir değere eşit veya ondan küçük.
> Bir değer diğerinden büyüktür.
>= Bir değer, başka bir değerden büyük veya ona eşitse
in Bir öğe, koleksiyonda yer alır.
and Her iki sorguyla da eşleşen öğeleri döndürür.
or Sorgulardan biriyle eşleşen öğeleri döndürür.
not Arama sorgusunu olumsuzlar.
has Bir koleksiyon, parametrelerle eşleşen bir öğe içerir.

Dosyaya özgü sorgu terimleri

Aşağıdaki tabloda, geçerli tüm dosya sorgusu 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, = ve != Dosyanın adı. Tek tırnak işareti (') ile çevreleyin. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day').
fullText contains name, description, indexableText özelliklerinin veya dosya içeriğindeki metnin ya da dosyanın meta verilerinin eşleşip eşleşmediği. Tek tırnak işareti (') ile çevreleyin. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day').
mimeType contains, = ve != Dosyanın MIME türü. Tek tırnak işareti (') ile çevreleyin. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day'). MIME türleri hakkında daha fazla bilgi için Google Workspace ve Google Drive'da desteklenen MIME türleri başlıklı makaleyi inceleyin.
modifiedTime <=, <, =, !=, >, >= Dosyanın son değiştirilme tarihi. RFC 3339 biçimi, varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00). date türündeki alanlar birbirleriyle değil, 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ündeki alanlar birbirleriyle değil, 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ız işaretli olup olmadığı true veya false olabilir.
parents in parents koleksiyonunun belirtilen kimliği içerip içermediği. Yalnızca doğrudan üst klasörleri kontrol eder; dolaylı üst klasörlerle eşleşmez.
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 <=, <, =, !=, >, >= Dosyanı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). Yalnızca Drive API v3'te desteklenir.
properties has Herkese açık özel dosya özellikleri.
appProperties has Özel dosya özellikleri.
visibility =, != Dosyanın görünürlük düzeyi. Geçerli değerler: anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink ve limited. Tek tırnak işaretiyle (') çevreleyin.
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 önek eşleştirme yapar. Ö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 döndürmez.

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

  • Sağ işlenen çift tırnak içine alınmışsa contains operatörü bir ifadeyle eşleşir. Örneğin:

    • Bir dokümanın fullText alanı "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.

    • Bir dokümanın tam metni "Hello_world" dizesini içeriyorsa doküman dizesindeki alt çizgi boşluk olarak değerlendirildiğinden fullText contains '"Hello world"' sorgusu yine bir sonuç döndürür.

  • owners, writers ve readers terimleri, permissions listesinde dolaylı olarak yansıtılır ve izindeki role'i ifade eder. Rol izinlerinin tam listesi için Roller ve izinler başlıklı makaleyi inceleyin.

Sorgu dizesi aramalarıyla ilgili daha fazla örnek için Dosya sorgu dizesi örnekleri başlıklı makaleyi inceleyin.

Ortak Drive'a özel sorgu terimleri

Aşağıdaki tabloda, geçerli tüm ortak Drive sorgu terimleri listelenmiştir. 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 gizli olup olmadığını belirtir. true veya false olabilir. false
memberCount <=, <, =, !=, >, >= Ortak Drive'ın üyesi olan kullanıcı ve grupların sayısı. Sayısal bir değer alır. true
name contains, = ve != Ortak Drive'ın adı. Tek tırnak işareti (') içine alın. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day'). true
organizerCount <=, <, =, !=, >, >= Ortak Drive'ın düzenleyicisi olan kullanıcı ve grup sayısı. Sayısal bir değer alır. true
orgUnitId =, != Ortak Drive'ın kuruluş birimi kimliği. Dize değeri alır. true

Sorgu dizesi aramalarıyla ilgili daha fazla örnek için ortak Drive sorgu dizesi örnekleri başlıklı makaleyi inceleyin.