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 geçerli olduğu öğelerin (dosyalar/dokümanlar) gövdeleri. Desteklenen varlıklar şunlardır: "kullanıcı", "alan", "drive" ve "allDrives". Verimliliği artırmak için "allDrives" yerine "user" veya "drive" seçeneğini tercih edin. Varsayılan olarak corpora, "user" olarak ayarlanmıştır. Ancak bu, "q" parametresi aracılığıyla ayarlanan filtreye bağlı olarak değişebilir.
corpus
(deprecated)

enum (Corpus)

Desteği sonlandırıldı: Listelenecek dosyaların kaynağı. Bunun yerine "corpora"yı 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 politikasını kullanın.
orderBy

string

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

  • createdTime: Dosyanın oluşturulduğu tarih.
  • folder: Klasör kimliği. Bu alan alfabetik sıralama kullanılarak sıralanır.
  • modifiedByMeTime: Dosyanın kullanıcı tarafından son değiştirildiği zaman.
  • modifiedTime: Dosyanın herhangi bir kullanıcı tarafından son değiştirildiği tarih.
  • name: Dosyanın adıdır. Bu alan alfabetik sıralama kullanılarak sıralanır (ör. 1, 12, 2, 22).
  • name_natural: Dosyanın adıdır. 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ığı tarih (varsa).
  • starred: Kullanıcının dosyayı favorilere ekleyip eklemediğini belirtir.
  • viewedByMeTime: Dosyanın kullanıcı tarafından son görüntülendiği zaman.

Her anahtar varsayılan olarak artan düzende sıralanır ancak "desc" değiştiricisi ile tersine çevrilebilir. Örnek kullanım: ?orderBy=folder,modifiedTime desc,name.
pageSize

integer

Sayfa başına döndürülecek maksimum dosya sayısı. Dosya listesinin sonuna ulaşmadan önce bile kısmi veya boş sonuç sayfaları görülebilir.
pageToken

string

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

string

Dosya sonuçlarını filtrelemek için bir sorgu. Desteklenen söz dizimi için "Dosya ve klasör arama" kılavuzunu inceleyin.
spaces

string

Varlık kümelerinde sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler "drive" ve "appDataFolder"dır.
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 politikasını kullanın.
teamDriveId
(deprecated)

string

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

string

Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" 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,
  "incompleteSearch": boolean,
  "files": [
    {
      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. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenirse veya kaldırılırsa beklediğiniz sonuçlar farklı olabilir.
kind

string

Bu kaynağın ne tür olduğunu tanımlar. Değer: "drive#fileList" sabit dizesi.
files[]

object (File)

Dosya listesi. nextPageToken doldurulmuşsa 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/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ıtlıdı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
user Kullanıcıya ait olan veya kullanıcıyla paylaşılan dosyalar.
domain Kullanıcının alanıyla paylaşılan dosyalar.