Method: files.create

Yeni bir dosya oluşturur.

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

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

Not: Değişmez değer */* değeri yerine geçerli bir MIME türü belirtin. */* değişmez değeri 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 edinmek 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 özelliğinde bir dosya uzantısı belirtmelidir. Örneğin, JPEG dosyası ekleme işlemi, meta veride "name": "cat.jpg" gibi bir değer belirtmelidir.

Sonraki GET istekleri, başlangıçta title özelliğinde belirtilen uzantıyla doldurulmuş salt okunur fileExtension özelliğini içerir. Bir Google Drive kullanıcısı bir dosyayı indirmek istediğinde veya dosya, senkronizasyon istemcisi üzerinden indirildiğinde, Drive başlığa göre tam dosya adı (uzantıyla) oluşturur. Uzantının bulunmadığı durumlarda 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
uploadType

string

/upload URI'sına yapılan yükleme isteğinin türü. Verileri /upload URI'si ile yüklüyorsanız bu alan gereklidir. Yalnızca meta veri dosyası oluşturuyorsanız bu alan gerekli değildir. Ayrıca bu alan, veri yüklemelerini desteklemediğinden "Bu yöntemi deneyin" widget'ında gösterilmez.

Kabul edilebilir değerler şunlardır:

  • media - Basit yükleme. Meta veri olmadan yalnızca medyayı yüklemek.
  • multipart - Çok parçalı yükleme. Tek bir istekte hem medyayı hem de meta verilerini yükleyin.
  • resumable - Devam ettirilebilir yükleme. İlk isteğin meta verileri içerdiği en az iki isteklik bir seri kullanarak dosyayı devam ettirilebilir biçimde yükleyin.
enforceSingleParent

boolean

Kullanımdan kaldırıldı. Birden fazla klasörde dosya oluşturma artık desteklenmiyor.

ignoreDefaultVisibility

boolean

Oluşturulan dosya için alanın varsayılan görünürlük ayarlarının yoksayılıp sayılmayacağı. Alan yöneticileri, yüklenen tüm dosyaları varsayılan olarak alan için görünür hale getirmeyi seçebilir. Bu parametre, istek için bu davranışı atlar. İzinler, üst klasörlerden devralınmaya devam eder.

keepRevisionForever

boolean

Yeni ana düzeltmede "keepForever" alanının ayarlanıp ayarlanmayacağını belirler. Bu, yalnızca Google Drive'da ikili program içeriğine sahip dosyalar için geçerlidir. Dosya için yalnızca 200 düzeltme tamamıyla saklanabilir. Sınıra ulaşılırsa sabitlenmiş düzeltmeleri silmeyi deneyin.

ocrLanguage

string

Resim içe aktarma sırasında OCR işleme için bir dil ipucu (ISO 639-1 kodu).

supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'larım hem de ortak Drive'ları destekleyip desteklemediği.

supportsTeamDrives
(deprecated)

boolean

Kullanımdan kaldırıldı: Bunun yerine supportsAllDrives kullanın.

useContentAsIndexableText

boolean

Yüklenen içeriğin dizine eklenebilir metin olarak kullanılıp kullanılmayacağını belirtir.

includePermissionsForView

string

Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" değeri desteklenir.

includeLabels

string

Yanıtın labelInfo bölümüne dahil edilecek etiket kimliklerinin virgülle ayrılmış 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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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ılavuzuna göz atın.