Method: files.patch

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

HTTP-запрос

PATCH 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

Должна ли при загрузке большого двоичного объекта создаваться новая редакция. Если значение равно 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

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