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 bkz. Dosya arama ve klasörleri rehberini ziyaret edin.
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 |
Sorgunun geçerli olduğu öğelerin (dosyalar/dokümanlar) gövdeleri. Desteklenen gövdeler "user", "domain", "drive" ve "allDrives"dır. "User"ı tercih et veya "drive" "allDrives" öğesine birçok proje verisi türü bulunur. Varsayılan olarak, derleme "user" değerine ayarlanır. Ancak bu, 'q' ile ayarlanan filtreye bağlı olarak değişebilir. parametresinden sonra bir değer girin. |
corpus |
Kullanımdan kaldırıldı: Listelenecek dosyaların kaynağı. "Corpora"yı kullan . |
driveId |
Aranacak ortak Drive'ın kimliği. |
includeItemsFromAllDrives |
Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği. |
includeTeamDriveItems |
Desteği sonlandırıldı: Bunun yerine |
orderBy |
Sıralama anahtarlarının virgülle ayrılmış listesi. Geçerli anahtarlar şunlardır: "generateTime", "folder", "modifiedByMeTime", "modifiedTime", "name", "name_natural", "quotaBytesUsed", "recency", "sharedWithMeTime", "starred" ve "viewedByMeTime". Her tuş varsayılan olarak artan düzende sıralanır ancak "azalan" ile geri alınabilir kullanabilirsiniz. Örnek kullanım: ?orderBy=folder,modifiedTime desc,name. |
pageSize |
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. |
pageToken |
Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, "nextPageToken" değerine ayarlanmalıdır. bu soruyu yanıtlar: |
q |
Dosya sonuçlarını filtreleme sorgusu. "Dosya arama ve "klasörler" kılavuzu inceleyin. |
spaces |
Şirket içinde sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler: "drive" ve "appDataKlasör". |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'ım klasörlerini 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 "yayınlandı" desteklenir. |
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,
"incompleteSearch": boolean,
"files": [
{
object ( |
Alanlar | |
---|---|
nextPageToken |
Dosyaların sonraki sayfası için sayfa jetonu. Dosya listesinin sonuna ulaşıldıysa bu dosya eksik olacaktır. Jeton herhangi bir nedenle reddedilirse silinmeli ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklediğiniz sonuçlar farklılık gösterebilir. |
kind |
Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit |
incompleteSearch |
Arama işleminin tamamlanıp tamamlanmadığı. Doğru ise, tüm dokümanlar aranmadığı için bazı arama sonuçları eksik olabilir. Bu durum, 'allDrives' ile birden fazla sürücüde arama yaparken ortaya çıkabilir ancak hiçbir derleme aranamadı. Böyle bir durumda, müşterilerin 'user' gibi farklı bir topluluk seçerek sorgularını daraltması önerilir. veya "drive". |
files[] |
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/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 gerekir. Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.
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. |