Method: files.update

Dosyanın meta verilerini ve/veya içeriğini günceller. Bu yöntemi çağırırken yalnızca değiştirmek istediğiniz istekteki alanları doldurun. Alanlar güncellenirken bazı alanlar (ör. modifiedDate) otomatik olarak değiştirilebilir. Bu yöntem yama semantiğini destekler.

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.

HTTP isteği

  • Medya yükleme istekleri için yükleme URI'si:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • Yalnızca meta veri istekleri için meta veri URI'si:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

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

Yol 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.
fileId

string

Güncellenecek dosyanın kimliği.

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.
addParents

string

Eklenecek üst kimliklerin virgülle ayrılmış listesi.

convert
(deprecated)

boolean

Kullanımdan kaldırıldı: Bu parametrenin işlevi yok.

enforceSingleParent
(deprecated)

boolean

Kullanımdan kaldırıldı: Birden fazla klasöre dosya ekleme özelliği artık desteklenmiyor. Bunun yerine shortcuts politikasını kullanın.

modifiedDateBehavior

enum (ModifiedDateBehavior)

modifiedDate öğesinin güncellenme davranışını belirler. Bu, setModifiedDate politikasını geçersiz kılar.

newRevision

boolean

Blob yüklemesinin yeni bir düzeltme oluşturup oluşturmayacağı. Yanlış değerine ayarlanırsa mevcut başlık düzeltmesindeki blob verileri değiştirilir. Doğru değerine ayarlanır veya ayarlanmadan bırakılırsa ana düzeltme olarak yeni bir blob oluşturulur ve sabitlenmemiş önceki düzeltmeler kısa bir süre için korunur. Sabitlenmiş düzeltmeler maksimum 200 düzeltmeye kadar ek depolama alanı kotası kullanılarak süresiz olarak saklanır. Düzeltmelerin nasıl saklandığıyla ilgili ayrıntılı bilgi için Drive Yardım Merkezi'ne bakın.

ocr

boolean

.jpg, .png, .gif veya .pdf yüklemelerinde OCR'yi deneme.

ocrLanguage

string

Ocr doğruysa kullanılacak dille ilgili ipuçları. Geçerli değerler BCP 47 kodlarıdır.

pinned

boolean

Yeni düzeltmenin sabitlenip sabitlenmeyeceğini belirler. Bir dosyada en fazla 200 sabitlenmiş düzeltme olabilir.

removeParents

string

Kaldırılacak üst kimliklerin virgülle ayrılmış listesi.

setModifiedDate

boolean

Değiştirilme tarihinin, istek gövdesinde sağlanan değeri kullanarak ayarlanıp ayarlanmayacağı. Bu alanın true değerine ayarlanması modifiedDateBehavior=fromBodyOrNow, false ise modifiedDateBehavior=now ile eşdeğerdir. Değiştirilme tarihi olarak modifiedDateBehavior=noChange tarihinde değişiklik yapılmasını önlemek için.

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.

timedTextLanguage

string

Zamanlanmış metnin dili.

timedTextTrackName

string

Zamanlanmış metin parçası adı.

updateViewedDate

boolean

Dosya başarıyla güncellendikten sonra görüntüleme tarihinin güncellenip güncellenmeyeceğini belirtir.

useContentAsIndexableText

boolean

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

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 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/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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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.