Method: files.list

• Permintaan HTTP
• Parameter kueri
• Isi permintaan
• Isi respons
  • Representasi JSON
• Cakupan otorisasi
• Korpus
• Cobalah

Mencantumkan file pengguna.

Metode ini menerima parameter q, yang merupakan kueri penelusuran yang menggabungkan satu atau beberapa istilah penelusuran. Untuk informasi selengkapnya, lihat panduan Menelusuri file & folder.

Catatan: Metode ini menampilkan semua file secara default, termasuk file yang dibuang. Jika Anda tidak ingin file yang dibuang muncul dalam daftar, gunakan parameter kueri trashed=false untuk menghapus file yang dibuang dari hasil.

Permintaan HTTP

GET https://www.googleapis.com/drive/v3/files

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
corpora	string Bodi item (file/dokumen) yang menerapkan kueri. Isi yang didukung adalah 'user', 'domain', 'drive', dan 'allDrives'. Pilih 'pengguna' atau 'drive' daripada 'allDrives' untuk efisiensi. Secara default, perusahaan diatur menjadi 'pengguna'. Namun, hal ini dapat berubah bergantung pada filter yang ditetapkan melalui parameter 'q'.
corpus (deprecated)	enum (Corpus) Tidak digunakan lagi: Sumber file yang akan dicantumkan. Sebagai gantinya, gunakan 'corpora'.
driveId	string ID drive bersama yang akan ditelusuri.
includeItemsFromAllDrives	boolean Apakah Drive Saya dan item drive bersama harus disertakan dalam hasil.
includeTeamDriveItems (deprecated)	boolean Tidak digunakan lagi: Sebagai gantinya, gunakan includeItemsFromAllDrives.
orderBy	string Daftar kunci urutan yang dipisahkan koma. Kunci yang valid adalah 'createdTime', 'folder', 'ModifiedByMeTime', 'ModifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', dan 'viewedByMeTime'. Setiap kunci diurutkan secara menaik secara default, namun dapat dikembalikan dengan pengubah 'desc'. Contoh penggunaan: ?orderBy=folder,ModifiedTime desc,name.
pageSize	integer Jumlah maksimum file untuk ditampilkan per halaman. Halaman hasil yang kosong atau sebagian mungkin muncul bahkan sebelum akhir daftar file tercapai.
pageToken	string Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Ini harus ditetapkan ke nilai 'nextPageToken' dari respons sebelumnya.
q	string Kueri untuk memfilter hasil file. Lihat panduan "Menelusuri file & folder" untuk mengetahui sintaksis yang didukung.
spaces	string Daftar ruang yang dipisahkan koma untuk membuat kueri dalam korpora. Nilai yang didukung adalah 'drive' dan 'appDataFolder'.
supportsAllDrives	boolean Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.
supportsTeamDrives (deprecated)	boolean Tidak digunakan lagi: Sebagai gantinya, gunakan supportsAllDrives.
teamDriveId (deprecated)	string Tidak digunakan lagi: Sebagai gantinya, gunakan driveId.
includePermissionsForView	string Menentukan izin tampilan tambahan mana yang akan disertakan dalam respons. Hanya 'dipublikasikan' yang didukung.
includeLabels	string Daftar ID label yang dipisahkan koma untuk disertakan di bagian labelInfo respons.

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 (File) } ] }

Kolom
nextPageToken	string Token halaman untuk halaman file berikutnya. Opsi ini tidak akan tersedia jika akhir daftar file telah tercapai. Jika token ditolak karena alasan apa pun, token tersebut harus dihapus, dan penomoran halaman harus dimulai ulang dari halaman pertama hasil. Token halaman biasanya valid selama beberapa jam. Namun, jika item baru ditambahkan atau dihapus, hasil yang Anda harapkan mungkin berbeda.
kind	string Mengidentifikasi jenis resource ini. Nilai: string tetap "drive#fileList".
incompleteSearch	boolean Apakah proses penelusuran tidak lengkap. Jika true (benar), beberapa hasil penelusuran mungkin tidak ada, karena semua dokumen tidak ditelusuri. Hal ini dapat terjadi saat menelusuri beberapa drive dengan korpora 'allDrives', tetapi semua korpora tidak dapat ditelusuri. Jika ini terjadi, sebaiknya klien mempersempit kueri mereka dengan memilih korpus yang berbeda seperti 'pengguna' atau 'drive'.
files[]	object (File) 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.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 membutuhkan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

Korpus

Enumerasi
user	File yang dimiliki oleh atau dibagikan kepada pengguna.
domain	File yang dibagikan ke domain pengguna.