Файлы & обзор папок

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

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

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

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

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

Типы файлов

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

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

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

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

Ярлык

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

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

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

Документ Google Workspace

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

Примечание. Вы не можете загружать или скачивать папки, ярлыки, сторонние ярлыки и документы Google Workspace на Диск или с него. Однако, если они используют совместимые форматы, вы можете загружать или экспортировать документы Google Workspace. Например, вы можете создать документ Google при импорте PDF-файла. Аналогичным образом вы можете экспортировать презентацию Google Slides как файл Microsoft PowerPoint.

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

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

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

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

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

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

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

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

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

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

Корпора

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

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

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

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

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

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

Следующие шаги

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