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 rehberine 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 öğelerin gövdeleri (dosyalar/dokümanlar). Desteklenen gövdeler: default, domain, drive ve allDrives. Verimlilik için allDrives ile default veya drive arasında seçim yapın.
corpus
(deprecated)

enum (Corpus)

Kullanımdan kaldırıldı: Sorgunun geçerli olduğu öğelerin gövdesi (dosyalar/dokümanlar). Bunun yerine corpora politikasını 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

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

integer

Sayfa başına döndürülecek maksimum dosya sayısı. Dosya listesinin sonuna ulaşılmadan önce bile kısmi veya boş sonuç sayfalarının görünmesi mümkündür.
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 şeklindedir. Her tuş varsayılan olarak artan düzende sıralanır ancak desc değiştiricisiyle tersine çevrilebilir. Örnek kullanım: ?orderBy=folder,modifiedDate desc,title. Şu anda, istenen sıralama düzeninin yok sayıldığı yaklaşık bir milyon dosyaya sahip kullanıcılar için 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 yok.
q

string

Dosya aramak için 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'larım hem de ortak Drive'ları destekleyip desteklemediği.
supportsTeamDrives
(deprecated)

boolean

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

string

Kullanımdan kaldırıldı: Bunun yerine driveId 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 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,
  "etag": string,
  "selfLink": string,
  "incompleteSearch": boolean,
  "nextLink": string,
  "items": [
    {
      object (File)
    }
  ]
}
Alanlar
nextPageToken

string

Dosyaların sonraki sayfası için sayfa jetonu. Dosya listesinin sonuna ulaşıldığında bu bilgi bulunmaz. Jeton herhangi bir nedenle reddedilirse silinir ve sayfalara ayırma işlemi ilk sonuç sayfasından yeniden başlatılmalıdır.
kind

string

Bu her zaman drive#fileList olur.
etag

string

Listenin ETag.
items[]

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/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ıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.

Külliyat

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