Operator dan istilah kueri penelusuran

Panduan referensi ini menyediakan operator dan istilah 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 lebih kecil dari yang lain.
<= Nilai kurang dari atau sama dengan yang lain.
> Nilai lebih besar dari yang lain.
>= Nilai lebih besar dari atau sama dengan yang lain.
in Elemen dimuat dalam koleksi.
and Tampilkan item yang cocok dengan kedua kueri.
or Menampilkan item yang cocok dengan salah satu kueri.
not Menegasikan kueri penelusuran.
has Koleksi berisi elemen yang cocok dengan parameter.

Istilah kueri spesifik per file

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

Istilah kueri Operator yang valid Penggunaan
name contains, =, != Nama file. Gabungkan dengan 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 atau metadata file cocok. Gabungkan dengan tanda kutip tunggal ('). Escape tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
mimeType contains, =, != Jenis file MIME. Gabungkan dengan tanda kutip tunggal ('). Escape tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. Untuk informasi selengkapnya tentang jenis MIME, lihat jenis MIME yang didukung Google Workspace dan Google Drive.
modifiedTime <=, <, =, !=, >, >= Tanggal modifikasi file terakhir. 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 pengguna terakhir kali melihat file. 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 berada 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.
writers in Pengguna atau grup yang memiliki izin untuk mengubah file. Lihat referensi referensi permissions.
readers in Pengguna atau grup yang memiliki izin untuk membaca file. Lihat referensi referensi permissions.
sharedWithMe =, != File yang ada dalam koleksi "Dibagikan kepada saya" pengguna. Semua pengguna file tercantum dalam Daftar Kontrol Akses (ACL) file. Dapat berupa true atau false.
createdTime <=, <, =, !=, >, >= Tanggal saat drive bersama dibuat. 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. Gabungkan dengan tanda kutip 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 akan menampilkan hasil.

  • Operator contains cocok dengan frasa alfanumerik yang sama persis jika diapit oleh tanda kutip ganda. Misalnya, jika fullText dokumen berisi string "Halo dunia", kueri fullText contains '"Hello there"' akan menampilkan hasil, sedangkan 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.

  • Persyaratan owners, writers, dan readers tercermin secara tidak langsung 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. 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 menjadi anggota drive bersama. Dibutuhkan nilai numerik. true
name contains, =, != Nama drive bersama. Gabungkan dengan 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. Dibutuhkan nilai numerik. true
orgUnitId =, != ID unit organisasi drive bersama. Dibutuhkan nilai string. true

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