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 dei dati dell'applicazione viene creata automaticamente quando tenti di creare un file al suo interno. Utilizza questa cartella per archiviare tutti i file con cui l'utente non deve interagire direttamente. Questa cartella è accessibile solo dalla 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 della tua 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
ulteriori informazioni sugli ambiti e su come richiedere l'accesso, consulta la pagina
Scegliere gli ambiti dell'API Google Drive. Per ulteriori
informazioni sugli ambiti OAuth 2.0 specifici, consulta la pagina 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ò archiviare i dati al suo interno. Solo l'applicazione che ha creato i dati in appDataFolder può accedervi. Non è possibile accedere alla cartella utilizzando l'interfaccia utente (UI) di Drive.
Vincoli della cartella dei dati dell'applicazione
Quando lavori con la cartella dei dati dell'applicazione, vengono applicati i seguenti vincoli:
Non puoi condividere file o cartelle all'interno della cartella dei dati dell'applicazione. Se tenti di farlo, viene generato un errore
notSupportedForAppDataFolderFilescon il seguente messaggio di errore: "Method not supported for files within the Application Data folder."Non puoi spostare i file in
appDataFoldertra le posizioni di archiviazione (spazi). Se tenti di farlo, viene generato un errorenotSupportedForAppDataFolderFilescon il seguente messaggio di errore: "Method not supported for files within the Application Data folder." 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. Se tenti di farlo, viene generato un errore
notSupportedForAppDataFolderFilescon il seguente messaggio di errore: "Files within the Application Data folder cannot be trashed."
Creare un file nella cartella dei dati dell'applicazione
Per creare un file nella cartella dei dati dell'applicazione, specifica appDataFolder nella
parents proprietà del file e utilizza il
files.create metodo 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 la pagina Creare e popolare le cartelle.
Cercare file nella cartella dei dati dell'applicazione
Per cercare file nella cartella dei dati dell'applicazione, imposta il spaces campo su
appDataFolder e utilizza il files.list
metodo.
Il seguente esempio di codice mostra come cercare 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 files.get metodo con il alt=media parametro URL per
recuperare i contenuti del file nel corpo della risposta. Per ulteriori informazioni e per
visualizzare esempi di codice, consulta la pagina 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 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.