Der Anwendungsdatenordner ist ein spezieller verborgener Ordner, in dem Ihre App anwendungsspezifische Daten wie Konfigurationsdateien speichern kann. Der Ordner für Anwendungsdaten wird automatisch erstellt, wenn Sie versuchen, darin eine Datei zu erstellen. In diesem Ordner können Sie alle Dateien speichern, mit denen der Nutzer nicht direkt interagieren soll. Auf diesen Ordner kann nur Ihre App zugreifen. Die Inhalte sind für den Nutzer und für andere Google Drive-Apps verborgen.
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.
Umfang des Ordners für Anwendungsdaten
Bevor Sie auf den Ordner mit Anwendungsdaten zugreifen können, müssen Sie Zugriff auf den nicht sensiblen Bereich https://www.googleapis.com/auth/drive.appdata
anfordern. Weitere Informationen zu Bereichen und zum Anfordern des Zugriffs auf sie 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 für Anwendungsdaten und den Ordnern für Drive-Sicherungen
Der Ordner für Anwendungsdaten ist von Ihrem Drive-Sicherungsordner getrennt.
Der Ordner für Anwendungsdaten ist ein Konfigurationsordner, der für jede Drittanbieter-App erstellt wird. Jede Drittanbieter-App kann Daten darin speichern. Nur die Anwendung, mit der die Daten in appDataFolder
erstellt wurden, kann darauf zugreifen. Auf den Ordner kann über die Google Drive-Benutzeroberfläche nicht zugegriffen werden.
Der Drive-Sicherungsordner ist ein reservierter Ordner, in den Drive Gerätesicherungen schreibt. Er ist in der Drive-Benutzeroberfläche sichtbar.
Einschränkungen für den Anwendungsdatenordner
Bei der Arbeit mit dem Ordner für Anwendungsdaten gelten die folgenden Einschränkungen:
Sie können keine Dateien oder Ordner im Ordner für Anwendungsdaten freigeben. Bei einem entsprechenden Versuch wird ein
notSupportedForAppDataFolderFiles
-Fehler mit der folgenden Fehlermeldung ausgegeben: „Method not supported for files within the Application Data folder.“Dateien im
appDataFolder
können nicht zwischen Speicherorten (Bereichen) verschoben werden. Bei einem entsprechenden Versuch wird einnotSupportedForAppDataFolderFiles
-Fehler mit der folgenden Fehlermeldung ausgegeben: „Method not supported for files within the Application Data folder.“ (Die Methode wird für Dateien im Ordner „Anwendungsdaten“ nicht unterstützt.) Weitere Informationen finden Sie unter Dateiorganisation.Sie können keine Dateien oder Ordner im Anwendungsdatenordner in den Papierkorb verschieben. 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 Anwendungsdatenordner erstellen
Wenn Sie eine Datei im Ordner für Anwendungsdaten erstellen möchten, geben Sie appDataFolder
in der Eigenschaft parents
der Datei an und verwenden Sie die Methode files.create
, um die Datei im Ordner zu erstellen.
Das folgende Codebeispiel zeigt, wie Sie eine Datei in einen Ordner einfügen. Dazu wird eine Clientbibliothek und ein curl-Befehl verwendet.
Java
Python
Node.js
PHP
.NET
curl
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 mit Inhalten füllen.
Im Anwendungsdatenordner nach Dateien suchen
Wenn Sie im Ordner mit den Anwendungsdaten nach Dateien suchen möchten, legen Sie das Feld spaces
auf appDataFolder
fest und verwenden Sie die Methode files.list
.
Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek und einem curl-Befehl nach Dateien im Ordner für Anwendungsdaten suchen.
Java
Python
Node.js
PHP
.NET
curl
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 Anwendungsdatenordner herunterladen
Wenn Sie eine Datei aus dem Anwendungsdatenordner herunterladen möchten, verwenden Sie die Methode files.get
mit dem URL-Parameter alt=media
, um den Dateiinhalt im Antworttext abzurufen. Weitere Informationen und Codebeispiele finden Sie unter Blob-Dateiinhalte herunterladen.
Das folgende Codebeispiel zeigt, wie Sie Dateien im Ordner für Anwendungsdaten mit einem curl-Befehl herunterladen. Der Antworttext variiert je nach dem, was gespeichert wird.
curl
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.