Method: files.update

Обновляет метаданные и/или содержимое файла. При вызове этого метода заполняйте только те поля запроса, которые вы хотите изменить. При обновлении полей некоторые поля могут быть изменены автоматически, например modifiedDate . Этот метод поддерживает семантику исправлений.

Этот метод поддерживает URI /upload и принимает загруженные медиафайлы со следующими характеристиками:

  • Максимальный размер файла: 5120 ГБ.
  • Допустимые типы MIME мультимедиа: */*

Примечание. Укажите действительный тип MIME, а не буквальное значение */* . Литерал */* используется только для указания того, что можно загрузить любой допустимый тип MIME.

Дополнительную информацию о загрузке файлов см. в разделе Загрузка данных файла .

HTTP-запрос

  • URI загрузки для запросов на загрузку мультимедиа:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI метаданных для запросов только метаданных:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
uploadType

string

Тип запроса на загрузку по URI /upload . Если вы загружаете данные с помощью URI /upload , это поле является обязательным. Если вы создаете файл только с метаданными, это поле не является обязательным. Кроме того, это поле не отображается в виджете «Попробуйте этот метод», поскольку виджет не поддерживает загрузку данных.

Приемлемые значения:

  • mediaПростая загрузка . Загружайте только медиафайлы без каких-либо метаданных.
  • multipartмногочастная загрузка . Загрузите как медиафайл, так и его метаданные одним запросом.
  • resumableВозобновляемая загрузка . Загрузите файл возобновляемым способом, используя серию как минимум из двух запросов, причем первый запрос включает метаданные.
fileId

string

Идентификатор файла для обновления.

Параметры запроса

Параметры
uploadType

string

Тип запроса на загрузку по URI /upload . Если вы загружаете данные с помощью URI /upload , это поле является обязательным. Если вы создаете файл только с метаданными, это поле не является обязательным. Кроме того, это поле не отображается в виджете «Попробуйте этот метод», поскольку виджет не поддерживает загрузку данных.

Приемлемые значения:

  • mediaПростая загрузка . Загружайте только медиафайлы без каких-либо метаданных.
  • multipartмногочастная загрузка . Загрузите как медиафайл, так и его метаданные одним запросом.
  • resumableВозобновляемая загрузка . Загрузите файл возобновляемым способом, используя серию как минимум из двух запросов, причем первый запрос включает метаданные.
addParents

string

Список родительских идентификаторов, разделенных запятыми, которые нужно добавить.

convert
(deprecated)

boolean

Устарело: этот параметр не имеет функции.

enforceSingleParent
(deprecated)

boolean

Устарело: добавление файлов в несколько папок больше не поддерживается. Вместо этого используйте shortcuts .

modifiedDateBehavior

enum ( ModifiedDateBehavior )

Определяет поведение обновления modifiedDate . Это переопределяет setModifiedDate .

newRevision

boolean

Должна ли при загрузке большого двоичного объекта создаваться новая редакция. Если значение равно false, данные большого двоичного объекта в текущей версии головки заменяются. Если установлено значение true или не установлено, новый большой двоичный объект создается как головная ревизия, а предыдущие незакрепленные ревизии сохраняются в течение короткого периода времени. Закрепленные версии хранятся неопределенное время с использованием дополнительной квоты хранилища (максимум до 200 версий). Подробную информацию о том, как сохраняются версии, можно найти в Справочном центре Диска .

ocr

boolean

Следует ли пытаться выполнить распознавание символов при загрузке файлов .jpg, .png, .gif или .pdf.

ocrLanguage

string

Если ocr имеет значение true, указывает на используемый язык. Допустимыми значениями являются коды BCP 47.

pinned

boolean

Закрепить ли новую ревизию. Файл может иметь не более 200 закрепленных редакций.

removeParents

string

Список родительских идентификаторов, разделенных запятыми, которые нужно удалить.

setModifiedDate

boolean

Устанавливать ли дату изменения, используя значение, указанное в теле запроса. Установка для этого поля значения true эквивалентно modifiedDateBehavior=fromBodyOrNow , а false эквивалентно modifiedDateBehavior=now . Чтобы предотвратить любые изменения даты изменения, установите modifiedDateBehavior=noChange .

supportsAllDrives

boolean

Поддерживает ли запрашивающее приложение как «Мои диски», так и общие диски.

supportsTeamDrives
(deprecated)

boolean

Устарело: вместо этого используйте supportsAllDrives .

timedTextLanguage

string

Язык синхронизированного текста.

timedTextTrackName

string

Название синхронизированной текстовой дорожки.

updateViewedDate

boolean

Следует ли обновлять дату просмотра после успешного обновления файла.

useContentAsIndexableText

boolean

Использовать ли содержимое как индексируемый текст.

includePermissionsForView

string

Указывает, какие дополнительные разрешения представления следует включить в ответ. Поддерживается только published .

includeLabels

string

Разделенный запятыми список идентификаторов меток, которые необходимо включить в часть ответа labelInfo .

Тело запроса

Тело запроса содержит экземпляр File .

Тело ответа

В случае успеха тело ответа содержит экземпляр File .

Области авторизации

Требуется одна из следующих областей OAuth:

  • 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

Некоторые области ограничены, и для их использования требуется оценка безопасности вашего приложения. Дополнительную информацию см. в руководстве по авторизации .