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.
Permintaan HTTP
GET https://www.googleapis.com/drive/v2/files
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
corpora |
Bodi item (file/dokumen) yang menerapkan kueri. Isi yang didukung adalah |
corpus |
Tidak digunakan lagi: Isi item (file/dokumen) yang digunakan oleh kueri. Sebagai gantinya, gunakan |
driveId |
ID drive bersama yang akan ditelusuri. |
includeItemsFromAllDrives |
Apakah Drive Saya dan item drive bersama harus disertakan dalam hasil. |
includeTeamDriveItems |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
maxResults |
Jumlah maksimum file untuk ditampilkan per halaman. Halaman hasil yang kosong atau sebagian mungkin muncul bahkan sebelum akhir daftar file tercapai. |
orderBy |
Daftar kunci urutan yang dipisahkan koma. Kunci yang valid adalah |
pageToken |
Token halaman untuk file. |
projection |
Tidak digunakan lagi: Parameter ini tidak memiliki fungsi. |
q |
String kueri untuk menelusuri file. |
spaces |
Daftar spasi yang dipisahkan koma untuk kueri. Nilai yang didukung adalah |
supportsAllDrives |
Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama. |
supportsTeamDrives |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
teamDriveId |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
includePermissionsForView |
Menentukan izin tampilan tambahan mana yang akan disertakan dalam respons. Hanya |
includeLabels |
Daftar ID label yang dipisahkan koma untuk disertakan di 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,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
Kolom | |
---|---|
nextPageToken |
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. |
kind |
Ini selalu |
etag |
ETag daftar. |
selfLink |
Link kembali ke daftar ini. |
incompleteSearch |
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 "default" atau "drive". |
nextLink |
Link ke halaman file berikutnya. |
items[] |
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.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 | |
---|---|
DEFAULT |
Item yang telah diakses pengguna. |
DOMAIN |
Item yang dibagikan ke domain pengguna. |