Method: files.create

Создает новый файл.

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

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

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

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

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

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

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

HTTP-запрос

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

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

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

Параметры
uploadType

string

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

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

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

boolean

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

ignoreDefaultVisibility

boolean

Игнорировать ли настройки видимости домена по умолчанию для созданного файла. Администраторы домена могут по умолчанию сделать все загруженные файлы видимыми для домена; этот параметр обходит это поведение для запроса. Разрешения по-прежнему наследуются от родительских папок.

keepRevisionForever

boolean

Устанавливать ли поле «keepForever» в новой версии заголовка. Это применимо только к файлам с двоичным содержимым на Google Диске. Только 200 редакций файла могут храниться вечно. Если предел достигнут, попробуйте удалить закрепленные версии.

ocrLanguage

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useContentAsIndexableText

boolean

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

includePermissionsForView

string

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

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

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