Method: files.update

Bir dosyanın meta verilerini ve/veya içeriğini günceller. Bu yöntemi çağırırken yalnızca istekte değiştirmek istediğiniz alanları doldurun. Alanlar güncellenirken modifiedDate gibi bazı alanlar otomatik olarak değiştirilebilir. Bu yöntem, yama semantiklerini destekler.

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.

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
fileId

string

Güncellenecek dosyanın kimliği.

Sorgu parametreleri

Parametreler
addParents

string

Eklenecek üst kimliklerin virgülle ayrılmış listesi.
convert
(deprecated)

boolean

Desteği sonlandırıldı: Bu parametrenin işlevi yoktur.
enforceSingleParent
(deprecated)

boolean

Desteği sonlandırıldı: Birden fazla klasöre dosya ekleme artık desteklenmiyor. Bunun yerine shortcuts kullanın.
modifiedDateBehavior

enum (ModifiedDateBehavior)

modifiedDate değerinin güncellenme davranışını belirler. Bu işlem, setModifiedDate seçeneğini geçersiz kılar.
newRevision

boolean

Bir blob yüklemesinin yeni bir düzeltme oluşturup oluşturmayacağı. Yanlış ise mevcut ana düzeltmedeki blob verileri değiştirilir. Doğru ise veya ayarlanmazsa 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, ek depolama alanı kotası kullanılarak süresiz olarak saklanır. Bu düzeltmeler en fazla 200 tane olabilir. Düzeltmelerin nasıl saklandığıyla ilgili ayrıntılı bilgi için Drive Yardım Merkezi'ne göz atın.
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

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

string

Kaldırılacak üst öğe kimliklerinin virgülle ayrılmış listesi.
setModifiedDate

boolean

Değiştirilen tarihin, istek gövdesinde sağlanan değer kullanılarak ayarlanıp ayarlanmayacağı. Bu alanın true olarak ayarlanması modifiedDateBehavior=fromBodyOrNow'a, false olarak ayarlanması ise modifiedDateBehavior=now'a eşdeğerdir. Değiştirilen tarih grubunda modifiedDateBehavior=noChange değişiklik yapılmasını önlemek için.
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ı.
updateViewedDate

boolean

Dosya başarıyla güncellendikten sonra görüntüleme tarihinin güncellenip güncellenmeyeceği.
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ğı.
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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.