Method: files.update

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

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

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

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

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

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

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
addParents

string

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

enforceSingleParent
(deprecated)

boolean

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

keepRevisionForever

boolean

Нужно ли устанавливать поле keepForever в новой ревизии заголовка. Это применимо только к файлам с двоичным содержимым на Google Диске. Можно хранить бесконечно не более 200 ревизий файла. Если лимит достигнут, попробуйте удалить закреплённые ревизии.

ocrLanguage

string

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

removeParents

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

uploadType

string

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

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

useContentAsIndexableText

boolean

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

includePermissionsForView

string

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

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

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