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 spesifik yang ingin Anda gunakan untuk memfilter penelusuran hasil pengujian tersebut.

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 tipe data dan deskripsi, lihat referensi files alamat IP internal.

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 di file "Dibagikan kepada saya" pengguna pengumpulan data. 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 dari 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 dari sebuah dokumen berisi string "HelloWorld", hanya kueri fullText contains 'HelloWorld' memberikan hasil.

  • Operator contains cocok dengan frasa alfanumerik yang sama persis jika dan dikelilingi oleh tanda kutip ganda. Misalnya, jika fullText dokumen berisi string "Hello there world", kueri fullText contains '"Hello there"' akan menampilkan hasil, tetapi kueri fullText contains '"Hello world"' tidak. Selain itu, karena pencarian adalah alfanumerik, jika tanda tangan teks dokumen berisi {i>string<i} "Hello_world", maka kuerinya fullText contains '"Hello world"' menampilkan hasil.

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

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

Istilah kueri khusus drive bersama

Tabel berikut mencantumkan semua istilah kueri drive bersama yang valid. Untuk tipe data dan deskripsi, lihat referensi drives alamat IP internal.

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 string kueri drive bersama contoh.