Mencantumkan file pengguna.
Metode ini menerima parameter q
, yaitu kueri penelusuran yang menggabungkan satu atau beberapa istilah penelusuran. Untuk informasi selengkapnya, lihat Menelusuri file & folder.
Permintaan HTTP
GET https://www.googleapis.com/drive/v3/files
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
corpora |
Isi item (file/dokumen) tempat kueri diterapkan. Isi yang didukung adalah 'user', 'domain', 'drive', dan 'allDrives'. Pilih 'user' atau 'drive' daripada 'allDrives' untuk efisiensi. Secara default, korpus disetel ke 'user'. Namun, hal ini dapat berubah bergantung pada filter yang disetel melalui perintah 'q' . |
corpus |
Tidak digunakan lagi: Sumber file yang akan dicantumkan. Sebagai gantinya, gunakan 'korpus'. |
driveId |
ID drive bersama yang akan ditelusuri. |
includeItemsFromAllDrives |
Apakah Drive Saya dan item drive bersama harus disertakan dalam hasil. |
includeTeamDriveItems |
Tidak digunakan lagi: Gunakan |
orderBy |
Daftar kunci pengurutan yang dipisahkan koma. Kunci yang valid adalah:
Setiap kunci diurutkan menaik secara default, tetapi dapat dibalik dengan 'desc' pengubah. Contoh penggunaan: |
pageSize |
Jumlah maksimum file yang akan ditampilkan per halaman. Halaman hasil sebagian atau kosong dapat terjadi bahkan sebelum akhir daftar file tercapai. |
pageToken |
Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Ini harus disetel ke nilai 'nextPageToken' dari respons sebelumnya. |
q |
Kueri untuk memfilter hasil file. Lihat panduan "Menelusuri file & folder" untuk mengetahui sintaksis yang didukung. |
spaces |
Daftar spasi yang dipisahkan koma untuk dikueri dalam korpora. Nilai yang didukung adalah 'drive' dan 'appDataFolder'. |
supportsAllDrives |
Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama. |
supportsTeamDrives |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
teamDriveId |
Tidak digunakan lagi: Gunakan |
includePermissionsForView |
Menentukan izin tampilan tambahan yang akan disertakan dalam respons. Hanya 'dipublikasikan' didukung. |
includeLabels |
Daftar ID label yang dipisahkan koma untuk disertakan dalam bagian |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Daftar file.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"nextPageToken": string,
"kind": string,
"incompleteSearch": boolean,
"files": [
{
object ( |
Kolom | |
---|---|
nextPageToken |
Token halaman untuk halaman file berikutnya. Fungsi ini tidak akan ada jika akhir daftar file telah tercapai. Jika ditolak karena alasan apa pun, token harus dihapus, dan penomoran halaman harus dimulai ulang dari halaman pertama hasil. Token halaman biasanya berlaku selama beberapa jam. Namun, jika item baru ditambahkan atau dihapus, hasil yang diharapkan mungkin berbeda. |
kind |
Mengidentifikasi jenis resource ini. Nilai: string tetap |
incompleteSearch |
Apakah proses penelusuran tidak selesai. Jika benar, beberapa hasil penelusuran mungkin tidak ada, karena semua dokumen tidak ditelusuri. Hal ini dapat terjadi saat menelusuri beberapa drive dengan korpus 'allDrives', tetapi semua korpus tidak dapat ditelusuri. Saat hal ini terjadi, sebaiknya klien mempersempit kuerinya dengan memilih korpus lain, seperti 'pengguna' atau 'drive'. |
files[] |
Daftar file. Jika nextPageToken diisi, daftar ini mungkin tidak lengkap dan halaman hasil tambahan harus diambil. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.
Korpus
Enum | |
---|---|
user |
File yang dimiliki oleh atau dibagikan kepada pengguna. |
domain |
File yang dibagikan ke domain pengguna. |