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/v3/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 gövdeler "user", "domain", "drive" ve "allDrives"dır. Verimlilik için "allDrives" yerine "user" veya "drive"ı tercih edin. Varsayılan olarak, korpuslar "kullanıcı" olarak ayarlanır. Ancak bu, "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"yı 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.
orderBy

string

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

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

Her anahtar varsayılan olarak artan şekilde sıralanır ancak "desc" değiştiricisiyle tersine çevrilebilir. Kullanım örneği: ?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 veya boş sonuç sayfaları olabilir.
pageToken

string

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

string

Dosya sonuçlarını filtrelemek için kullanılan sorgu. Desteklenen söz dizimi için "Dosya ve klasör arama" rehberine bakın.
spaces

string

Korpuslar içinde sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler "drive" ve "appDataFolder"dır.
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 "yayınlandı" 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

Dosya listesi.

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

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

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. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklenen sonuçlarınız farklı olabilir.
kind

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: Sabit dize "drive#fileList".

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

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