Method: files.update

Обновляет метаданные, содержимое файла или и то, и другое.

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

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

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

    (Укажите допустимый MIME-тип, а не буквальное значение */* . Буквальное значение */* используется только для обозначения возможности загрузки любого допустимого MIME-типа. Дополнительную информацию см. в разделе «Поддерживаемые MIME-типы Google Workspace и Google Drive ».)

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

HTTP-запрос

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

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

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

Параметры
fileId

string

Идентификатор файла, который необходимо обновить.

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

Параметры
addParents

string

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

convert
(deprecated)

boolean

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

enforceSingleParent
(deprecated)

boolean

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

modifiedDateBehavior

enum ( ModifiedDateBehavior )

Определяет поведение, при котором обновляется modifiedDate . Этот параметр переопределяет setModifiedDate .

newRevision

boolean

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

ocr

boolean

Стоит ли пытаться распознавать текст с помощью OCR для файлов .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

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

uploadType

string

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

Допустимые значения:

  • media — простая загрузка . Загружайте только медиафайлы, без каких-либо метаданных.
  • multipart — Многокомпонентная загрузка . Загрузка медиафайла и его метаданных в одном запросе.
  • resumable загрузка . Загрузка файла с возможностью возобновления, с использованием серии как минимум двух запросов, причем первый запрос включает метаданные.
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

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