Folder danych aplikacji to specjalny ukryty folder, w którym aplikacja może przechowywać dane specyficzne dla niej, np. pliki konfiguracyjne. Folder danych aplikacji jest tworzony automatycznie, gdy próbujesz utworzyć w nim plik. Użyj tego folderu do przechowywania plików, z którymi użytkownik nie powinien wchodzić w bezpośrednią interakcję. Ten folder jest dostępny tylko dla Twojej aplikacji, a jego zawartość jest ukryta przed użytkownikiem i innymi aplikacjami Dysku Google.
Folder danych aplikacji jest usuwany, gdy użytkownik odinstaluje aplikację z Mój dysk. Użytkownicy mogą też ręcznie usunąć folder danych aplikacji.
Zakres folderu danych aplikacji
Zanim uzyskasz dostęp do folderu danych aplikacji, musisz poprosić o dostęp do zakresu https://www.googleapis.com/auth/drive.appdata
, który nie zawiera danych wrażliwych. Więcej informacji o zakresach i sposobie uzyskiwania do nich dostępu znajdziesz w artykule Wybieranie zakresów interfejsu Google Drive API. Więcej informacji o poszczególnych zakresach OAuth 2.0 znajdziesz w artykule Zakresy OAuth 2.0 dla interfejsów API Google.
Czym folder danych aplikacji różni się od folderów kopii zapasowych na Dysku
Folder danych aplikacji jest oddzielony od folderu kopii zapasowej Dysku.
Folder danych aplikacji to folder konfiguracji tworzony dla każdej aplikacji innej firmy. Każda aplikacja innej firmy może w nim przechowywać dane. Dostęp do danych w appDataFolder
ma tylko aplikacja, która je utworzyła. Do folderu nie można uzyskać dostępu za pomocą interfejsu Dysku.
Folder kopii zapasowej Dysku to folder zarezerwowany, w którym Dysk zapisuje kopie zapasowe danych urządzenia. Jest on widoczny w interfejsie Dysku.
Ograniczenia dotyczące folderu danych aplikacji
Podczas pracy z folderem danych aplikacji obowiązują te ograniczenia:
Nie możesz udostępniać plików ani folderów w folderze danych aplikacji. Próba wykonania tej czynności powoduje wygenerowanie błędu
notSupportedForAppDataFolderFiles
z tym komunikatem: „Metoda nie jest obsługiwana w przypadku plików w folderze Dane aplikacji”.Nie możesz przenosić plików w
appDataFolder
między lokalizacjami pamięci (przestrzeniami). Próba wykonania tej czynności spowoduje wygenerowanie błędunotSupportedForAppDataFolderFiles
z tym komunikatem: „Metoda nie jest obsługiwana w przypadku plików w folderze danych aplikacji”. Więcej informacji znajdziesz w sekcji Organizacja plików.Nie możesz przenosić plików ani folderów w folderze danych aplikacji do kosza. Próba wykonania tej czynności spowoduje wygenerowanie
notSupportedForAppDataFolderFiles
błędu z tym komunikatem: „Nie można przenieść do kosza plików z folderu Dane aplikacji”.
Tworzenie pliku w folderze danych aplikacji
Aby utworzyć plik w folderze danych aplikacji, w właściwości appDataFolder
pliku określ parents
i użyj metody files.create
, aby utworzyć plik w folderze.
Poniższy przykładowy kod pokazuje, jak wstawić plik do folderu za pomocą biblioteki klienta i polecenia curl.
Java
Python
Node.js
PHP
.NET
curl
Żądanie:
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"]}'
Zastąp ACCESS_TOKEN tokenem OAuth 2.0 aplikacji.
Odpowiedź:
{ "kind": "drive#file", "id": FILE_ID, "name": "config.json", "mimeType": "application/json" }
Więcej informacji o tworzeniu plików w folderach znajdziesz w artykule Tworzenie i wypełnianie folderów.
Wyszukiwanie plików w folderze danych aplikacji
Aby wyszukać pliki w folderze danych aplikacji, ustaw pole spaces
na appDataFolder
i użyj metody files.list
.
Poniższy przykładowy kod pokazuje, jak wyszukiwać pliki w folderze danych aplikacji za pomocą biblioteki klienta i polecenia curl.
Java
Python
Node.js
PHP
.NET
curl
Żądanie:
curl \ -X GET \ -H "Authorization: Bearer ACCESS_TOKEN" \ "https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
Zastąp ACCESS_TOKEN tokenem OAuth 2.0 aplikacji.
Odpowiedź:
{ "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" } ] }
Pobieranie plików z folderu danych aplikacji
Aby pobrać plik z folderu danych aplikacji, użyj metody files.get
z parametrem adresu URL alt=media
, aby pobrać zawartość pliku w treści odpowiedzi. Więcej informacji i przykłady kodu znajdziesz w artykule Pobieranie zawartości pliku binarnego.
Poniższy przykładowy kod pokazuje, jak pobrać pliki z folderu danych aplikacji za pomocą polecenia curl. Treść odpowiedzi będzie się różnić w zależności od tego, co zostało zapisane.
curl
Żądanie:
curl \ -X GET \ -H "Authorization: Bearer ACCESS_TOKEN" \ "https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
Zastąp następujące elementy:
- ACCESS_TOKEN: token OAuth 2.0 aplikacji.
- FILE_ID: Identyfikator pliku, który chcesz pobrać.