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 viene 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 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 delle cartelle principali 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 quando crei file in una cartella di primo livello o in qualsiasi altra cartella.
Spostare file tra le cartelle
Per spostare i file, devi aggiornare l'ID della proprietà parents
.
Per aggiungere o rimuovere elementi padre 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 da una cartella all'altra 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 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. Possono 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, vedi Spostare file e cartelle nel cestino o nelle 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 un altro utente
- Elementi nel cestino
- Scorciatoie
- Scorciatoie di terze parti
Gli oggetti che non vengono conteggiati 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 un altro utente
I tentativi di aggiungere più di 500 milioni di elementi restituiscono una risposta del 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 elemento 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 che vengono 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 tale cartella. Per ulteriori informazioni, vedi 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 tale cartella. Per maggiori informazioni, consulta Creare un file di scorciatoia ai contenuti archiviati dalla tua app.
Per ulteriori informazioni sui limiti delle 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 una profondità superiore a 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 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
.