Method: files.update

Bir dosyanın meta verilerini, içeriğini veya her ikisini de günceller.

Bu yöntemi çağırırken istekte yalnızca değiştirmek istediğiniz alanları doldurun. Alanlar güncellenirken bazı alanlar otomatik olarak değiştirilebilir (ör. modifiedDate). Bu yöntem, yama semantiğini destekler.

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: */*

    (Tam */* değeri yerine geçerli bir MIME türü belirtin. Tam anlamıyla */*, yalnızca geçerli herhangi bir MIME türünün yüklenebileceğini belirtmek için kullanılır. Daha fazla bilgi için Google Workspace ve Google Drive'ın desteklenen MIME türleri başlıklı makaleyi inceleyin.

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ı: Dosyaları birden fazla klasöre ekleme artık desteklenmiyor. Bunun yerine shortcuts politikasını kullanın.
modifiedDateBehavior

enum (ModifiedDateBehavior)

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

boolean

Blob yüklemesinin yeni bir düzeltme oluşturup oluşturmayacağı. Yanlışsa geçerli ana revizyondaki blob verileri değiştirilir. Doğruysa veya ayarlanmamışsa yeni bir blob, ana düzeltme olarak oluşturulur ve önceki sabitlenmemiş düzeltmeler kısa bir süre korunur. Sabitlenen düzeltmeler, ek depolama alanı kotası kullanılarak en fazla 200 düzeltme olacak şekilde süresiz olarak saklanır. Düzeltmelerin nasıl saklandığı hakkında 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 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

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ştirilme tarihinin, istek gövdesinde sağlanan değer kullanılarak ayarlanıp ayarlanmayacağı. Bu alanı true olarak ayarlamak modifiedDateBehavior=fromBodyOrNow ile, false olarak ayarlamak ise modifiedDateBehavior=now ile aynıdır. Değiştirilme tarihi ayarında modifiedDateBehavior=noChange değişiklik yapılmasını önlemek için.
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ı.
updateViewedDate

boolean

Dosya başarıyla güncellendikten sonra görüntüleme tarihinin güncellenip güncellenmeyeceği.
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ğı.
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
  • 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ılavuzu'na bakın.