Der Ordner „App-Daten“ ist ein spezieller ausgeblendeter Ordner, in dem Ihre App anwendungsspezifische Daten wie Konfigurationsdateien speichern kann. Der Ordner „application data“ wird automatisch erstellt, wenn Sie versuchen, darin eine Datei zu erstellen. Speichern Sie in diesem Ordner alle Dateien, mit denen der Nutzer nicht direkt interagieren sollte. Auf diesen Ordner kann nur Ihre App zugreifen und sein Inhalt ist für den Nutzer und andere Google Drive-Apps ausgeblendet.
Der Ordner mit den Anwendungsdaten wird gelöscht, wenn ein Nutzer Ihre App aus „Meine Ablage“ deinstalliert. Nutzer können den Datenordner Ihrer App auch manuell löschen.
Ordner für Anwendungsdaten
Bevor Sie auf den Ordner mit Anwendungsdaten zugreifen können, müssen Sie Zugriff auf den https://www.googleapis.com/auth/drive.appdata
-Bereich anfordern, der keine sensiblen Daten enthält. Weitere Informationen zu Bereichen und dazu, wie Sie Zugriff darauf anfordern, finden Sie unter Google Drive API-Bereiche auswählen. Weitere Informationen zu bestimmten OAuth 2.0-Bereichen finden Sie unter OAuth 2.0-Bereiche für Google APIs.
Unterschiede zwischen dem Ordner „Anwendungsdaten“ und den Sicherungsordnern in Google Drive
Der Ordner mit den Anwendungsdaten ist vom Google Drive-Sicherungsordner getrennt.
Der Ordner „Application Data“ ist ein Konfigurationsordner, der für jede Drittanbieter-App erstellt wird. Jede Drittanbieter-App kann darin Daten speichern. Nur die Anwendung, die die Daten in der appDataFolder
erstellt hat, kann darauf zugreifen. Über die Drive-Benutzeroberfläche kann nicht auf den Ordner zugegriffen werden.
Der Google Drive-Sicherungsordner ist ein reservierter Ordner, in dem Google Drive Gerätesicherungen schreibt. Er ist in der Google Drive-Benutzeroberfläche sichtbar.
Einschränkungen für den Ordner „Anwendungsdaten“
Bei der Arbeit mit dem Ordner „Anwendungsdaten“ gelten die folgenden Einschränkungen:
Dateien oder Ordner im Ordner „Anwendungsdaten“ können nicht freigegeben werden. Bei einem entsprechenden Versuch wird ein
notSupportedForAppDataFolderFiles
-Fehler mit der folgenden Fehlermeldung ausgegeben: „Methode wird für Dateien im Ordner „Application Data“ nicht unterstützt“.Sie können Dateien in der
appDataFolder
nicht zwischen Speicherorten (Bereichen) verschieben. Bei einem solchen Versuch wird einnotSupportedForAppDataFolderFiles
-Fehler mit der folgenden Fehlermeldung ausgegeben: „Methode wird für Dateien im Ordner „Anwendungsdaten“ nicht unterstützt.“ Weitere Informationen finden Sie unter Dateiorganisation.Dateien oder Ordner im Ordner „Anwendungsdaten“ können nicht in den Papierkorb verschoben werden. Bei einem entsprechenden Versuch wird ein
notSupportedForAppDataFolderFiles
-Fehler mit der folgenden Fehlermeldung ausgegeben: „Dateien im Ordner ‚Anwendungsdaten‘ können nicht in den Papierkorb verschoben werden.“
Datei im Ordner „Anwendungsdaten“ erstellen
Wenn Sie eine Datei im Ordner „Anwendungsdaten“ erstellen möchten, geben Sie appDataFolder
in der Dateieigenschaft parents
an und verwenden Sie die Methode files.create
, um die Datei im Ordner zu erstellen.
Im folgenden Codebeispiel wird gezeigt, wie Sie mit einer Clientbibliothek und einem Curl-Befehl eine Datei in einen Ordner einfügen.
Request:
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"]}'
Ersetzen Sie ACCESS_TOKEN durch das OAuth 2.0-Token Ihrer App.
Antwort:
{
"kind": "drive#file",
"id": FILE_ID ,
"name": "config.json",
"mimeType": "application/json"
}
Weitere Informationen zum Erstellen von Dateien in Ordnern finden Sie unter Ordner erstellen und befüllen.
Im Ordner „Anwendungsdaten“ nach Dateien suchen
Wenn Sie im Ordner „Anwendungsdaten“ nach Dateien suchen möchten, legen Sie das Feld spaces
auf appDataFolder
fest und verwenden Sie die Methode files.list
.
Im folgenden Codebeispiel wird gezeigt, wie Sie mit einer Clientbibliothek und einem curl-Befehl nach Dateien im Ordner „application data“ suchen.
Request:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN " \
"https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
Ersetzen Sie ACCESS_TOKEN durch das OAuth 2.0-Token Ihrer App.
Antwort:
{
"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"
}
]
}
Dateien aus dem Ordner „Anwendungsdaten“ herunterladen
Wenn du eine Datei aus dem Ordner mit den Anwendungsdaten herunterladen möchtest, verwende die Methode files.get
mit dem URL-Parameter alt=media
, um den Dateiinhalt im Antworttext abzurufen. Weitere Informationen und Codebeispiele finden Sie unter Inhalt einer Blob-Datei herunterladen.
Im folgenden Codebeispiel wird gezeigt, wie Sie Dateien im Ordner „application data“ mit einem Curl-Befehl herunterladen. Der Antworttext hängt davon ab, was gespeichert wird.
Request:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN " \
"https://www.googleapis.com/drive/v3/files/FILE_ID ?alt=media"
Ersetzen Sie Folgendes:
- ACCESS_TOKEN: Das OAuth 2.0-Token Ihrer App.
- FILE_ID: Die ID der Datei, die Sie herunterladen möchten.