Method: files.insert

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

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

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

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

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

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

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

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

HTTP-запрос

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

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

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

Параметры
convert

boolean

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

enforceSingleParent
(deprecated)

boolean

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

ocr

boolean

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

ocrLanguage

string

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

pinned

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

timedTextLanguage

string

Язык текста, отображаемого с ограничением по времени.

timedTextTrackName

string

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

uploadType

string

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

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

  • media — простая загрузка . Загружайте только медиафайлы, без каких-либо метаданных.
  • multipart — Многокомпонентная загрузка . Загрузка медиафайла и его метаданных в одном запросе.
  • resumable загрузка . Загрузка файла с возможностью возобновления, с использованием серии как минимум двух запросов, причем первый запрос включает метаданные.
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

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