Le cartelle sono file che contengono solo metadati e possono essere utilizzate per organizzare i file su Google Drive. Hanno le seguenti proprietà:
- Una cartella è un file con tipo MIME
application/vnd.google-apps.folder
e senza estensione. - L'alias
root
può essere utilizzato per fare riferimento alla cartella principale ovunque sia fornito un ID file.
Per ulteriori informazioni sui limiti delle cartelle di Drive, vedi Limiti di file e cartelle.
Questa guida spiega come eseguire alcune attività di base relative alle cartelle.
Crea una cartella
Per creare una cartella, utilizza il metodo files.create
con il tipo MIMEapplication/vnd.google-apps.folder
e un titolo. Il seguente codice di esempio mostra come creare una cartella utilizzando una libreria client:
Java
Python
Node.js
PHP
.NET
Creare un file in una cartella specifica
Per creare un file in una cartella specifica, utilizza il metodo files.create
e specifica l'ID cartella nella proprietà parents
del file.
La proprietà parents
contiene l'ID della cartella principale contenente il file.
La proprietà parents
può essere utilizzata per creare file in una cartella di primo livello o in qualsiasi altra cartella.
Un file può avere una sola cartella principale; la specifica di più cartelle principali non è supportata.
Il seguente esempio di codice mostra come creare un file in una cartella specifica utilizzando una libreria client:
Java
Python
Node.js
PHP
.NET
Spostare file tra le cartelle
Per spostare i file, devi aggiornare l'ID della proprietà parents
.
Per aggiungere o rimuovere elementi principali per un file esistente, utilizza il metodo files.update
con i parametri di query addParents
e
removeParents
.
Un file può avere una sola cartella principale; la specifica di più cartelle principali non è supportata.
Il seguente esempio di codice mostra come spostare un file tra cartelle utilizzando una libreria client:
Java
Python
Node.js
PHP
.NET
Limiti per file e cartelle
I file e le cartelle di Drive hanno alcuni limiti di spazio di archiviazione.
Limite di elementi per utente
Ogni utente può avere fino a 500 milioni di elementi creati da quell'account. Quando viene raggiunto il limite, l'utente non può più creare o caricare elementi su Drive. Tuttavia, potrà comunque visualizzare e modificare gli elementi esistenti. Per poter creare nuovamente i file, gli utenti devono eliminare definitivamente gli elementi o utilizzare un account diverso. Per ulteriori informazioni, consulta Trasferire file e cartelle nel Cestino o eliminarli.
Gli oggetti conteggiati per il limite sono:
- Elementi creati o caricati dall'utente su Drive
- Elementi creati dall'utente, ma ora di proprietà di qualcun altro
- Elementi nel cestino
- Scorciatoie
- Scorciatoie di terze parti
Gli oggetti che non vengono conteggiati per questo limite sono:
- Elementi eliminati definitivamente
- Elementi condivisi con l'utente, ma di proprietà di qualcun altro
- Elementi di proprietà dell'utente, ma creati da qualcun altro
I tentativi di aggiungere più di 500 milioni di elementi restituiscono una risposta con codice di stato HTTP activeItemCreationLimitExceeded
.
Tieni presente che, anche se non esiste un limite al numero di elementi che un account di servizio può possedere, il limite di 500 milioni di elementi si applica al numero di elementi che un account di servizio può creare.
Limite di elementi della cartella
Ogni cartella di Il mio Drive di un utente può contenere massimo 500.000 elementi. Questo limite non si applica alla cartella principale di Il mio Drive. Gli elementi conteggiati per il limite sono:
- Cartelle
- File. Tutti i tipi di file, indipendentemente dalla proprietà.
- Scorciatoie. Conteggia come un singolo elemento all'interno di una cartella, anche se l'elemento a cui rimanda non si trova all'interno di tale cartella. Per ulteriori informazioni, vedi Creare un collegamento a un file di Drive.
- Scorciatoie di terze parti. Viene conteggiato come un singolo elemento all'interno di una cartella, anche se l'elemento a cui rimanda non si trova all'interno di tale cartella. Per ulteriori informazioni, consulta Creare un file di scorciatoia per i contenuti archiviati dall'app.
Per ulteriori informazioni sui limiti per le cartelle, vedi Limiti per le cartelle su Google Drive.
Limite di profondità delle cartelle
Il mio Drive di un utente non può contenere più di 100 livelli di cartelle nidificate. Ciò significa che una cartella secondaria non può essere archiviata in una cartella con più di 99 livelli di profondità. Questa limitazione si applica solo alle cartelle secondarie. Un file secondario con un tipo MIME diverso da application/vnd.google-apps.folder
è esente da questa limitazione.
Ad esempio, nel diagramma seguente una nuova cartella può essere nidificata all'interno della cartella 99, ma non all'interno della cartella 100. Tuttavia, la cartella numero 100 può archiviare i file come qualsiasi altra cartella di Drive:
I tentativi di aggiungere più di 100 livelli di cartelle restituiscono una risposta del codice di stato HTTP myDriveHierarchyDepthLimitExceeded
.