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.

Untuk contoh 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 istilah atau kolom kueri 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 dari 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.
> Sebuah nilai lebih besar dari yang lain.
>= Nilai lebih besar dari atau sama dengan yang lain.
in Elemen dimuat di dalam koleksi.
and Menampilkan item yang cocok dengan kedua kueri.
or Menampilkan item yang cocok dengan salah satu kueri.
not Menegaskan 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 dan deskripsi data, lihat referensi resource files.

Istilah kueri Operator yang valid Penggunaan
name contains, =, != Nama file. Tambahkan tanda kutip tunggal ('). Lepaskan 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. Tambahkan tanda kutip tunggal ('). Lepaskan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
mimeType contains, =, != Jenis file MIME. Tambahkan tanda kutip tunggal ('). Lepaskan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. Untuk mengetahui informasi selengkapnya tentang jenis MIME, lihat Jenis MIME yang didukung Google Workspace dan Google Drive.
modifiedTime <=, <, =, !=, >, >= Tanggal terakhir file diubah. 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 pengguna melihat file terakhir kali. 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 berbintang 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 dalam koleksi "Dibagikan kepada saya" pengguna. Semua pengguna file berada di 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. Diapit dengan tanda petik tunggal (').
shortcutDetails.targetId =, != ID item yang ditunjuk pintasan.

Hal berikut 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 tepat jika dikelilingi oleh tanda kutip 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 penelusurannya berupa alfanumerik, jika teks lengkap 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.

Persyaratan 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 merupakan anggota drive bersama. Mengambil nilai numerik. true
name contains, =, != Nama drive bersama. Tambahkan tanda kutip tunggal ('). Lepaskan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Jumlah pengguna dan grup yang menjadi pengelola drive bersama. Mengambil nilai numerik. true
orgUnitId =, != ID unit organisasi dari drive bersama. Mengambil nilai string. true

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