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 (dosyalar/dokümanlar) gövdeleri. Desteklenen kuruluşlar |
corpus |
Desteği sonlandırıldı: Sorgunun geçerli olduğu öğelerin (dosyalar/belgeler) içeriği. Bunun yerine |
driveId |
Aramaya dahil edilecek ortak Drive'ın kimliği. |
includeItemsFromAllDrives |
Hem Drive'ım hem de ortak Drive'daki öğelerin sonuçlara dahil edilip edilmeyeceğini belirtir. |
includeTeamDriveItems |
Desteği sonlandırıldı: Bunun yerine |
maxResults |
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. |
orderBy |
Sıralama anahtarlarının virgülle ayrılmış listesi. Geçerli anahtarlar şunlardır:
Her anahtar varsayılan olarak artan düzende sıralanır ancak "desc" değiştiricisi ile tersine çevrilebilir. Örnek kullanım: 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 |
Dosyalar için sayfa jetonu. |
projection |
Desteği sonlandırıldı: Bu parametrenin işlevi yoktur. |
q |
Dosyaları aramak için kullanılan sorgu dizesi. |
spaces |
Sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği. |
supportsTeamDrives |
Desteği sonlandırıldı: Bunun yerine |
teamDriveId |
Desteği sonlandırıldı: Bunun yerine |
includePermissionsForView |
Yanıta hangi ek görünümün 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ı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 |
Bu değer her zaman |
etag |
Listenin ETag'ı. |
selfLink |
Bu listeye giden bir bağlantı. |
incompleteSearch |
Arama işleminin tamamlanıp tamamlanmadığı. Bu değer doğruysa tüm dokümanlar aranmadığından bazı arama sonuçları eksik olabilir. Bu durum, "allDrives" korpusu ile birden fazla Drive'da arama yapılırken tüm korpusa ulaşılamaması durumunda ortaya çıkabilir. Bu durumda, istemcilerin "varsayılan" veya "drive" gibi farklı bir corpus seçerek sorgularını daraltmaları önerilir. |
nextLink |
Dosyaların sonraki sayfasının bağlantısı. |
items[] |
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/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ı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 | |
---|---|
DEFAULT |
Kullanıcının eriştiği öğeler. |
DOMAIN |
Kullanıcının alanıyla paylaşılan öğeler. |