Method: files.list

Mencantumkan file pengguna.

Metode ini menerima parameter q, yang merupakan kueri penelusuran yang menggabungkan satu atau beberapa istilah penelusuran. Untuk mendapatkan 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

string

Badan item (file/dokumen) tempat kueri diterapkan. Isi yang didukung adalah default, domain, drive, dan allDrives. Pilih default atau drive ke allDrives untuk efisiensi.

corpus
(deprecated)

enum (Corpus)

Tidak digunakan lagi: Isi item (file/dokumen) tempat kueri diterapkan. Sebagai gantinya, gunakan corpora.

driveId

string

ID drive bersama yang akan ditelusuri.

includeItemsFromAllDrives

boolean

Apakah item Drive Saya dan drive bersama harus disertakan dalam hasil.

includeTeamDriveItems
(deprecated)

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan includeItemsFromAllDrives.

maxResults

integer

Jumlah file maksimum yang akan dikembalikan per halaman. Halaman hasil yang kosong atau sebagian dapat ditampilkan 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 kunci diurutkan naik secara default, tetapi dapat dikembalikan dengan pengubah desc. Contoh penggunaan: ?orderBy=folder,modifiedDate desc,title. Perlu diketahui bahwa saat ini ada batasan bagi pengguna yang memiliki sekitar satu juta file yang urutan penyortiran yang diminta akan 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 kueri. 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 yang akan disertakan dalam respons. Hanya published 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,
  "etag": string,
  "selfLink": string,
  "incompleteSearch": boolean,
  "nextLink": string,
  "items": [
    {
      object (File)
    }
  ]
}
Kolom
nextPageToken

string

Token halaman untuk halaman file berikutnya. Fitur 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

Nilainya selalu drive#fileList.

etag

string

ETag daftar.

items[]

object (File)

Daftar file. Jika nextPageToken diisi, daftar ini mungkin tidak lengkap dan halaman tambahan hasil 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 memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.

Korpus

Enum
DEFAULT Item yang telah diakses pengguna.
DOMAIN Item yang dibagikan ke domain pengguna.