Method: files.insert

Yeni bir dosya ekler.

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.insert ile kısayol oluşturan uygulamalar application/vnd.google-apps.shortcut MIME türünü belirtmelidir.

Uygulamalar, API ile dosya eklerken title mülkünde bir dosya uzantısı belirtmelidir. Örneğin, JPEG dosyası ekleme işlemi meta verilerde "title": "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/v2/files
  • Yalnızca meta veri istekleri için meta veri URI'si:
    POST https://www.googleapis.com/drive/v2/files

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
convert

boolean

Bu dosyanın ilgili Dokümanlar Düzenleyicisi biçimine dönüştürülüp dönüştürülmeyeceği.
enforceSingleParent
(deprecated)

boolean

Desteği sonlandırıldı: Birden fazla klasörde dosya oluşturma artık desteklenmiyor.
ocr

boolean

.jpg, .png, .gif veya .pdf yüklemelerinde OCR'nin çalışıp çalışmayacağı.
ocrLanguage

string

ocr doğruysa kullanılacak dile dair ipuçları verir. Geçerli değerler BCP 47 kodlarıdır.
pinned

boolean

Yüklenen dosyanın ilk düzeltmesinin sabitlenip sabitlenmeyeceği. Bir dosyada en fazla 200 sabitlenmiş düzeltme olabilir.
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 kullanın.
timedTextLanguage

string

Zamanlanmış metnin dili.
timedTextTrackName

string

Zamanlanmış altyazı parçasının adı.
uploadType

string

/upload URI'sine gönderilen yükleme isteği türü. /upload URI ile veri yüklüyorsanız bu alan zorunludur. Yalnızca meta veri içeren bir dosya oluşturuyorsanız bu alan gerekli değildir. Ayrıca, bu alan "Bu yöntemi deneyin" widget'ında gösterilmez. Bunun nedeni, widget'ın veri yüklemelerini desteklememesidir.

Kabul edilen değerler şunlardır:

  • media - Basit yükleme. Yalnızca meta veri olmadan medyayı yükleyin.
  • multipart: Çok parçalı yükleme. Hem medyayı hem de meta verilerini tek bir istekle yükleyin.
  • resumable: Devam ettirilebilir yükleme. İlk isteğin meta verileri içerdiği en az iki istek dizisi kullanarak dosyayı devam ettirilebilir şekilde yükleyin.
useContentAsIndexableText

boolean

İçeriğin dizine eklenebilir metin olarak kullanılıp kullanılmayacağı.
visibility

enum (Visibility)

Yeni dosyanın görünürlüğü. Bu parametre yalnızca convert=false olduğunda geçerlidir.
includePermissionsForView

string

Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca published 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, 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/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

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.