Method: files.insert

Yeni bir dosya ekler.

Bu yöntem, /upload URI'sini destekler ve aşağıdaki özelliklere sahip yüklenen medyaları kabul eder:

  • Maksimum dosya boyutu: 5.120 GB
  • Kabul edilen medya MIME türleri:*/*

Not: Tam */* değeri yerine geçerli bir MIME türü belirtin. Tam anlamıyla */* ifadesi yalnızca geçerli herhangi bir MIME türünün 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ısayollar oluşturan uygulamalar, application/vnd.google-apps.shortcut MIME türünü belirtmelidir.

Uygulamalar, API ile dosya eklerken title özelliğinde bir dosya uzantısı belirtmelidir. Örneğin, bir JPEG dosyası ekleme işlemi meta verilerde "title": "cat.jpg" gibi bir değer belirtmelidir.

Sonraki GET istekleri, title özelliğinde başlangıçta belirtilen uzantıyla doldurulmuş salt okunur fileExtension özelliğini içerir. Bir Google Drive kullanıcısı dosya indirme isteğinde bulunduğunda veya dosya senkronizasyon istemcisi üzerinden indirildiğinde Drive, başlığa göre tam bir dosya adı (uzantıyla birlikte) oluşturur. Uzantının eksik olduğu durumlarda Drive, dosyanın MIME türüne göre uzantıyı 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üman Düzenleyicileri biçimine dönüştürülüp dönüştürülmeyeceği.
enforceSingleParent
(deprecated)

boolean

Desteği sonlandırıldı: Dosyaların birden fazla klasörde oluşturulması artık desteklenmiyor.
ocr

boolean

.jpg, .png, .gif veya .pdf yüklemelerinde OCR'nin denenip denenmeyeceği.
ocrLanguage

string

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

boolean

Yüklenen dosyanın ana düzeltmesinin sabitlenip sabitlenmeyeceği. Bir dosyada en fazla 200 sabitlenmiş düzeltme olabilir.
supportsAllDrives

boolean

İstek gönderen uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği
supportsTeamDrives
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine supportsAllDrives politikasını kullanın.
timedTextLanguage

string

Zamanlanmış metnin dili.
timedTextTrackName

string

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

string

/upload URI'sine yapılan yükleme isteğinin türü. /upload URI'siyle veri yüklüyorsanız bu alan zorunludur. Yalnızca meta veri içeren bir dosya oluşturuyorsanız bu alan zorunlu değildir. Ayrıca, widget veri yüklemelerini desteklemediği için bu alan "Bu yöntemi deneyin" widget'ında gösterilmez.

Kabul edilen değerler şunlardır:

  • media - Basit yükleme. Yalnızca medyayı meta veri olmadan yükleyin.
  • multipart - Çok parçalı yükleme. Hem medyayı hem de meta verilerini tek bir istekte yükleyin.
  • resumable - Devam ettirilebilir yükleme. İlk istek meta verileri içerecek şekilde 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üğü. İzinler, üst klasörlerden devralınmaya devam eder. Bu parametre yalnızca convert=false olduğunda geçerlidir.
includePermissionsForView

string

Yanıtın hangi ek görünüm izinlerini içereceğini belirtir. Yalnızca published desteklenir.
includeLabels

string

Yanıtın labelInfo bölümüne dahil edilecek etiketlerin kimliklerinin virgülle ayrılmış listesi.

İstek metni

İstek metni, File öğesinin bir örneğini içerir.

Yanıt metni

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ı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ılavuzu'na bakın.