Папка данных приложения — это специальная скрытая папка, которую ваше приложение может использовать для хранения данных, специфичных для приложения, например, файлов конфигурации. Папка данных приложения создается автоматически при попытке создать в ней файл. Используйте эту папку для хранения любых файлов, с которыми пользователь не должен взаимодействовать напрямую. Эта папка доступна только вашему приложению, и ее содержимое скрыто от пользователя и от других приложений Google Drive.
Папка с данными приложения удаляется, когда пользователь удаляет ваше приложение из своего «Моего диска». Пользователи также могут удалить папку с данными вашего приложения вручную.
Область действия папки данных приложения
Прежде чем получить доступ к папке с данными приложения, необходимо запросить доступ к неконфиденциальной области действия https://www.googleapis.com/auth/drive.appdata . Более подробную информацию об областях действия и способах запроса доступа к ним см. в разделе «Выбор областей действия API Google Drive» . Более подробную информацию о конкретных областях действия OAuth 2.0 см. в разделе «Области действия OAuth 2.0 для API Google» .
Чем папка с данными приложения отличается от папок резервного копирования Google Диска?
Папка с данными приложения отделена от папки резервных копий на вашем Google Диске.
Папка с данными приложения — это папка конфигурации, создаваемая для каждого стороннего приложения, и каждое стороннее приложение может хранить в ней данные. Доступ к ней имеет только приложение, создавшее данные в папке appDataFolder . Доступ к папке через пользовательский интерфейс Google Диска невозможен.
Папка резервного копирования Google Диска — это зарезервированная папка, в которую Google Диск записывает резервные копии устройств, и она отображается в пользовательском интерфейсе Google Диска.
Ограничения на папку с данными приложения.
При работе с папкой данных приложения действуют следующие ограничения:
Невозможно обмениваться файлами или папками внутри папки данных приложения. Попытка сделать это приводит к ошибке
notSupportedForAppDataFolderFilesсо следующим сообщением: «Метод не поддерживается для файлов внутри папки данных приложения».Перемещать файлы из папки
appDataFolderмежду различными местами хранения (пространствами) невозможно. Попытка сделать это приведет к ошибкеnotSupportedForAppDataFolderFilesсо следующим сообщением: «Метод не поддерживается для файлов в папке Application Data». Для получения дополнительной информации см. раздел «Организация файлов ».Удалять файлы или папки внутри папки данных приложения невозможно. Попытка сделать это приводит к ошибке
notSupportedForAppDataFolderFilesсо следующим сообщением: «Файлы внутри папки данных приложения нельзя удалить».
Создайте файл в папке данных приложения.
Чтобы создать файл в папке данных приложения, укажите appDataFolder в свойстве parents файла и используйте метод files.create для создания файла в папке.
Приведённый ниже пример кода демонстрирует, как вставить файл в папку с помощью клиентской библиотеки и команды curl.
Java
Python
Node.js
PHP
.СЕТЬ
локон
Запрос :
curl --request POST \
'https://content.googleapis.com/drive/v3/files' \
-H 'authorization: Bearer ACCESS_TOKEN' \
-H 'content-type: application/json' \
-H 'x-origin: https://explorer.apis.google.com' \
--data-raw '{"name": "config.json", "parents":["appDataFolder"]}'
Замените ACCESS_TOKEN на токен OAuth 2.0 вашего приложения.
Ответ :
{
"kind": "drive#file",
"id": FILE_ID,
"name": "config.json",
"mimeType": "application/json"
}
Для получения дополнительной информации о создании файлов в папках см. раздел «Создание и заполнение папок» .
Найдите файлы в папке данных приложения.
Для поиска файлов в папке данных приложения установите поле spaces в значение appDataFolder и используйте метод files.list .
Приведенный ниже пример кода демонстрирует поиск файлов в папке данных приложения с помощью клиентской библиотеки и команды curl.
Java
Python
Node.js
PHP
.СЕТЬ
локон
Запрос :
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
Замените ACCESS_TOKEN на токен OAuth 2.0 вашего приложения.
Ответ :
{
"files": [
{
"mimeType": "application/json",
"size": "256",
"id": FILE_ID,
"name": "config.json",
"modifiedTime": "2025-04-03T23:40:05.860Z"
},
{
"mimeType": "text/plain",
"size": "128",
"id": FILE_ID,
"name": "user_settings.txt",
"modifiedTime": "2025-04-02T17:52:29.020Z"
}
]
}
Загрузите файлы из папки с данными приложения.
Для загрузки файла из папки данных приложения используйте метод files.get с параметром URL alt=media чтобы получить содержимое файла в теле ответа. Для получения дополнительной информации и просмотра примеров кода перейдите по ссылке «Загрузка содержимого файла blob» .
Приведённый ниже пример кода демонстрирует, как загрузить файлы из папки данных приложения с помощью команды curl. Тело ответа будет различаться в зависимости от того, что именно было сохранено.
локон
Запрос :
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
Замените следующее:
- ACCESS_TOKEN : Токен OAuth 2.0 вашего приложения.
- FILE_ID : Идентификатор файла, который вы хотите загрузить.