- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Попробуй это!
Обновляет метаданные и/или содержимое файла. При вызове этого метода заполняйте только те поля запроса, которые вы хотите изменить. При обновлении полей некоторые поля могут быть изменены автоматически, например 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 | Тип запроса на загрузку по URI Приемлемые значения:
|
fileId | Идентификатор файла для обновления. |
Параметры запроса
Параметры | |
---|---|
uploadType | Тип запроса на загрузку по URI Приемлемые значения:
|
addParents | Список родительских идентификаторов, разделенных запятыми, которые нужно добавить. |
convert | Устарело: этот параметр не имеет функции. |
enforceSingleParent | Устарело: добавление файлов в несколько папок больше не поддерживается. Вместо этого используйте |
modifiedDateBehavior | Определяет поведение обновления |
newRevision | Должна ли при загрузке большого двоичного объекта создаваться новая редакция. Если значение равно false, данные большого двоичного объекта в текущей версии головки заменяются. Если установлено значение true или не установлено, новый большой двоичный объект создается как головная ревизия, а предыдущие незакрепленные ревизии сохраняются в течение короткого периода времени. Закрепленные версии хранятся неопределенное время с использованием дополнительной квоты хранилища (максимум до 200 версий). Подробную информацию о том, как сохраняются версии, можно найти в Справочном центре Диска . |
ocr | Следует ли пытаться выполнить распознавание символов при загрузке файлов .jpg, .png, .gif или .pdf. |
ocrLanguage | Если ocr имеет значение true, указывает на используемый язык. Допустимыми значениями являются коды BCP 47. |
pinned | Закрепить ли новую ревизию. Файл может иметь не более 200 закрепленных редакций. |
removeParents | Список родительских идентификаторов, разделенных запятыми, которые нужно удалить. |
setModifiedDate | Устанавливать ли дату изменения, используя значение, указанное в теле запроса. Установка для этого поля значения |
supportsAllDrives | Поддерживает ли запрашивающее приложение как «Мои диски», так и общие диски. |
supportsTeamDrives | Устарело: вместо этого используйте |
timedTextLanguage | Язык синхронизированного текста. |
timedTextTrackName | Название синхронизированной текстовой дорожки. |
updateViewedDate | Следует ли обновлять дату просмотра после успешного обновления файла. |
useContentAsIndexableText | Использовать ли содержимое как индексируемый текст. |
includePermissionsForView | Указывает, какие дополнительные разрешения представления следует включить в ответ. Поддерживается только |
includeLabels | Разделенный запятыми список идентификаторов меток, которые необходимо включить в часть ответа |
Тело запроса
Тело запроса содержит экземпляр 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
Некоторые области ограничены, и для их использования требуется оценка безопасности вашего приложения. Дополнительную информацию см. в руководстве по авторизации .