Method: files.create

Создаёт файл. Подробнее см. в разделе Создание и управление файлами .

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

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

    (Укажите допустимый тип MIME, а не буквальное значение */* . Буквенное значение */* используется только для указания возможности загрузки любого допустимого типа MIME. Дополнительные сведения см. в разделе Типы MIME, поддерживаемые Google Workspace и Google Drive .)

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

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

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

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

HTTP-запрос

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

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

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

Параметры
enforceSingleParent
(deprecated)

boolean

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

ignoreDefaultVisibility

boolean

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

keepRevisionForever

boolean

Нужно ли устанавливать поле keepForever в новой ревизии заголовка. Это применимо только к файлам с двоичным содержимым на Google Диске. Можно хранить бесконечно не более 200 ревизий файла. Если лимит достигнут, попробуйте удалить закреплённые ревизии.

ocrLanguage

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

uploadType

string

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

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

useContentAsIndexableText

boolean

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

includePermissionsForView

string

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

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

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