Le cartelle sono file che contengono solo metadati e possono essere utilizzati per organizzare i file su Google Drive. Hanno le seguenti proprietà:
- Una cartella è un file con il tipo MIME
application/vnd.google-apps.folder
e senza estensione. - L'alias
root
può essere utilizzato per fare riferimento alla cartella principale ovunque venga fornito un ID file.
Per ulteriori informazioni sui limiti delle cartelle di Drive, vedi Limiti per 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 MIME application/vnd.google-apps.folder
e un titolo. Il seguente esempio di codice 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 gli ID cartella principale che contengono il file. Il seguente esempio di codice mostra come creare un file in una cartella specifica utilizzando una libreria client:
Java
Python
Node.js
PHP
.NET
La proprietà parents
può essere utilizzata durante la creazione di file in una cartella di primo livello o in qualsiasi altra cartella.
Spostare i file da una cartella all'altra
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
. 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 presentano alcuni limiti di spazio di archiviazione.
Limite di elementi 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 in Drive. Tuttavia, potranno comunque visualizzare e modificare gli elementi esistenti. Per creare di nuovo i file, gli utenti devono eliminare definitivamente gli elementi o utilizzare un account diverso. Per ulteriori informazioni, consulta l'articolo Cestino o eliminazione di file e cartelle.
Gli oggetti che vengono conteggiati ai fini di questo limite sono:
- Elementi creati o caricati dall'utente in Drive
- Elementi creati dall'utente, ma ora di proprietà di qualcun altro
- Elementi nel cestino
- Scorciatoie
- Scorciatoie di terze parti
Gli oggetti che non contano ai fini di 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
.
Limite di elementi della cartella
Ogni cartella in Il mio Drive di un utente ha un limite di 500.000 elementi. Questo limite non si applica alla cartella principale di Il mio Drive. Gli elementi conteggiati ai fini di questo limite sono:
- Cartelle
- File. Tutti i tipi di file, indipendentemente dalla proprietà.
- Scorciatoie. Viene conteggiato come un singolo elemento all'interno di una cartella, anche se l'elemento a cui rimanda non si trova all'interno di quella cartella. Per ulteriori informazioni, consulta Creare una scorciatoia 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 quella cartella. Per ulteriori informazioni, consulta la sezione Creare un file di scorciatoia ai contenuti memorizzati dalla tua app.
Per ulteriori informazioni sui limiti delle cartelle, vedi Limiti delle cartelle su Google Drive.
Limite di profondità delle cartelle
La sezione 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. Questo limite 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 numero 99, ma non all'interno della cartella numero 100. Tuttavia, la cartella numero 100 permette di archiviare i file come qualsiasi altra cartella di Drive:
I tentativi di aggiungere più di 100 livelli di cartelle restituiscono una risposta con codice di stato HTTP myDriveHierarchyDepthLimitExceeded
.