Der Ordner mit Anwendungsdaten ist ein spezieller ausgeblendeter Ordner, in dem Ihre App anwendungsspezifische Daten wie Konfigurationsdateien speichern kann. Der Ordner mit Anwendungsdaten wird automatisch erstellt, wenn Sie versuchen, eine Datei darin 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 andere Google Drive-Apps ausgeblendet.
Der Ordner mit Anwendungsdaten wird gelöscht, wenn ein Nutzer Ihre App aus „Meine Ablage“ deinstalliert. Nutzer können den Datenordner Ihrer App auch manuell löschen.
Bereich des Ordners mit 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 darauf 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 mit Anwendungsdaten und den Drive-Sicherungsordnern
Der Ordner mit Anwendungsdaten ist von Ihrem Drive-Sicherungsordner getrennt.
Der Ordner mit Anwendungsdaten ist ein Konfigurationsordner, der für jede Drittanbieter-App erstellt wird. Jede Drittanbieter-App kann darin Daten speichern. Nur die Anwendung, die die Daten im appDataFolder erstellt hat, kann darauf zugreifen. Auf den Ordner kann nicht über die Drive-Benutzeroberfläche zugegriffen werden.
Einschränkungen für den Ordner mit Anwendungsdaten
Bei der Verwendung des Ordners mit Anwendungsdaten gelten die folgenden Einschränkungen:
Sie können keine Dateien oder Ordner im Ordner mit Anwendungsdaten freigeben. Wenn Sie dies versuchen, wird ein
notSupportedForAppDataFolderFiles-Fehler mit der folgenden Fehlermeldung generiert: „Method not supported for files within the Application Data folder.“ (Methode wird für Dateien im Ordner mit Anwendungsdaten nicht unterstützt.)Sie können Dateien im
appDataFoldernicht zwischen Speicherorten (Spaces) verschieben. Wenn Sie dies versuchen, wird einnotSupportedForAppDataFolderFiles-Fehler mit der folgenden Fehlermeldung generiert: „Method not supported for files within the Application Data folder.“ (Methode wird für Dateien im Ordner mit Anwendungsdaten nicht unterstützt.) Weitere Informationen finden Sie unter Datei organisation.Sie können keine Dateien oder Ordner im Ordner mit Anwendungsdaten in den Papierkorb verschieben. Wenn Sie dies versuchen, wird ein
notSupportedForAppDataFolderFiles-Fehler mit der folgenden Fehlermeldung generiert: „Files within the Application Data folder cannot be trashed.“ (Dateien im Ordner mit Anwendungsdaten können nicht in den Papierkorb verschoben werden.)
Datei im Ordner mit Anwendungsdaten erstellen
Wenn Sie eine Datei im Ordner mit Anwendungsdaten erstellen möchten, geben Sie appDataFolder in der
parents Eigenschaft der Datei an und verwenden Sie die
files.create Methode, um die Datei in
dem Ordner zu erstellen.
Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek und einem curl-Befehl eine Datei in einen Ordner einfügen.
Java
Python
Node.js
PHP
.NET
curl
Anfrage:
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 füllen.
Nach Dateien im Ordner mit Anwendungsdaten suchen
Wenn Sie nach Dateien im Ordner mit Anwendungsdaten suchen möchten, legen Sie das spaces Feld auf
appDataFolder fest und verwenden Sie die files.list
Methode.
Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek und einem curl-Befehl nach Dateien im Ordner mit Anwendungsdaten suchen.
Java
Python
Node.js
PHP
.NET
curl
Anfrage:
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 mit Anwendungsdaten herunterladen
Wenn Sie eine Datei aus dem Ordner mit Anwendungsdaten herunterladen möchten, verwenden Sie die files.get Methode mit dem alt=media URL-Parameter, um
die Dateiinhalte im Antworttext abzurufen. Weitere Informationen und
Codebeispiele finden Sie unter Blob-Dateiinhalte
herunterladen.
Das folgende Codebeispiel zeigt, wie Sie mit einem curl-Befehl Dateien im Ordner mit Anwendungsdaten herunterladen. Der Antworttext variiert je nach gespeicherten Inhalten.
curl
Anfrage:
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