Le cartelle sono file che contengono solo metadati e che 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 non ha estensione. - L'alias
root
può essere utilizzato per fare riferimento alla cartella principale ovunque un ID file in cui viene fornito il valore.
Per ulteriori informazioni sui limiti delle cartelle di Drive, vedi File e limiti delle cartelle.
Questa guida spiega come eseguire alcune attività di base relative alle cartelle.
Crea una cartella
Per creare una cartella, utilizza files.create
con il application/vnd.google-apps.folder
MIME
tipo 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 nel
parents
del file.
La proprietà parents
contiene l'ID della cartella principale contenente il file.
La proprietà parents
può essere utilizzata quando crei file in una cartella di primo livello oppure
in qualsiasi altra cartella.
Un file può avere una sola cartella principale. specificare più elementi padre non supportati.
Il seguente esempio di codice mostra come creare un file in una cartella specifica utilizzando 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 addParents
e
Parametri di query removeParents
.
Un file può avere una sola cartella principale. specificare più elementi padre non supportati.
Il seguente esempio di codice mostra come spostare un file da una cartella all'altra utilizzando un 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 articoli in Drive. Possono comunque visualizzare e modificare gli elementi esistenti. Per creare gli utenti dovranno eliminare definitivamente gli elementi o utilizzare un altro account. Per ulteriori informazioni, vedi Spostare file nel cestino o eliminare file 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
Se tenti di aggiungere più di 500 milioni di elementi restituisce un
activeItemCreationLimitExceeded
Risposta del codice di stato HTTP.
Tieni presente che anche se non esiste un limite al numero di elementi che un account di servizio può proprio, il limite di 500 milioni di elementi si applica al numero di elementi per un account di servizio possono 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. Elementi che vengono conteggiate 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 la sezione Creare un 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 in quella cartella. Per ulteriori informazioni, vedi Crea un file scorciatoia ai contenuti memorizzati dal tuo Google Cloud.
Per ulteriori informazioni sui limiti per le cartelle, vedi Limiti per le cartelle in Google Drive.
Limite di profondità delle cartelle
La sezione Il mio Drive di un utente non può contenere più di 100 livelli di
cartelle. Ciò significa che non è possibile archiviare una cartella secondaria in una cartella del
oltre 99 livelli di profondità. Questo limite si applica solo alle cartelle secondarie. Un bambino
file 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 di una cartella numero 99, ma non all'interno della cartella numero 100. Tuttavia, la cartella numero 100 può archiviare come qualsiasi altra cartella di Drive:
Per aggiungere più di 100 livelli di cartelle, viene restituito
myDriveHierarchyDepthLimitExceeded
Risposta del codice di stato HTTP.