Method: files.list

Kullanıcının dosyalarını listeler. Daha fazla bilgi için Dosya ve klasör arama başlıklı makaleyi inceleyin.

Bu yöntem, bir veya daha fazla arama terimini birleştiren bir arama sorgusu olan q parametresini kabul eder.

Bu yöntem, silinen dosyalar da dahil olmak üzere varsayılan olarak tüm dosyaları döndürür. Çöp kutusuna taşınan dosyaların listede görünmesini istemiyorsanız trashed=false sorgu parametresini kullanarak çöp kutusuna taşınan dosyaları sonuçlardan kaldırı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 uygulandığı öğelerin (dosyalar/dokümanlar) gövdeleri. Desteklenen kuruluşlar default, domain, drive ve allDrives'dır. Verimlilik için allDrives yerine default veya drive'ı tercih edin.
corpus
(deprecated)

enum (Corpus)

Desteği sonlandırılmış: Sorgunun uygulandığı öğelerin (dosyalar/dokümanlar) gövdesi. 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

Desteği sonlandırıldı: Bunun yerine includeItemsFromAllDrives politikasını 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ı olabilir.
orderBy

string

Virgülle ayrılmış sıralama anahtarları listesi. Geçerli anahtarlar şunlardır:

  • createdDate: Dosyanın oluşturulma zamanı.
  • folder: Klasör kimliği. Bu alan, alfabetik sıraya göre sıralanır.
  • lastViewedByMeDate: Dosyanın kullanıcı tarafından en son görüntülenme zamanı.
  • modifiedByMeDate: Dosyanın kullanıcı tarafından en son değiştirildiği zaman.
  • modifiedDate: Dosyanın herhangi bir kullanıcı tarafından en son değiştirildiği zaman.
  • quotaBytesUsed: Dosyanın kullandığı bayt cinsinden depolama alanı kotası.
  • recency: Dosyanın tarih-saat alanlarındaki en son zaman damgası.
  • sharedWithMeDate: Dosya, kullanıcıyla paylaşıldığında (varsa).
  • starred: Kullanıcının dosyaya yıldız ekleyip eklemediği.
  • title: Dosyanın başlığı. Bu alan alfabetik sıraya göre sıralanır. Örneğin, 1, 12, 2, 22.
  • title_natural: Dosyanın başlığı. Bu alan, doğal sıralama düzeni kullanılarak sıralanır (ör. 1, 2, 12, 22).

Her anahtar varsayılan olarak artan şekilde sıralanır ancak "desc" değiştiricisiyle tersine çevrilebilir. Kullanım örneği: ?orderBy=folder,modifiedDate desc,title.

Yaklaşık bir milyon dosyası olan kullanıcılar için istenen sıralama düzeninin yoksayıldığı bir sınırlama olduğunu unutmayın.
pageToken

string

Dosyalar için sayfa jetonu.
projection
(deprecated)

enum (Projection)

Desteği sonlandı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

İstek gönderen uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği
supportsTeamDrives
(deprecated)

boolean

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

string

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

string

Yanıtın hangi ek görünüm izinlerini içereceğ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 metni

İstek metni boş olmalıdır.

Yanıt metni

Dosya listesi.

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

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

object (File)

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

string

Dosyaların sonraki sayfası için sayfa jetonu. Dosya listesinin sonuna ulaşıldıysa bu alan görünmez. Jeton herhangi bir nedenle reddedilirse atılmalı ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır.
kind

string

Bu her zaman drive#fileList.
etag

string

Listenin ETag'i.

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.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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na 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