Method: files.update

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

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

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

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

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

HTTP-запрос

  • URI загрузки для запросов на загрузку мультимедиа:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI метаданных для запросов только метаданных:
    PATCH https://www.googleapis.com/drive/v3/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

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

enforceSingleParent
(deprecated)

boolean

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

keepRevisionForever

boolean

Устанавливать ли поле «keepForever» в новой версии заголовка. Это применимо только к файлам с двоичным содержимым на Google Диске. Только 200 редакций файла могут храниться вечно. Если предел достигнут, попробуйте удалить закрепленные версии.

ocrLanguage

string

Языковая подсказка для обработки оптического распознавания символов во время импорта изображений (код ISO 639-1).

removeParents

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useContentAsIndexableText

boolean

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

includePermissionsForView

string

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

includeLabels

string

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

Тело запроса

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

Тело ответа

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

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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