Обзор файлов и папок

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

API Google Диска представляет файлы, хранящиеся на Диске, как files ресурс.

Право собственности

Диск упорядочивает файлы на основе отношения пользователя к содержимому и месту его хранения. Коллекции указываются как часть метаданных файла, чтобы показать, в какой группе файлов файл хранится на Диске. Основное различие между коллекциями «Мой диск» и общими дисками — это право собственности на файлы. Один пользователь является владельцем файлов на своем «Моем диске», тогда как группа или организация владеет файлами на общем диске.

Мой драйв
У каждого пользователя есть «корневая» папка под названием «Мой диск», которая действует как его основная иерархия и состоит из всего, что происходит от этой корневой папки. Пользователь является основным владельцем этой папки.
Общие диски
Общий диск – это организационная структура Диска, которая существует параллельно с Моим диском. Вы можете систематизировать отдельный файл на общем диске или на «Моем диске», но не на обоих сразу. Однако ярлыки Диска можно использовать для указания файлов или папок с общих дисков на Мой диск или наоборот.

Типы файлов

Диск описывает файлы по типам. В этом списке показаны все доступные типы файлов:

Блоб
Файл, содержащий текстовое или двоичное содержимое, например изображения, видео и PDF-файлы.
Папка

Контейнер, который можно использовать для организации других типов файлов на Диске. Папки — это файлы, которые содержат только метаданные и имеют тип MIME application/vnd.google-apps.folder . Дополнительные сведения см. в разделе Создание и заполнение папок .

Примечание. Один файл, хранящийся на «Моем диске», может находиться в нескольких папках. Один файл, хранящийся на общем диске, может иметь только одну родительскую папку.

Документ Google Workspace

Файл, создаваемый приложением Google Workspace, например Google Docs, Sheets или Slides. Формат типа MIME: application/vnd.google-apps.*app* , где app — это имя приложения (например, application/vnd.google-apps.spreadsheet для файла Таблиц). Список типов MIME, специфичных для Диска и Google Workspace, см. в разделе Типы MIME, поддерживаемые Google Workspace и Google Drive .

Ярлык

Файл только с метаданными, который указывает на другой файл на Диске. MIME-тип файла ярлыка — application/vnd.google-apps.shortcut . Дополнительную информацию см. в разделе Создание ярлыка для файла на Диске .

Сторонний ярлык

Файл только метаданных, который ссылается на контент, хранящийся в сторонней системе хранения. MIME-тип стороннего файла ярлыка — application/vnd.google-apps.drive-sdk . Дополнительные сведения см. в разделе Создание файла ярлыка для содержимого, хранящегося в вашем приложении .

Характеристики файла

В этом списке показаны некоторые характеристики файла Диска:

Предложение доступа
Предложение от отправителя запроса утверждающему лицу предоставить получателю доступ к объекту на Диске. Дополнительные сведения см. в разделе Список и решение ожидающих предложений о доступе .
Содержание
Бинарное или текстовое тело файла. Некоторые примеры контента, который вы можете хранить на Диске, — это изображения, видео, текст и PDF-файлы.
Идентификатор файла
Уникальный непрозрачный идентификатор для каждого файла. Идентификаторы файлов стабильны на протяжении всего срока существования файла, даже если имя файла меняется. Выражения поиска используются для поиска файлов по имени, типу, содержимому, родительскому контейнеру, владельцу или другим метаданным.
Метаданные
Данные, описывающие содержимое файла. Эти данные включают имя, тип, время создания и изменения. Некоторые поля метаданных, такие как name , не зависят от пользователя и отображаются одинаково для каждого пользователя. Другие поля, такие как capabilities и viewedByMeDate содержат значения, специфичные для пользователя. Типы файлов, такие как изображения и видео, содержат дополнительные метаданные, извлеченные из EXIF, и другие встроенные метаданные. Дополнительные сведения см. в разделе Управление метаданными файлов .
Разрешение
Предоставление доступа пользователю, группе, домену или всему миру для доступа к файлу или иерархии папок. Пользователи контролируют, кто может получить доступ к файлу, с помощью списка управления доступом (ACL), который представляет собой список разрешений для файла. Дополнительную информацию см. в разделе Общий доступ к файлам, папкам и дискам .
История изменений
Запись изменений только содержимого файла, а не метаданных файла. Дополнительные сведения о версиях см. в разделе Обзор изменений и версий .
Миниатюра
Графическое представление файла. Диск автоматически создает миниатюры для многих распространенных типов файлов. Для ярлыков и других типов файлов, которые Диск не поддерживает, вы можете предоставить миниатюру. Дополнительную информацию см. в разделе Загрузка миниатюр .

Организация файлов

API Диска организует файлы в места хранения, называемые spaces , и коллекции, называемые corpora .

Пространства

Конкретные места хранения, изолированные друг от друга. Весь контент на Диске хранится в одном из двух определенных пространств: drive и appDataFolder .

  • drive : включает все видимые пользователю файлы, созданные на Диске. PDF-файлы, документы, документы Google, ярлыки и другой контент, загружаемый пользователем, находится на drive .

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

Файлы не могут перемещаться между spaces .

Корпора

Коллекции файлов, используемые для сужения области поиска файлов и папок. Корпуса для Диска: user , domain , drive и allDrives .

  • user : включает все файлы, созданные и открытые пользователем в разделе «Мой диск», а также файлы, которыми пользователь поделился непосредственно в разделе «Доступно мне».

  • drive : включает все файлы, содержащиеся на одном общем диске, как указано в driveId .

  • domain : включает все доступные для поиска файлы, общие для домена пользователя.

  • allDrives : включает все файлы на общих дисках, участником которых является пользователь, а также все файлы в разделах «Мой диск» и «Доступно мне». Используйте корпус allDrives с осторожностью, поскольку он имеет широкую область применения и может повлиять на производительность. По возможности для повышения эффективности используйте user или drive вместо allDrives .

Файлы могут свободно перемещаться между corpora по мере смены разрешений и владельцев.

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