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 donde 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 MIME application/vnd.google-apps.folder
y un título. En la siguiente muestra de código, se muestra
cómo crear una carpeta con una biblioteca cliente:
Java
Python
Node.js
PHP
.NET
Crea 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 el ID de la carpeta superior que contiene el archivo.
La propiedad parents
se puede usar cuando se crean archivos en una carpeta de nivel superior o en cualquier otra carpeta.
Un archivo solo puede tener una carpeta superior. No se admite la especificación de varios elementos superiores.
En la siguiente muestra de código, se muestra cómo crear un archivo en una carpeta específica con una biblioteca cliente:
Java
Python
Node.js
PHP
.NET
Cómo mover 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
.
Un archivo solo puede tener una carpeta superior; no se admite la especificación de varios superiores.
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 por usuario
Cada usuario puede tener hasta 500 millones de elementos creados por esa cuenta. Cuando se alcanza el límite, el usuario ya no puede crear ni subir elementos en Drive. Aún pueden ver y editar los elementos existentes. Para volver a crear archivos, los usuarios deben borrar los elementos de forma permanente o usar una cuenta diferente. Para obtener más información, consulta Cómo enviar archivos y carpetas a la papelera o borrarlos.
Los objetos que se consideran para este límite son los siguientes:
- Elementos que el usuario creó o subió en Drive
- Elementos creados por el usuario, pero que ahora son propiedad de otra persona
- Elementos en la papelera
- Accesos directos
- Combinaciones de teclas de terceros
Los siguientes objetos no se consideran en este límite:
- Elementos borrados definitivamente
- Elementos compartidos con el usuario, pero que son propiedad de otra persona
- Elementos que son propiedad del usuario, pero que creó otra persona
Los intentos de agregar más de 500 millones de elementos muestran una respuesta de código de estado HTTP activeItemCreationLimitExceeded
.
Ten en cuenta que, si bien no hay límite para la cantidad de elementos que puede tener una cuenta de servicio, el límite de 500 millones de elementos se aplica a la cantidad de elementos que puede crear una cuenta de servicio.
Límite de elementos de carpeta
Cada carpeta de 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 la propiedad
- Accesos directos. Se cuenta como un solo elemento dentro de una carpeta, incluso si el elemento al que hace referencia no está dentro de esa carpeta. Para obtener más información, consulta Cómo crear un atajo a un archivo de Drive.
- Accesos directos de terceros. Se cuenta como un solo elemento dentro de una carpeta, incluso si el elemento al que apunta 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 las carpetas, consulta Límites de las carpetas en Google Drive.
Límite de profundidad de la carpeta
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 que tenga más de 99 niveles de profundidad. Esta limitación solo se aplica a las carpetas secundarias. Un archivo secundario con un tipo de MIME que no sea application/vnd.google-apps.folder
está exento de esta limitación.
Por ejemplo, en el siguiente diagrama, una carpeta nueva se puede anidar dentro de la carpeta número 99, pero no dentro de la carpeta número 100. Sin embargo, la carpeta 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
.