Gunakan metode files.list
untuk menampilkan semua atau hanya beberapa file dan folder pengguna Drive.
Anda juga dapat menggunakan metode files.list
untuk mengambil fileId
yang diperlukan untuk
beberapa metode resource (seperti
files.get
dan
files.update
).
Menelusuri semua file dan folder di Drive Saya milik pengguna saat ini
Gunakan files.list
tanpa parameter untuk menampilkan semua file dan folder.
Menelusuri file atau folder tertentu di Drive Saya milik pengguna saat ini
Untuk menelusuri kumpulan file atau folder tertentu, gunakan kolom q
string kueri
dengan files.list
untuk memfilter file yang akan ditampilkan dengan menggabungkan satu atau beberapa
istilah penelusuran.
{i>String<i} kueri berisi tiga bagian berikut:
query_term operator values
Dalam hal ini:
query_term
adalah kolom atau istilah kueri yang akan ditelusuri. Untuk melihat istilah kueri yang dapat digunakan untuk memfilter drive bersama, baca artikel Istilah dan operator kueri penelusuran.operator
menentukan kondisi untuk istilah kueri. Untuk melihat operator yang dapat Anda gunakan dengan setiap istilah kueri, lihat Operator kueri.values
adalah nilai spesifik yang ingin Anda gunakan untuk memfilter hasil penelusuran.
Misalnya, string kueri berikut memfilter penelusuran agar hanya menampilkan folder:
q: mimeType = 'application/vnd.google-apps.folder'
Contoh berikut menunjukkan cara menggunakan library klien untuk memfilter hasil penelusuran berdasarkan nama file dan ID file JPEG. Contoh ini menggunakan istilah kueri mimeType
untuk mempersempit hasil ke file jenis image/jpeg
. Contoh ini juga menetapkan spaces
ke drive
untuk lebih mempersempit penelusuran ke ruang Drive. Saat nextPageToken
menampilkan null
, tidak ada
hasil lagi.
Java
Python
Node.js
PHP
Untuk membatasi penelusuran ke folder, gunakan string kueri untuk menetapkan jenis MIME ke 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 ini menunjukkan beberapa {i>string<i} kueri dasar. Kode yang sebenarnya berbeda, tergantung pada library klien yang Anda gunakan untuk pencarian Anda.
Apa yang ingin Anda 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 "halo" | not name contains 'hello' |
Folder yang merupakan aplikasi Google atau memiliki jenis MIME folder | mimeType = 'application/vnd.google-apps.folder' |
File yang bukan folder | mimeType != 'application/vnd.google-apps.folder' |
File yang berisi teks "penting" dan ada 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 "halo dunia" | fullText contains '"hello world"' |
File dengan kueri yang berisi karakter "\" (mis., "\authors") | fullText contains '\\authors' |
File dengan ID dalam koleksi, misalnya koleksi parents |
'1234567' in parents |
File di dalam folder data aplikasi dalam koleksi | 'appDataFolder' in parents |
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 diubah setelah tanggal tertentu | modifiedTime > '2012-06-04T12:00:00' // default time zone is UTC |
File yang dibagikan kepada pengguna yang diberi otorisasi dengan nama "halo" | sharedWithMe and name contains 'hello' |
File yang belum dibagikan kepada siapa pun atau domain (hanya pribadi, atau dibagikan kepada pengguna atau grup tertentu) | visibility = 'limited' |
File gambar atau video yang diubah setelah tanggal tertentu | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
Menelusuri file dengan properti file kustom
Untuk menelusuri file dengan properti file kustom, gunakan istilah kueri penelusuran appProperties
dengan kunci dan nilai. Misalnya, untuk menelusuri properti file kustom bernama additionalID
dengan nilai 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Untuk informasi selengkapnya tentang properti file kustom, 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. Misalnya: 'labels/LABEL_ID'
in labels
.
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 nilai kolom atau label tertentu.
Telusuri korpora
Penelusuran yang memanggil files.list
menggunakan
korpus user
secara
default. Untuk menelusuri korpora lain, seperti file yang dibagikan ke
domainGoogle Workspace , gunakan parameter corpora
.
Beberapa korpus dapat ditelusuri dalam satu kueri, meskipun hasil yang tidak lengkap
mungkin ditampilkan jika korpus gabungan terlalu besar. Jika hasil incompleteSearch
adalah true
, tidak semua dokumen ditampilkan.