La cartella dei dati dell'applicazione è una cartella nascosta speciale che la tua app può utilizzare per archiviare dati specifici dell'applicazione, come i file di configurazione. La cartella data dell'applicazione viene creata automaticamente quando tenti di creare un file al suo interno. Utilizza questa cartella per archiviare i file con cui l'utente non deve interagire direttamente. Questa cartella è accessibile solo alla tua app e i suoi contenuti sono nascosti all'utente e ad altre app di Google Drive.
La cartella dei dati dell'applicazione viene eliminata quando un utente disinstalla la tua app da Il mio Drive. Gli utenti possono anche eliminare manualmente la cartella dei dati dell'app.
Ambito della cartella dei dati dell'applicazione
Prima di poter accedere alla cartella dei dati dell'applicazione, devi richiedere l'accesso allo scopo non sensibile https://www.googleapis.com/auth/drive.appdata
. Per maggiori informazioni sugli ambiti e su come richiederne l'accesso, consulta Scegliere gli ambiti dell'API Google Drive. Per ulteriori informazioni su ambiti OAuth 2.0 specifici, consulta Ambiti OAuth 2.0 per le API di Google.
Differenze tra la cartella dei dati dell'applicazione e le cartelle di backup di Drive
La cartella dei dati dell'applicazione è separata dalla cartella del backup di Drive.
La cartella Dati dell'applicazione è una cartella di configurazione creata per ogni app di terze parti e ogni app di terze parti può archiviarvi i dati. Solo l'applicazione che ha creato i dati in appDataFolder
può accedervi. Non è possibile accedere alla
cartella utilizzando l'interfaccia utente (UI) di Drive.
La cartella di backup di Drive è una cartella riservata in cui Drive scrive i backup del dispositivo ed è visibile nell'interfaccia utente di Drive.
Vincoli per la cartella dei dati dell'applicazione
I seguenti vincoli vengono applicati quando si lavora con la cartella dei dati dell'applicazione:
Non puoi condividere file o cartelle all'interno della cartella dei dati dell'applicazione. Il tentativo di farlo genera un errore
notSupportedForAppDataFolderFiles
con il seguente messaggio di errore: "Metodo non supportato per i file all'interno della cartella Dati dell'applicazione".Non puoi spostare i file in
appDataFolder
tra posizioni di archiviazione (spazi). Il tentativo di farlo genera un errorenotSupportedForAppDataFolderFiles
con il seguente messaggio: "Metodo non supportato per i file all'interno della cartella Dati dell'applicazione". Per ulteriori informazioni, consulta la sezione Organizzazione dei file.Non puoi spostare file o cartelle nel cestino all'interno della cartella dei dati dell'applicazione. Il tentativo di farlo genera un errore
notSupportedForAppDataFolderFiles
con il seguente messaggio di errore: "I file all'interno della cartella Dati dell'applicazione non possono essere inseriti nel cestino".
Crea un file nella cartella dei dati dell'applicazione
Per creare un file nella cartella dei dati dell'applicazione, specifica appDataFolder
nella proprietà parents
del file e utilizza il metodo files.create
per creare il file nella cartella.
Il seguente esempio di codice mostra come inserire un file in una cartella utilizzando una libreria client e un comando curl.
Java
Python
Node.js
PHP
.NET
curl
Richiesta:
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"]}'
Sostituisci ACCESS_TOKEN con il token OAuth 2.0 della tua app.
Risposta:
{
"kind": "drive#file",
"id": FILE_ID,
"name": "config.json",
"mimeType": "application/json"
}
Per ulteriori informazioni sulla creazione di file nelle cartelle, consulta Creare e compilare le cartelle.
Cercare file nella cartella dei dati dell'applicazione
Per cercare file nella cartella dei dati dell'applicazione, imposta il campo spaces
su
appDataFolder
e utilizza il metodo files.list
.
Il seguente esempio di codice mostra come cercare i file nella directory dei dati dell'applicazione utilizzando una libreria client e un comando curl.
Java
Python
Node.js
PHP
.NET
curl
Richiesta:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
Sostituisci ACCESS_TOKEN con il token OAuth 2.0 della tua app.
Risposta:
{
"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"
}
]
}
Scaricare file dalla cartella Dati dell'applicazione
Per scaricare un file dalla cartella dei dati dell'applicazione, utilizza il metodo files.get
con il parametro URL alt=media
per recuperare i contenuti del file nel corpo della risposta. Per ulteriori informazioni e per visualizzare esempi di codice, vai a Scaricare i contenuti dei file BLOB.
Il seguente esempio di codice mostra come scaricare i file nella directory dei dati dell'applicazione utilizzando un comando curl. Il corpo della risposta varia a seconda di ciò che viene salvato.
curl
Richiesta:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
Sostituisci quanto segue:
- ACCESS_TOKEN: il token OAuth 2.0 della tua app.
- FILE_ID: l'ID del file che vuoi scaricare.