Method: files.list

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

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.

Catatan: Metode ini menampilkan semua file secara default, termasuk file yang telah 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/v2/files

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
corpora	string Isi item (file/dokumen) tempat kueri diterapkan. Isi yang didukung adalah default, domain, drive, dan allDrives. Pilih default atau drive hingga allDrives untuk efisiensi.
corpus (deprecated)	enum (Corpus) Tidak digunakan lagi: Isi item (file/dokumen) yang terpengaruh oleh kueri. 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.
maxResults	integer Jumlah maksimum file yang akan ditampilkan per halaman. Halaman hasil sebagian atau kosong dimungkinkan bahkan sebelum akhir daftar file tercapai.
orderBy	string Daftar kunci pengurutan yang dipisahkan koma. Kunci yang valid adalah createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, title, dan title_natural. Setiap tombol mengurutkan naik secara default, tetapi dapat dibalik dengan pengubah desc. Contoh penggunaan: ?orderBy=folder,ModifyDate desc,title. Perhatikan bahwa saat ini ada batasan bagi pengguna dengan sekitar satu juta file, sehingga tata urutan yang diminta diabaikan.
pageToken	string Token halaman untuk file.
projection (deprecated)	enum (Projection) Tidak digunakan lagi: Parameter ini tidak memiliki fungsi.
q	string String kueri untuk menelusuri file.
spaces	string Daftar spasi yang dipisahkan koma untuk dikueri. Nilai yang didukung adalah drive, dan appDataFolder.
supportsAllDrives	boolean Apakah aplikasi permintaan 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 yang akan disertakan dalam respons. Hanya published yang didukung.
includeLabels	string Daftar ID label yang dipisahkan koma untuk disertakan dalam 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, "etag": string, "selfLink": string, "incompleteSearch": boolean, "nextLink": string, "items": [ { object (File) } ] }

Kolom
nextPageToken	string 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.
kind	string Ini selalu drive#fileList.
etag	string ETag daftar.
selfLink	string Link kembali ke daftar ini.
incompleteSearch	boolean Apakah proses penelusurannya tidak selesai. Jika true (benar), beberapa hasil penelusuran mungkin tidak ada, karena semua dokumen tidak ditelusuri. Hal ini dapat terjadi saat menelusuri beberapa drive dengan "allDrives" korpora, tetapi semua korpora tidak dapat ditelusuri. Jika hal ini terjadi, sebaiknya klien mempersempit kuerinya dengan memilih korpus lain, seperti "default" atau "mengemudi".
nextLink	string Link ke halaman file berikutnya.
items[]	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/docs
• https://www.googleapis.com/auth/drive
• https://www.googleapis.com/auth/drive.appdata
• https://www.googleapis.com/auth/drive.apps.readonly
• 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
DEFAULT	Item yang telah diakses oleh pengguna.
DOMAIN	Item yang dibagikan ke domain pengguna.