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 rehberine göz atı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 (dosyalar/dokümanlar) gövdeleri. Desteklenen vücutlar: default, domain, drive ve allDrives. Verimlilik için allDrives yerine default veya drive'ü 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

Aramaya dahil edilecek ortak Drive'ın kimliği.
includeItemsFromAllDrives

boolean

Hem Drive'ım hem de ortak Drive'daki öğelerin sonuçlara dahil edilip edilmeyeceğini belirtir.
includeTeamDriveItems
(deprecated)

boolean

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

integer

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

string

Sıralama anahtarlarının virgülle ayrılmış listesi. Geçerli anahtarlar şunlardır:

  • createdDate: Dosyanın oluşturulduğu zaman.
  • folder: Klasör kimliği. Bu alan alfabetik sıralama kullanılarak sıralanır.
  • lastViewedByMeDate: Dosyanın kullanıcı tarafından son görüntülendiği 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 tarih.
  • quotaBytesUsed: Dosyanın kullandığı bayt cinsinden depolama alanı kotası.
  • recency: Dosyanın tarih-saat alanlarındaki en son zaman damgası.
  • sharedWithMeDate: Dosyanın kullanıcıyla paylaşıldığı tarih (varsa).
  • starred: Kullanıcının dosyaya yıldız ekleyip eklemediği.
  • title: Dosyanın başlığı. Bu alan alfabetik sıralamayla, yani 1, 12, 2, 22 şeklinde sıralanır.
  • 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 tuş varsayılan olarak artan düzende sıralanır ancak "azalan" ile geri alınabilir kullanabilirsiniz. Örnek kullanım: ?orderBy=folder,modifiedDate desc,title.

İstenen 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 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 izinlerinin dahil edileceğini belirtir. Yalnızca published desteklenir.
includeLabels

string

Yanıtın labelInfo bölümüne dahil edilecek etiketlerin virgülle ayrılmış kimlik 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ıysa bu değer yoktur. Jeton herhangi bir nedenle reddedilirse atılmalıdır ve sayfalandırma, sonuçların ilk sayfasından yeniden başlatılmalı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 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.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ı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.