Чтобы создать файл, не содержащий метаданных или содержимого, используйте метод files.create
без параметров. Файлу присваивается kind
drive.file
, id
, name
«Без названия» и mimeType
— application/octet-stream
. uploadType
помечен как обязательный, но по умолчанию используется media
, поэтому вам не обязательно его указывать.
Дополнительную информацию об ограничениях файлов на Диске см. в разделе Ограничения на файлы и папки .
Создание файлов только с метаданными
Файлы только с метаданными не содержат содержимого. Метаданные — это данные (например, name
, mimeType
и createdTime
), описывающие файл. Такие поля, как name
, не зависят от пользователя и отображаются одинаково для каждого пользователя, тогда как такие поля, как viewedByMeTime
содержат значения, специфичные для пользователя.
Одним из примеров файла, содержащего только метаданные, является папка с типом MIME application/vnd.google-apps.folder
. Дополнительные сведения см. в разделе Создание и заполнение папок . Другой пример — ярлык, указывающий на другой файл на Диске с MIME-типом application/vnd.google-apps.shortcut
. Дополнительную информацию см. в разделе Создание ярлыка для файла на Диске .
Загрузить миниатюры
Диск автоматически создает миниатюры для многих распространенных типов файлов, таких как Документы Google, Таблицы и Слайды. Миниатюры помогают пользователю лучше идентифицировать файлы на Диске.
Для типов файлов, для которых Диск не может создать стандартную миниатюру, вы можете предоставить миниатюру, созданную вашим приложением. Во время создания или обновления файла загрузите миниатюру, задав поле contentHints.thumbnail
в ресурсе files
.
Конкретно:
- Задайте в поле
contentHints.thumbnail.image
URL-адрес и безопасное изображение в кодировке Base64 (см. раздел 5 RFC 4648 ). - Задайте для поля
contentHints.thumbnail.mimeType
соответствующий тип MIME для миниатюры.
Если Диск может создать миниатюру из файла, он использует автоматически созданную и игнорирует все, что вы могли загрузить. Если он не может создать миниатюру, он использует тот, который вы предоставляете.
Миниатюры должны соответствовать следующим правилам:
- Можно загружать в форматах PNG, GIF или JPG.
- Рекомендуемая ширина — 1600 пикселей.
- Минимальная ширина — 220 пикселей.
- Максимальный размер файла — 2 МБ.
- Они должны обновляться вашим приложением при каждом сохранении.
Для получения дополнительной информации см. ресурс files
.
похожие темы
Вот несколько следующих шагов, которые вы можете попробовать:
Чтобы загрузить данные файла при его создании или обновлении, см. раздел Загрузка данных файла .
Чтобы создать файл в определенной папке, см. раздел Создание файла в определенной папке .