Google Drive API mendukung beberapa cara untuk menelusuri file dan folder.
Anda dapat menggunakan metode files.list
untuk menampilkan
semua atau beberapa file dan folder pengguna Drive. Metode files.list
juga dapat digunakan untuk mengambil fileId
yang diperlukan untuk beberapa metode
resource (seperti files.get
dan
files.update
).
Menelusuri semua file dan folder di Drive Saya pengguna saat ini
Gunakan metode files.list
tanpa parameter apa pun untuk menampilkan semua file dan
folder.
GET https://www.googleapis.com/drive/v3/files
Menelusuri file atau folder tertentu di Drive Saya pengguna saat ini
Untuk menelusuri kumpulan file atau folder tertentu, gunakan kolom q
string kueri
dengan metode files.list
untuk memfilter
file yang akan ditampilkan dengan menggabungkan satu atau beberapa istilah penelusuran.
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.
Untuk melihat istilah dan operator kueri yang dapat Anda gunakan untuk memfilter file dan folder, lihat Istilah dan operator kueri penelusuran.
Misalnya, string kueri berikut memfilter penelusuran agar hanya menampilkan folder dengan menetapkan jenis MIME:
q: mimeType = 'application/vnd.google-apps.folder'
Untuk mengetahui informasi selengkapnya tentang jenis MIME, lihat jenis MIME yang didukung Google Workspace dan Google Drive.
Contoh string kueri
Tabel berikut mencantumkan contoh beberapa string kueri dasar. Kode sebenarnya berbeda-beda, bergantung pada library klien yang Anda gunakan untuk penelusuran.
Anda juga harus meng-escape karakter khusus dalam nama file untuk memastikan kueri berfungsi dengan benar. Misalnya, jika nama file berisi apostrof
('
) dan karakter garis miring terbalik ("\"
), gunakan garis miring terbalik untuk meng-escape-nya: name
contains 'quinn\'s paper\\essay'
.
Yang ingin Anda buat kueri | Contoh |
---|---|
File dengan nama "hello" | name = 'hello' |
File dengan nama yang berisi kata "halo" dan "selamat tinggal" | name contains 'hello' and name contains 'goodbye' |
File dengan nama yang tidak berisi kata "hello" | not name contains 'hello' |
File yang berisi teks "penting" dan berada di sampah | fullText contains 'important' and trashed = true |
File yang berisi kata "halo" | fullText contains 'hello' |
File yang tidak memiliki kata "halo" | not fullText contains 'hello' |
File yang berisi frasa persis "hello world" | fullText contains '"hello world"' |
File dengan kueri yang berisi karakter "\" (misalnya, "\authors") | fullText contains '\\authors' |
File yang merupakan folder | mimeType = 'application/vnd.google-apps.folder' |
File yang bukan folder | mimeType != 'application/vnd.google-apps.folder' |
File yang diubah setelah tanggal tertentu (zona waktu default adalah UTC) | modifiedTime > '2012-06-04T12:00:00' |
File gambar atau video yang diubah setelah tanggal tertentu | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
File yang diberi bintang | starred = true |
File dalam koleksi (misalnya, ID folder dalam koleksi parents ) |
'1234567' in parents |
File dalam folder data aplikasi dalam koleksi | 'appDataFolder' in parents |
File yang pemiliknya adalah pengguna "test@example.org" | 'test@example.org' in owners |
File yang izin tulisnya dimiliki pengguna "test@example.org" | 'test@example.org' in writers |
File yang anggota grup "group@example.org" memiliki izin tulis | 'group@example.org' in writers |
File yang dibagikan kepada pengguna yang diberi otorisasi dengan "halo" dalam namanya | sharedWithMe and name contains 'hello' |
File dengan properti file kustom yang terlihat oleh semua aplikasi | properties has { key='mass' and value='1.3kg' } |
File dengan properti file kustom yang bersifat pribadi untuk aplikasi yang meminta | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
File yang belum dibagikan kepada siapa pun atau domain (hanya bersifat pribadi, atau dibagikan kepada pengguna atau grup tertentu) | visibility = 'limited' |
Memfilter hasil penelusuran dengan library klien
Contoh kode berikut menunjukkan cara menggunakan library klien untuk memfilter hasil penelusuran
ke nama file dan ID file JPEG. Contoh ini menggunakan istilah kueri mimeType
untuk mempersempit hasil ke file berjenis image/jpeg
. Tindakan ini juga menetapkan
spaces
ke drive
untuk mempersempit penelusuran lebih lanjut ke ruang Drive. Saat nextPageToken
menampilkan null
,
tidak ada lagi hasil.
Java
Python
Node.js
PHP
Menelusuri file dengan properti file kustom
Untuk menelusuri file dengan properti file kustom, gunakan istilah kueri penelusuran properties
atau appProperties
dengan kunci dan nilai. Misalnya, untuk
menelusuri properti file kustom yang bersifat pribadi untuk aplikasi yang meminta yang disebut
additionalID
dengan nilai 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Untuk informasi selengkapnya, lihat Menambahkan properti file kustom.
Menelusuri file dengan label atau nilai kolom tertentu
Untuk menelusuri file dengan label tertentu, gunakan istilah kueri penelusuran labels
dengan ID label tertentu. Contoh: 'labels/LABEL_ID' in
labels
. Jika berhasil, isi respons akan berisi semua instance file tempat label diterapkan.
Untuk menelusuri file tanpa ID label tertentu: Not
'labels/LABEL_ID' in labels
.
Anda juga dapat menelusuri file berdasarkan nilai kolom tertentu. Misalnya, untuk
menelusuri file dengan nilai teks:
labels/LABEL_ID.text_field_id ='TEXT'
.
Untuk mengetahui informasi selengkapnya, lihat Menelusuri file dengan label atau nilai kolom tertentu.
Menelusuri korpus
Penelusuran yang memanggil files.list
menggunakan
corpora
dari user
secara default. Untuk menelusuri
korpus lain, seperti file yang dibagikan dengan domain
, tetapkan parameter
corpora
.
Beberapa korpus dapat ditelusuri dalam satu kueri, meskipun hasil yang tidak lengkap
mungkin ditampilkan jika korpus gabungan terlalu besar. Jika incompleteSearch
adalah
true
dalam isi respons, semua dokumen tidak akan ditampilkan. Jika hal ini
terjadi, Anda harus mempersempit kueri dengan memilih korpus lain seperti
user
atau drive
.
Topik terkait
- Menelusuri drive bersama
- Istilah dan operator kueri penelusuran
- Jenis MIME yang didukung Google Workspace dan Google Drive
- Peran dan izin
- Menelusuri file dengan label atau nilai kolom tertentu