Operator dan istilah kueri penelusuran

Panduan referensi ini menyediakan 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.

Untuk contoh penelusuran drive bersama, lihat Menelusuri drive bersama.

Sintaksis string kueri

String kueri berisi tiga bagian berikut:

query_term operator values

Dengan:

  • query_term adalah istilah kueri atau kolom yang akan ditelusuri.

  • operator menentukan kondisi untuk istilah kueri.

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

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 lainnya.
> 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 Menegasikan kueri penelusuran.
has Koleksi berisi elemen yang cocok dengan parameter.

Istilah kueri khusus 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. Apiti dengan tanda kutip tunggal ('). Pisahkan 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. Apiti dengan tanda kutip tunggal ('). Pisahkan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
mimeType contains, =, != Jenis MIME file. Apiti dengan tanda kutip tunggal ('). Pisahkan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. Untuk mengetahui 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 berjenis date tidak dapat dibandingkan satu sama lain, hanya dengan tanggal tetap.
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 berjenis date tidak dapat dibandingkan satu sama lain, hanya dengan tanggal tetap.
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.
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 berada dalam Daftar Kontrol Akses (ACL) file. Dapat berupa true atau false.
createdTime <=, <, =, !=, >, >= Tanggal saat file 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. Mengapit dengan tanda kutip tunggal (').
shortcutDetails.targetId =, != ID item yang dituju pintasan.

Berikut adalah contoh 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 token string utuh untuk istilah fullText. Misalnya, jika teks lengkap dokumen berisi string "HelloWorld", hanya kueri fullText contains 'HelloWorld' yang akan menampilkan hasil.

  • Operator contains mencocokkan frasa alfanumerik yang tepat jika operand kanan diapit tanda petik ganda. Misalnya, jika fullText dokumen berisi string "Hello there world", maka kueri fullText contains '"Hello there"' akan menampilkan hasil, tetapi kueri fullText contains '"Hello world"' tidak. Selain itu, karena penelusuran bersifat alfanumerik, jika teks lengkap dokumen berisi string "Hello_world", maka kueri fullText contains '"Hello world"' akan menampilkan hasil.

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

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

Istilah kueri khusus drive bersama

Tabel berikut mencantumkan semua istilah kueri drive bersama yang valid. Untuk jenis dan deskripsi data, 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 menjadi anggota drive bersama. Mengambil nilai numerik. true
name contains, =, != Nama drive bersama. Apiti dengan tanda kutip tunggal ('). Pisahkan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Jumlah pengguna dan grup yang menjadi penyelenggara drive bersama. Mengambil nilai numerik. true
orgUnitId =, != ID unit organisasi dari drive bersama. Mengambil nilai string. true

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