Yeni bir dosya oluşturur.
Bu yöntem, /upload URI'sini destekler ve yüklenen medyayı aşağıdaki özelliklere sahip olarak kabul eder:
- Maksimum dosya boyutu: 5.120 GB
- Kabul edilen medya MIME türleri:
*/*
Not: */*
değeri yerine geçerli bir MIME türü belirtin. */*
değişmezi yalnızca geçerli MIME türlerinin yüklenebileceğini belirtmek için kullanılır.
Dosya yükleme hakkında daha fazla bilgi için Dosya verilerini yükleme başlıklı makaleyi inceleyin.
files.create
ile kısayol oluşturan uygulamalar application/vnd.google-apps.shortcut
MIME türünü belirtmelidir.
Uygulamalar, API ile dosya eklerken name
mülkünde bir dosya uzantısı belirtmelidir. Örneğin, JPEG dosyası ekleme işlemi meta verilerde "name": "cat.jpg"
gibi bir şey belirtmelidir.
Sonraki GET
istekleri, title
mülkünde başlangıçta belirtilen uzantıyla doldurulan salt okunur fileExtension
mülkünü içerir. Bir Google Drive kullanıcısı dosya indirme isteğinde bulunduğunda veya dosya senkronizasyon istemcisi aracılığıyla indirildiğinde Drive, başlığa göre tam dosya adını (uzantıyla birlikte) oluşturur. Uzantı eksik olduğunda Drive, uzantıyı dosyanın MIME türüne göre belirlemeye çalışır.
HTTP isteği
- Medya yükleme istekleri için yükleme URI'si:
POST https://www.googleapis.com/upload/drive/v3/files
- Yalnızca meta veri istekleri için meta veri URI'si:
POST https://www.googleapis.com/drive/v3/files
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
enforceSingleParent |
Kullanımdan kaldırıldı. Birden fazla klasörde dosya oluşturma artık desteklenmiyor. |
ignoreDefaultVisibility |
Alanın, oluşturulan dosya için varsayılan görünürlük ayarlarının yoksayılıp yoksayılmayacağını belirtir. Alan yöneticileri, yüklenen tüm dosyaları varsayılan olarak alana görünür hale getirebilir. Bu parametre, istek için bu davranışı atlar. İzinler yine üst klasörlerden devralınır. |
keepRevisionForever |
Yeni başlık düzeltmesinde "keepForever" alanının ayarlanıp ayarlanmayacağı. Bu özellik yalnızca Google Drive'da ikili program içeriğine sahip dosyalar için geçerlidir. Dosya için yalnızca 200 düzeltme daima saklanabilir. Sınıra ulaştıysanız sabitlenmiş düzeltmeleri silmeyi deneyin. |
ocrLanguage |
Resim içe aktarma sırasında OCR işleme için dil ipucu (ISO 639-1 kodu). |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği. |
supportsTeamDrives |
Desteği sonlandırıldı: Bunun yerine |
uploadType |
Kabul edilen değerler şunlardır:
|
useContentAsIndexableText |
Yüklenen içeriğin dizine eklenebilir metin olarak kullanılıp kullanılmayacağı. |
includePermissionsForView |
Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" değeri desteklenir. |
includeLabels |
Yanıtın |
İstek içeriği
İstek metni, File
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılıysa yanıt metni, File
öğesinin bir örneğini içerir.
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
Bazı kapsamlar kısıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.