Создание файлов и управление ими

В этом руководстве объясняется, как создавать файлы на Google Диске и управлять ими.

Создать файл

Чтобы создать на Диске файл, не содержащий метаданных или контента, используйте метод 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 . Дополнительную информацию см. в разделе Создание ярлыка для файла на Диске .

Управление миниатюрами изображений

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

Копирование существующего файла

Чтобы скопировать файл и применить все запрошенные обновления, используйте метод files.copy . Чтобы найти fileId для копирования, используйте метод files.list .

Обратите внимание, что для авторизации вызова вам необходимо использовать соответствующую область Drive API . Дополнительную информацию об областях действия Диска см. в разделе Выбор областей действия API Google Диска .

Ограничения и соображения

Готовясь к копированию файлов, обратите внимание на следующие ограничения и соображения:

  • Разрешения :

    • Ограничение файла copyRequiresWriterPermission определяет, кто может копировать файл. Дополнительную информацию см. в разделе Запретить пользователям загружать, распечатывать или копировать ваш файл .
    • Поле capabilities/canCopy ресурса files определяет, может ли пользователь скопировать файл. Для получения дополнительной информации см. Возможности .
    • Пользователь, создавший копию, является владельцем скопированного файла. Никакие другие параметры общего доступа из исходного файла не реплицируются. Если копия создается в общей папке, она наследует разрешения этой папки.
    • Владелец скопированного файла может измениться, и копия может не унаследовать настройки общего доступа исходного файла. Возможно, эти настройки потребуется сбросить.

  • Управление файлами :

    • Некоторые файлы, например сторонние ярлыки , невозможно скопировать.
    • Вы можете скопировать файл только в одну родительскую папку. Указание нескольких родителей не поддерживается. Если поле parents не указано, файл наследует всех обнаруживаемых родителей из исходного файла.
    • Несмотря на то, что папка представляет собой тип файла, вы не можете скопировать ее. Вместо этого создайте папку назначения и установите поле parents существующих файлов в папку назначения. Затем вы можете удалить исходную исходную папку.
    • Если не указано новое имя файла, метод files.copy создает файл с тем же именем, что и оригинал.
    • Чрезмерное использование файла files.copy может привести к превышению ограничений квоты Drive API. Дополнительную информацию см. в разделе Ограничения использования .

Вот несколько следующих шагов, которые вы можете попробовать: