Папки — это файлы, содержащие только метаданные и используемые для организации файлов в Google Диске. Они обладают следующими свойствами:
- Папка — это файл с MIME-типом
application/vnd.google-apps.folder, не имеющий расширения. - Псевдоним
rootможно использовать для ссылки на корневую папку в любом месте, где указан идентификатор файла.
Для получения дополнительной информации об ограничениях на папки Google Диска см. раздел «Ограничения на файлы и папки» .
В этом руководстве объясняется, как выполнять некоторые основные задачи, связанные с папками.
Создайте папку
Для создания папки используйте метод files.create() с mimeType application/vnd.google-apps.folder и name . Следующий пример кода демонстрирует создание папки с помощью клиентской библиотеки:
Java
Python
Node.js
PHP
.СЕТЬ
Создать файл в определенной папке
Для создания файла в определенной папке используйте метод files.create() и укажите идентификатор папки в свойстве parents файла.
Свойство parents содержит идентификатор родительской папки, в которой находится файл. Свойство parents можно использовать при создании файлов в папке верхнего уровня или в любой другой папке.
У файла может быть только одна родительская папка. Указание нескольких родительских папок не поддерживается. Если поле parents папки" не указано, файл помещается непосредственно в папку "Мой диск" пользователя.
Приведённый ниже пример кода демонстрирует, как создать файл в определённой папке с помощью клиентской библиотеки:
Java
Python
Node.js
PHP
.СЕТЬ
Перемещение файлов между папками
Для перемещения файлов необходимо обновить идентификатор parents свойства.
Для добавления или удаления родительских файлов для уже существующего файла используйте метод files.update() с параметрами запроса addParents или removeParents .
У файла может быть только одна родительская папка. Указание нескольких родительских папок не поддерживается.
Приведённый ниже пример кода демонстрирует, как перемещать файл между папками с помощью клиентской библиотеки:
Java
Python
Node.js
PHP
.СЕТЬ
Ограничения на количество файлов и папок
Файлы и папки на Google Диске имеют определенные ограничения по объему хранения.
Ограничение на количество товаров для пользователя
Каждый пользователь может иметь до 500 миллионов элементов, созданных с помощью этой учетной записи. После достижения лимита пользователь больше не сможет создавать или загружать элементы в Google Диск. Он по-прежнему сможет просматривать и редактировать существующие элементы. Чтобы снова создавать файлы, пользователям необходимо навсегда удалить элементы или использовать другую учетную запись. Для получения дополнительной информации см. раздел «Корзина или удаление файлов и папок» .
К объектам, учитываемым в этом лимите, относятся:
- Элементы, созданные или загруженные пользователем в Google Диск.
- Элементы, созданные пользователем, но теперь принадлежащие другому лицу.
- Предметы в мусорном ведре
- Ярлыки
- Сопутствующие ярлыки
К объектам, не учитываемым в этом лимите, относятся:
- Безвозвратно удаленные элементы
- Элементы, которыми поделились с пользователем, но которые принадлежат другому лицу.
- Предметы, принадлежащие пользователю, но созданные кем-то другим.
Попытки добавить более 500 миллионов элементов приводят к ошибке HTTP с кодом состояния activeItemCreationLimitExceeded .
Обратите внимание, что служебные учетные записи не могут владеть файлами. Вместо этого они должны загружать файлы и папки на общие диски или использовать OAuth 2.0 для загрузки элементов от имени пользователя.
Ограничение на количество элементов в папке
Каждая папка в личном кабинете пользователя «Мой диск» имеет ограничение в 500 000 элементов. Это ограничение не распространяется на корневую папку «Моего диска». В это ограничение включаются следующие элементы:
- Папки
- Файлы. Все типы файлов, независимо от владельца файла.
- Ярлыки. Считается одним элементом в папке, даже если элемент, на который он указывает, находится за пределами этой папки. Для получения дополнительной информации см. раздел «Создание ярлыка для файла в Google Диске» .
- Ярлыки сторонних разработчиков. Считаются одним элементом в папке, даже если элемент, на который они указывают, находится за пределами этой папки. Для получения дополнительной информации см. раздел «Создание файла ярлыка для содержимого, хранящегося в вашем приложении» .
Для получения дополнительной информации об ограничениях на количество папок см. раздел «Ограничения на количество папок в Google Диск» .
Ограничение глубины папки
В папке «Мой диск» пользователя не может быть более 100 уровней вложенных папок. Это означает, что дочерняя папка не может находиться внутри папки, вложенность которой превышает 99 уровней. Это ограничение распространяется только на дочерние папки. Дочерние файлы с MIME-типом, отличным от application/vnd.google-apps.folder не подпадают под это ограничение.
Например, на следующей диаграмме новая папка может быть вложена в папку номер 99, но не в папку номер 100. Однако папка номер 100 может хранить файлы, как и любая другая папка Google Диска:
Попытки добавить более 100 уровней папок приводят к ошибке HTTP с кодом состояния myDriveHierarchyDepthLimitExceeded .
Связанные темы
- Создание и управление файлами
- Управление метаданными файлов
- Ограничения на количество файлов и папок на общих дисках