Method: files.insert

Вставляет новый файл.

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

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

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

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

Приложения, создающие ярлыки с помощью files.insert , должны указывать тип MIME application/vnd.google-apps.shortcut .

Приложения должны указывать расширение файла в свойстве title при вставке файлов с помощью API. Например, операция по вставке файла JPEG должна указывать в метаданных что-то вроде "title": "cat.jpg" .

Последующие запросы GET включают доступное только для чтения свойство fileExtension , заполненное расширением, первоначально указанным в свойстве title . Когда пользователь Google Диска запрашивает загрузку файла или когда файл загружается через клиент синхронизации, Диск создает полное имя файла (с расширением) на основе заголовка. В случаях, когда расширение отсутствует, Диск пытается определить расширение на основе MIME-типа файла.

HTTP-запрос

  • URI загрузки для запросов на загрузку мультимедиа:
    POST https://www.googleapis.com/upload/drive/v2/files
  • URI метаданных для запросов только метаданных:
    POST https://www.googleapis.com/drive/v2/files

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

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

Параметры
uploadType

string

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

Приемлемые значения:

  • media — Простая загрузка . Загружайте только медиафайлы без каких-либо метаданных.
  • multipart — многочастная загрузка . Загрузите как медиафайл, так и его метаданные одним запросом.
  • resumable — Возобновляемая загрузка . Загрузите файл возобновляемым способом, используя серию как минимум из двух запросов, причем первый запрос включает метаданные.
convert

boolean

Следует ли конвертировать этот файл в соответствующий формат редакторов документов.

enforceSingleParent
(deprecated)

boolean

Устарело: создание файлов в нескольких папках больше не поддерживается.

ocr

boolean

Следует ли пытаться выполнить распознавание символов при загрузке файлов .jpg, .png, .gif или .pdf.

ocrLanguage

string

Если ocr имеет значение true, указывает на используемый язык. Допустимыми значениями являются коды BCP 47.

pinned

boolean

Закреплять ли головную ревизию загруженного файла. Файл может иметь не более 200 закрепленных редакций.

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

timedTextLanguage

string

Язык синхронизированного текста.

timedTextTrackName

string

Название синхронизированной текстовой дорожки.

useContentAsIndexableText

boolean

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

visibility

enum ( Visibility )

Видимость нового файла. Этот параметр имеет значение только в том случае, если Convert=false.

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

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