Operator dan istilah kueri penelusuran

Panduan referensi ini memberikan istilah dan operator kueri yang dapat Anda gunakan dengan Google Drive API untuk memfilter file, folder, dan drive bersama.

Untuk contoh penelusuran file, lihat Menelusuri file dan folder.

Misalnya, penelusuran drive bersama, lihat Menelusuri drive bersama.

Sintaksis string kueri

String kueri berisi tiga bagian berikut:

query_term operator values

Dengan keterangan:

  • query_term adalah kolom atau istilah kueri yang akan ditelusuri.

  • operator menentukan kondisi untuk istilah kueri.

  • values adalah nilai tertentu yang ingin Anda gunakan untuk memfilter hasil penelusuran Anda.

Operator kueri

Tabel berikut mencantumkan operator kueri yang valid:

Operator Penggunaan
contains Konten satu string ada di string lainnya.
= Konten string atau boolean sama dengan yang lain.
!= Konten string atau boolean tidak sama dengan yang lain.
< Nilai kurang dari nilai lainnya.
<= Nilai kurang dari atau sama dengan nilai lain.
> Nilai lebih besar dari nilai lainnya.
>= Nilai lebih besar dari atau sama dengan nilai lainnya.
in Elemen terdapat dalam koleksi.
and Menampilkan item yang cocok dengan kedua kueri.
or Menampilkan item yang cocok dengan salah satu kueri.
not Membatalkan kueri penelusuran.
has Kumpulan berisi elemen yang cocok dengan parameter.

Istilah kueri khusus file

Tabel berikut mencantumkan semua istilah kueri file yang valid. Untuk jenis dan deskripsi data, lihat referensi resource files.

Istilah kueri Operator yang valid Penggunaan
name contains, =, != Nama file. Sertakan dalam tanda kutip tunggal ('). Escape tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
fullText contains Apakah properti name, description, indexableText, atau teks dalam konten file atau metadata file cocok. Sertakan dalam tanda kutip tunggal ('). Escape tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
mimeType contains, =, != Jenis file MIME. Sertakan dalam tanda kutip tunggal ('). Escape tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. Untuk informasi lebih lanjut tentang jenis MIME, lihat jenis MIME yang didukung Google Workspace dan Google Drive.
modifiedTime <=, <, =, !=, >, >= Tanggal modifikasi file terakhir. Format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00. Kolom jenis date tidak dapat dibandingkan satu sama lain, hanya dengan tanggal konstan.
viewedByMeTime <=, <, =, !=, >, >= Tanggal saat pengguna terakhir kali melihat file. Format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00. Kolom jenis date tidak dapat dibandingkan satu sama lain, hanya dengan tanggal konstan.
trashed =, != Apakah file ada di sampah atau tidak. Dapat berupa true atau false.
starred =, != Apakah file diberi bintang atau tidak. Dapat berupa true atau false.
parents in Apakah koleksi induk berisi ID yang ditentukan.
owners in Pengguna yang memiliki file tersebut.
writers in Pengguna atau grup yang memiliki izin untuk mengubah file. Lihat referensi resource permissions.
readers in Pengguna atau grup yang memiliki izin untuk membaca file. Lihat referensi resource permissions.
sharedWithMe =, != File yang ada di koleksi "Dibagikan kepada saya" pengguna. Semua pengguna file tercantum dalam Daftar Kontrol Akses (ACL) file. Dapat berupa true atau false.
createdTime <=, <, =, !=, >, >= Tanggal pembuatan drive bersama. Gunakan format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00.
properties has Properti file kustom publik.
appProperties has Properti file kustom pribadi.
visibility =, != Tingkat visibilitas file. Nilai yang valid adalah anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink, dan limited. Apit dengan tanda petik tunggal (').
shortcutDetails.targetId =, != ID item yang dituju pintasan.

Berikut ini menunjukkan kombinasi operator dan istilah kueri:

  • Operator contains hanya melakukan pencocokan awalan untuk istilah name. Misalnya, Anda memiliki nama HelloWorld. Kueri name contains 'Hello' menampilkan hasil, tetapi kueri name contains 'World' tidak.

  • Operator contains hanya melakukan pencocokan pada seluruh token string untuk istilah fullText. Misalnya, jika teks lengkap dokumen berisi string "HelloWorld", hanya kueri fullText contains 'HelloWorld' yang menampilkan hasil.

  • Operator contains cocok dengan frasa alfanumerik yang sama persis jika dikelilingi oleh tanda petik ganda. Misalnya, jika fullText dokumen berisi string "Halo dunia", kueri fullText contains '"Hello there"' akan menampilkan hasil, tetapi kueri fullText contains '"Hello world"' tidak. Selain itu, karena penelusuran berupa alfanumerik, jika teks lengkap sebuah dokumen berisi string "Hello_world", kueri fullText contains '"Hello world"' akan menampilkan hasil.

  • Istilah owners, writers, dan readers secara tidak langsung tercermin dalam daftar permissions dan merujuk ke role pada izin. Untuk mengetahui daftar lengkap izin peran, lihat Peran dan izin.

Untuk contoh penelusuran string kueri lainnya, lihat contoh string kueri file.

Istilah kueri khusus drive bersama

Tabel berikut mencantumkan semua istilah kueri drive bersama yang valid. Untuk jenis data dan deskripsi, lihat referensi resource drives.

Istilah kueri Operator yang valid Penggunaan Setelan useDomainAdminAccess
createdTime <=, <, =, !=, >, >= Tanggal saat drive bersama dibuat. Format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00. true
hidden =, != Menentukan apakah drive bersama disembunyikan. Dapat berupa true atau false. false
memberCount <=, <, =, !=, >, >= Jumlah pengguna dan grup yang merupakan anggota drive bersama. Memerlukan nilai numerik. true
name contains, =, != Nama drive bersama. Sertakan dalam tanda kutip tunggal ('). Escape tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Jumlah pengguna dan grup yang merupakan penyelenggara drive bersama. Memerlukan nilai numerik. true
orgUnitId =, != ID unit organisasi drive bersama. Mengambil nilai string. true

Untuk contoh penelusuran string kueri lainnya, lihat contoh string kueri drive bersama.