Las carpetas son archivos que solo contienen metadatos y se pueden usar para organizar archivos en Google Drive. Tienen las siguientes propiedades:
- Una carpeta es un archivo con el tipo de MIME
application/vnd.google-apps.folder
y no tiene extensión. - El alias
root
se puede usar para hacer referencia a la carpeta raíz en cualquier lugar en el que se proporcione un ID de archivo.
Para obtener más información sobre los límites de las carpetas de Drive, consulta Límites de archivos y carpetas.
En esta guía, se explica cómo realizar algunas tareas básicas relacionadas con las carpetas.
Crea una carpeta
Para crear una carpeta, usa el método files.create
con el tipo de MIME application/vnd.google-apps.folder
y un título. En la siguiente muestra de código, se indica cómo crear una carpeta con una biblioteca cliente:
Java
Python
Node.js
PHP
.NET
Cómo crear un archivo en una carpeta específica
Para crear un archivo en una carpeta específica, usa el método files.create
y especifica el ID de la carpeta en la propiedad parents
del archivo. La propiedad parents
contiene los IDs de las carpetas superiores que contienen el archivo. En la siguiente muestra de código, se indica cómo crear
un archivo en una carpeta específica con una biblioteca cliente:
Java
Python
Node.js
PHP
.NET
La propiedad parents
se puede usar cuando se crean archivos en una carpeta de nivel superior o en cualquier otra carpeta.
Mueve archivos entre carpetas
Para mover archivos, debes actualizar el ID de la propiedad parents
.
Para agregar o quitar elementos superiores de un archivo existente, usa el método files.update
con los parámetros de consulta addParents
y removeParents
. En la siguiente muestra de código, se indica cómo mover un archivo entre carpetas con una biblioteca cliente:
Java
Python
Node.js
PHP
.NET
Límites de archivos y carpetas
Los archivos y las carpetas de Drive tienen algunos límites de almacenamiento.
Límite de elementos del usuario
Cada usuario puede tener hasta 500 millones de elementos creados con esa cuenta. Cuando se alcanza el límite, el usuario ya no puede crear ni subir elementos en Drive. Podrá seguir viendo y editando los elementos existentes. Para volver a crear archivos, los usuarios deben borrar elementos de forma permanente o usar una cuenta diferente. Para obtener más información, consulta Cómo borrar o enviar archivos a la papelera.
Los objetos que se consideran en este límite son los siguientes:
- Elementos que el usuario creó o subió a Drive
- Elementos creados por el usuario, pero que ahora son propiedad de otra persona
- Elementos de la papelera
- Combinaciones de teclas
- Accesos directos de terceros
Los objetos que no se consideran en este límite son los siguientes:
- Elementos borrados de forma permanente
- Elementos compartidos con el usuario que pertenecen a otra persona
- Elementos que son propiedad del usuario, pero creados por otra persona
Si intentas agregar más de 500 millones de elementos, se mostrará una respuesta de código de estado HTTP activeItemCreationLimitExceeded
.
Límite de elementos de carpetas
Cada carpeta de la sección Mi unidad de un usuario tiene un límite de 500,000 elementos. Este límite no se aplica a la carpeta raíz de Mi unidad. Los elementos que se consideran para este límite son los siguientes:
- Carpetas
- Archivos Todos los tipos de archivos, independientemente de su propiedad.
- Accesos directos. Cuenta como un solo elemento dentro de una carpeta, incluso si el elemento al que se orienta no está dentro de esa carpeta. Para obtener más información, consulta Cómo crear un acceso directo a un archivo de Drive.
- Atajos de terceros: Cuenta como un solo elemento dentro de una carpeta, incluso si el elemento al que se orienta no está dentro de esa carpeta. Para obtener más información, consulta Cómo crear un archivo de acceso directo al contenido que almacena tu app.
Para obtener más información sobre los límites de carpetas, consulta Límites de carpetas en Google Drive.
Límite de profundidad de la carpeta
La sección Mi unidad de un usuario no puede contener más de 100 niveles de carpetas anidadas. Esto significa que una carpeta secundaria no se puede almacenar en una carpeta con más de 99 niveles de profundidad. Esta limitación solo se aplica a las carpetas secundarias. Los archivos secundarios con un tipo de MIME distinto de application/vnd.google-apps.folder
están exentos de esta limitación.
Por ejemplo, en el siguiente diagrama, se puede anidar una carpeta nueva dentro de la carpeta número 99, pero no dentro de la carpeta número 100. Sin embargo, la carpeta número 100 puede almacenar archivos como cualquier otra carpeta de Drive:
Si intentas agregar más de 100 niveles de carpetas, se mostrará una respuesta de código de estado HTTP myDriveHierarchyDepthLimitExceeded
.