Method: files.list

Kullanıcının dosyalarını listeler.

Bu yöntem, bir veya daha fazla arama terimini birleştiren arama sorgusu olan q parametresini kabul eder. Daha fazla bilgi için Dosya ve klasör arama kılavuzuna göz atın.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
corpora

string

Sorgunun geçerli olduğu öğelerin (dosyalar/dokümanlar) gövdeleri. Desteklenen gövdeler "user", "domain", "drive" ve "allDrives"dır. Verimlilik için "allDrives" yerine "kullanıcı" veya "sürücü"yü tercih edin. Varsayılan olarak, derleme "user" değerine ayarlanır. Ancak bu değer, "q" parametresiyle ayarlanan filtreye bağlı olarak değişebilir.
corpus
(deprecated)

enum (Corpus)

Kullanımdan kaldırıldı: Listelenecek dosyaların kaynağı. Bunun yerine "Corpora" kullanın.
driveId

string

Aranacak ortak Drive'ın kimliği.
includeItemsFromAllDrives

boolean

Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği.
includeTeamDriveItems
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine includeItemsFromAllDrives kullanın.
orderBy

string

Sıralama anahtarlarının virgülle ayrılmış listesi. Geçerli anahtarlar şunlardır: "createdTime", "folder", "modifiedByMeTime", "modifiedTime", "name", "name_natural", "quotaBytesUsed", "recency", "sharedWithMeTime", "starred" ve "viewedByMeTime". Her tuş varsayılan olarak artan düzende sıralanır ancak "azalan" değiştiricisiyle tersine çevrilebilir. Örnek kullanım: ?orderBy=folder,modifiedTime desc,name.
pageSize

integer

Sayfa başına döndürülecek maksimum dosya sayısı. Dosya listesinin sonuna ulaşılmadan önce bile kısmi ya da boş sonuç sayfalarının oluşturulması mümkündür.
pageToken

string

Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, önceki yanıttaki "nextPageToken" değerine ayarlanmalıdır.
q

string

Dosya sonuçlarını filtreleme sorgusu. Desteklenen söz dizimi için "Dosya ve klasör arama" kılavuzuna bakın.
spaces

string

Şirket içinde sorgulanacak alanların virgülle ayrılmış listesi. "drive" ve "appDataKlasör" desteklenir.
supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'ım klasörlerini hem de ortak drive'ları destekleyip desteklemediği.
supportsTeamDrives
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine supportsAllDrives kullanın.
teamDriveId
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine driveId kullanın.
includePermissionsForView

string

Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" desteklenmektedir.
includeLabels

string

Yanıtın labelInfo bölümüne dahil edilecek etiket kimliklerinin virgülle ayrılmış listesi.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Dosya listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "nextPageToken": string,
  "kind": string,
  "incompleteSearch": boolean,
  "files": [
    {
      object (File)
    }
  ]
}
Alanlar
nextPageToken

string

Dosyaların sonraki sayfası için sayfa jetonu. Dosya listesinin sonuna ulaşıldıysa bu dosya eksik olacaktır. Jeton herhangi bir nedenle reddedilirse silinmeli ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklediğiniz sonuçlar farklılık gösterebilir.
kind

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: "drive#fileList" sabit dizesi.
files[]

object (File)

Dosya listesi. nextPageToken doldurulursa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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.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

Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

Külliyat

Sıralamalar
user Kullanıcıya ait olan veya kullanıcıyla paylaşılan dosyalar.
domain Kullanıcının alanıyla paylaşılan dosyalar.