La cartella dei dati dell'applicazione è una cartella speciale nascosta che la tua app può utilizzare per archiviare dati specifici dell'applicazione, come i file di configurazione. La cartella dei dati 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 alle altre app 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
all'ambito non sensibile https://www.googleapis.com/auth/drive.appdata
. Per
maggiori informazioni sugli ambiti e su come richiedere 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 di backup di Drive.
La cartella dei 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 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 della cartella dei dati dell'applicazione
Quando lavori con la cartella dei dati delle applicazioni, vengono applicati i seguenti vincoli:
Non puoi condividere file o cartelle all'interno della cartella dei dati delle applicazioni. 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 applicazioni".Non puoi spostare i file in
appDataFolder
tra le posizioni di archiviazione (spazi). Se provi a farlo, viene generato un errorenotSupportedForAppDataFolderFiles
con il seguente messaggio di errore: "Metodo non supportato per i file all'interno della cartella Dati applicazioni". Per maggiori informazioni, vedi Organizzazione dei file.Non puoi spostare nel cestino file o cartelle all'interno della cartella dei dati delle applicazioni. Il tentativo di farlo genera un errore
notSupportedForAppDataFolderFiles
con il seguente messaggio di errore: "I file all'interno della cartella Dati applicazioni non possono essere eliminati."
Creare 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 popolare 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 cartella 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 dei 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 saperne di più 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 cartella dei dati dell'applicazione utilizzando un comando curl. Il corpo della risposta varia a seconda di ciò che è stato 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.