Method: files.list

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

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

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
corpora

string

Sorgunun geçerli olduğu öğeler (dosyalar/dokümanlar). Desteklenen gövdeler şunlardır: default, domain, drive ve allDrives. Verimlilik için default veya drive yerine allDrives tercih edin.
corpus
(deprecated)

enum (Corpus)

Kullanımdan kaldırıldı: Sorgunun geçerli olduğu öğelerin (dosyalar/dokümanlar) gövdesi. Bunun yerine corpora politikasını kullanın.
driveId

string

Aranacak ortak Drive'ın kimliği.
includeItemsFromAllDrives

boolean

Sonuçlara hem Drive'ım hem de ortak Drive öğeleri dahil edilip edilmeyeceğini belirler.
includeTeamDriveItems
(deprecated)

boolean

Kullanımdan kaldırıldı: Onun yerine includeItemsFromAllDrives politikasını kullanın.
maxResults

integer

Sayfa başına döndürülecek maksimum dosya sayısı. Kısmi veya boş sonuç sayfaları, dosya listesinin sonuna ulaşılmadan önce bile oluşturulabilir.
orderBy

string

Sıralama anahtarlarının virgülle ayrılmış listesi. Geçerli anahtarlar: createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, title ve title_natural. Her tuş varsayılan olarak artan düzende sıralanır ancak desc değiştiricisiyle tersine çevrilebilir. Örnek kullanım: ?orderBy=folder,modizedDate desc,title. Şu anda, istenen sıralama düzeninin yoksayıldığı yaklaşık bir milyon dosyaya sahip kullanıcılar için geçerli bir sınırlama olduğunu unutmayın.
pageToken

string

Dosyalar için sayfa jetonu.
projection
(deprecated)

enum (Projection)

Kullanımdan kaldırıldı: Bu parametrenin işlevi yoktur.
q

string

Dosya aramak için kullanılan sorgu dizesi.
spaces

string

Sorgulanacak alanların virgülle ayrılmış listesi. drive ve appDataFolder değerleri desteklenir.
supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'ım klasörünü hem de ortak Drive'ları destekleyip desteklemediğini öğrenin.
supportsTeamDrives
(deprecated)

boolean

Kullanımdan kaldırıldı: Onun yerine supportsAllDrives politikasını kullanın.
teamDriveId
(deprecated)

string

Kullanımdan kaldırıldı: Onun yerine driveId politikasını kullanın.
includePermissionsForView

string

Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca published desteklenir.
includeLabels

string

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

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

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

Dosya listesi.

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

string

Dosyaların bir sonraki sayfası için sayfa jetonu. Dosya listesinin sonuna ulaşılmışsa bu bölüm gösterilmez. Jeton herhangi bir nedenle reddedilirse iptal edilmeli ve sonuçların ilk sayfasından sayfalara yeniden başlanmalıdır.
kind

string

Bu her zaman drive#fileList.
etag

string

Listenin ETag'i.
items[]

object (File)

Dosya listesi. NextPageToken doldurulursa bu liste eksik olabilir. Bu durumda ek bir sonuç sayfası getirilir.

Yetkilendirme kapsamları

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

  • 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

Bazı kapsamlar kısıtlanmış olup uygulamanızın bunları kullanması için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.

Külliyat

Sıralamalar
DEFAULT Kullanıcının eriştiği öğeler.
DOMAIN Kullanıcının alanıyla paylaşılan öğeler.