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 istilahname
. Misalnya, Anda memiliki namaHelloWorld
. Kueriname contains 'Hello'
menampilkan hasil, tetapi kueriname contains 'World'
tidak.Operator
contains
hanya melakukan pencocokan pada seluruh token string untuk istilahfullText
. Misalnya, jika teks lengkap dokumen berisi string "HelloWorld", hanya kuerifullText contains 'HelloWorld'
yang akan menampilkan hasil.Operator
contains
cocok dengan frasa alfanumerik yang tepat jika dikelilingi oleh tanda kutip ganda. Misalnya, jikafullText
dokumen berisi string "Halo dunia", kuerifullText contains '"Hello there"'
akan menampilkan hasil, tetapi kuerifullText contains '"Hello world"'
tidak. Selain itu, karena penelusurannya berupa alfanumerik, jika teks lengkap dokumen berisi string "Hello_world", kuerifullText contains '"Hello world"'
akan menampilkan hasil.Istilah
owners
,writers
, danreaders
secara tidak langsung tercermin dalam daftarpermissions
dan merujuk kerole
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.
Topik terkait
- Menelusuri file dan folder
- Menelusuri drive bersama
- Jenis MIME yang didukung oleh Google Workspace dan Google Drive
- Peran dan izin