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 |
Sorgunun geçerli olduğu öğelerin gövdeleri (dosyalar/dokümanlar). Desteklenen gövdeler: |
corpus |
Kullanımdan kaldırıldı: Sorgunun geçerli olduğu öğelerin gövdesi (dosyalar/dokümanlar). Bunun yerine |
driveId |
Aranacak ortak Drive'ın kimliği. |
includeItemsFromAllDrives |
Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği. |
includeTeamDriveItems |
Kullanımdan kaldırıldı: Bunun yerine |
maxResults |
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 |
Sıralama anahtarlarının virgülle ayrılmış listesi. Geçerli anahtarlar |
pageToken |
Dosyalar için sayfa jetonu. |
projection |
Kullanımdan kaldırıldı: Bu parametrenin işlevi yok. |
q |
Dosya aramak için sorgu dizesi. |
spaces |
Sorgulanacak alanların virgülle ayrılmış listesi. |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'larım hem de ortak Drive'ları destekleyip desteklemediği. |
supportsTeamDrives |
Kullanımdan kaldırıldı: Bunun yerine |
teamDriveId |
Kullanımdan kaldırıldı: Bunun yerine |
includePermissionsForView |
Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca |
includeLabels |
Yanıtın |
İ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 ( |
Alanlar | |
---|---|
nextPageToken |
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 |
Bu her zaman |
etag |
Listenin ETag. |
selfLink |
Bu listeye geri dönme bağlantısı. |
incompleteSearch |
Arama sürecinin tamamlanma durumu. True (doğru) ise, tüm dokümanlarda arama yapılmadığı için bazı arama sonuçları eksik olabilir. Bu sorun, "allDrives" derlemesiyle birden çok sürücü arasında arama yapıldığında ortaya çıkabilir, ancak tüm dosyalarda arama yapılamadı. Bu durumda, istemcilerin "default" veya "drive" gibi farklı bir topluluk seçerek sorgularını daraltması önerilir. |
nextLink |
Dosyaların sonraki sayfasına giden bir bağlantı. |
items[] |
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. |