Method: files.list

Mencantumkan file pengguna.

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

Isi item (file/dokumen) tempat kueri diterapkan. Badan yang didukung adalah default, domain, drive, dan allDrives. Lebih memilih default atau drive daripada allDrives untuk efisiensi.
corpus
(deprecated)

enum (Corpus)

Tidak digunakan lagi: Isi item (file/dokumen) yang menerapkan kueri. 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: Gunakan includeItemsFromAllDrives sebagai gantinya.
maxResults

integer

Jumlah maksimum file yang akan ditampilkan per halaman. Halaman hasil sebagian atau kosong dapat terjadi bahkan sebelum akhir daftar file tercapai.
orderBy

string

Daftar kunci pengurutan yang dipisahkan koma. Kunci yang valid adalah:

  • createdDate: Saat file dibuat.
  • folder: ID folder. Kolom ini diurutkan menggunakan urutan abjad.
  • lastViewedByMeDate: Terakhir kali file dilihat oleh pengguna.
  • modifiedByMeDate: Terakhir kali file diubah oleh pengguna.
  • modifiedDate: Terakhir kali file diubah oleh siapa pun.
  • quotaBytesUsed: Jumlah byte kuota penyimpanan yang digunakan oleh file.
  • recency: Stempel waktu terbaru dari kolom tanggal dan waktu file.
  • sharedWithMeDate: Jika berlaku, saat file dibagikan kepada pengguna.
  • starred: Apakah pengguna telah membintangi file.
  • title: Judul file. Kolom ini diurutkan menggunakan urutan abjad, jadi 1, 12, 2, 22.
  • title_natural: Judul file. Kolom ini diurutkan menggunakan urutan pengurutan alami, jadi 1, 2, 12, 22.

Setiap kunci diurutkan menaik secara default, tetapi dapat dibalik dengan pengubah 'desc'. Contoh penggunaan: ?orderBy=folder,modifiedDate desc,title.

Perhatikan bahwa saat ini ada batasan bagi pengguna dengan sekitar satu juta file yang mengabaikan urutan pengurutan yang diminta.
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 ruang yang dipisahkan koma untuk dikueri. 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: Gunakan supportsAllDrives sebagai gantinya.
teamDriveId
(deprecated)

string

Tidak digunakan lagi: Gunakan driveId sebagai gantinya.
includePermissionsForView

string

Menentukan izin tampilan tambahan mana 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 
{
  "items": [
    {
      object (File)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "incompleteSearch": boolean,
  "nextLink": string
}
Kolom
items[]

object (File)

Daftar file. Jika nextPageToken diisi, daftar ini mungkin tidak lengkap dan halaman hasil tambahan harus diambil.
nextPageToken

string

Token halaman untuk halaman file berikutnya. Bagian ini tidak akan ada jika akhir daftar file telah tercapai. Jika token ditolak karena alasan apa pun, token tersebut harus dibuang, dan penomoran halaman harus dimulai ulang dari halaman pertama hasil.
kind

string

Nilai ini selalu drive#fileList.
etag

string

ETag daftar.

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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.

Korpus

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