Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Google Drive organiza los archivos en colecciones, los describe por tipos y proporciona atributos específicos para cada archivo para facilitar su manipulación.
La API de Google Drive representa los archivos almacenados en Drive como un recurso files.
Propiedad
Drive organiza los archivos según la relación del usuario con el contenido y su ubicación de almacenamiento. Las colecciones se especifican como parte de los metadatos del archivo para mostrar con qué grupo de archivos se almacena el archivo en Drive. La principal diferencia entre las colecciones de Mi unidad y las de las unidades compartidas es la propiedad de los archivos. Un solo usuario es el propietario de los archivos en su Mi unidad, mientras que un grupo o una organización son los propietarios de los archivos en una unidad compartida.
Mi unidad
Cada usuario tiene una carpeta "raíz" llamada "Mi unidad" que funciona como su jerarquía principal y consta de todo lo que desciende de esta carpeta raíz. El usuario es el propietario principal de esta carpeta.
Unidades compartidas
Una unidad compartida es una estructura organizativa dentro de Drive que existe en paralelo a Mi unidad. Puedes organizar un archivo individual en una unidad compartida o en Mi unidad, pero no en ambas. Sin embargo, los
accesos directos de Drive se pueden usar para apuntar a archivos o carpetas de unidades compartidas a Mi unidad, o viceversa.
Tipos de archivo
Drive describe los archivos por tipos. En esta lista, se muestran todos los tipos de archivos disponibles:
BLOB
Archivo que contiene texto o contenido binario, como imágenes, videos y PDFs.
Carpeta
Es un contenedor que puedes usar para organizar otros tipos de archivos en Drive. Las carpetas son archivos que solo contienen metadatos y tienen el tipo de MIME application/vnd.google-apps.folder. Para obtener más información, consulta Crea y completa carpetas.
Nota: Un solo archivo almacenado en Mi unidad puede estar en varias carpetas. Un solo archivo almacenado en una unidad compartida solo puede tener una carpeta principal.
Documento de Google Workspace
Es un archivo que crea una aplicación de Google Workspace, como Documentos, Hojas de cálculo o Presentaciones de Google. El formato del tipo de MIME es application/vnd.google-apps.*app*, donde app es el nombre de la aplicación (como application/vnd.google-apps.spreadsheet para un archivo de Hojas de cálculo). Para obtener una lista de los tipos de MIME específicos de Drive y Google Workspace, consulta Tipos de MIME admitidos en Google Workspace y Google Drive.
Combinación de teclas
Es un archivo que solo contiene metadatos y que apunta a otro archivo en Drive. El tipo de MIME del archivo de acceso directo es application/vnd.google-apps.shortcut. Para obtener más información, consulta Cómo crear un acceso directo a un archivo de Drive.
Atajo de terceros
Es un archivo que solo contiene metadatos y que vincula a contenido almacenado en un sistema de almacenamiento de terceros. El tipo de MIME del archivo de acceso directo de terceros es application/vnd.google-apps.drive-sdk. Para obtener más información, consulta Crea un archivo de acceso directo al contenido almacenado por tu app.
Características del archivo
En esta lista, se muestran algunas características de un archivo de Drive:
Es el cuerpo binario o de texto del archivo. Algunos ejemplos de contenido que puedes almacenar en Drive son imágenes, videos, texto y PDFs.
ID de archivo
Es un ID único y opaco para cada archivo. Los IDs de archivo son estables durante toda la vida útil del archivo, incluso si cambia el nombre del archivo. Las expresiones de búsqueda se usan para ubicar archivos por nombre, tipo, contenido, contenedor principal, propietario o cualquier otro metadato.
Metadatos
Datos que describen el contenido del archivo. Estos datos incluyen el nombre, el tipo, la creación y las horas de modificación. Algunos campos de metadatos, como name, son independientes del usuario y aparecen de la misma manera para cada usuario. Otros campos, como capabilities y viewedByMeDate, contienen valores específicos del usuario. Los tipos de archivos, como imágenes y videos, contienen metadatos adicionales extraídos de EXIF y otros metadatos incorporados. Para obtener más información, consulta Administra metadatos de archivos.
Permiso
Es un permiso de acceso para que un usuario, un grupo, un dominio o cualquier persona pueda acceder a un archivo o a una jerarquía de carpetas. Los usuarios controlan quién puede acceder a un archivo con la lista de control de acceso (LCA), que es una lista de permisos para el archivo. Para obtener más información, consulta Cómo compartir archivos, carpetas y unidades.
Historial de revisión
Registro de los cambios en el contenido del archivo únicamente, no en los metadatos del archivo. Para obtener más detalles sobre las revisiones, consulta Descripción general de los cambios y las revisiones.
Miniatura
Representación gráfica de un archivo. Drive genera automáticamente miniaturas para muchos tipos de archivos comunes. En el caso de los accesos directos y otros tipos de archivos que Drive no puede renderizar, puedes proporcionar una imagen en miniatura. Para obtener más información, consulta Cómo subir miniaturas.
Organización de archivos
La API de Drive organiza los archivos en ubicaciones de almacenamiento, llamadas spaces, y colecciones, llamadas corpora.
Espacios
Son ubicaciones de almacenamiento específicas que están aisladas entre sí. Todo el contenido de Drive se almacena en uno de estos dos espacios definidos: drive y appDataFolder.
drive: Incluye todos los archivos visibles para el usuario creados en Drive. Los PDFs, los documentos, los Documentos de Google, los accesos directos y otro contenido que sube el usuario se encuentran en el espacio drive.
appDataFolder: Incluye datos de la aplicación por usuario. Por lo general, las aplicaciones almacenan archivos de configuración y otros datos a los que los usuarios no deben acceder directamente.
Los archivos no se pueden mover entre spaces.
Corpora
Son colecciones de archivos que se usan para limitar el alcance de las búsquedas de archivos y carpetas. Los corpus de Drive son user, domain, drive y allDrives.
user: Incluye todos los archivos que el usuario creó y abrió en "Mi unidad", y los que se compartieron directamente con él en "Compartidos conmigo".
drive: Incluye todos los archivos contenidos en una sola unidad compartida, como se indica en driveId.
domain: Incluye todos los archivos en los que se puede realizar búsquedas y que se compartieron con el dominio del usuario.
allDrives: Incluye todos los archivos de las unidades compartidas en las que el usuario es miembro y todos los archivos de "Mi unidad" y "Compartidos conmigo".
Usa los corpus de allDrives con precaución, ya que tienen un alcance amplio y pueden afectar el rendimiento. Cuando sea posible, usa user o drive en lugar de allDrives para mayor eficiencia.
Los archivos pueden moverse libremente entre corpora a medida que cambian los permisos y la propiedad.
[null,null,["Última actualización: 2025-08-04 (UTC)"],[],[],null,["# Files and folders overview\n\nGoogle Drive organizes files in collections, describes files by types, and\nprovides specific attributes for each file to facilitate file manipulation.\n\nThe Google Drive API represents files stored on Drive as a\n[`files`](/workspace/drive/api/reference/rest/v3/files) resource.\n| **Note:** Folders are treated as a type of file. For more details about folders, see [File types](#types).\n\nOwnership\n---------\n\nDrive organizes files based on the user's relationship with the\ncontent and its storage location. *Collections* are specified as part of the\nfile's metadata to show which group of files the file is stored with inside\nDrive. The main difference between My Drive and\nshared drive collections is file ownership. A single user is the owner of files\nin their My Drive, whereas a group or organization owns files in\na shared drive.\n\n*My Drive*\n: Each user has a \"root\" folder called \"My\n Drive\" that functions as their primary hierarchy, and\n consists of everything that descends from this root folder. The user is the\n primary owner of this folder.\n\n*Shared drives*\n: A [shared drive](/workspace/drive/api/guides/about-shareddrives) is an\n organizational structure within Drive that lives parallel to\n My Drive. You can organize an individual file within a shared\n drive or My Drive, but not both. However, [Drive shortcuts](/workspace/drive/api/guides/shortcuts) can be used to\n point to files or folders from shared drives to My Drive, or\n the other way around.\n\nFile types\n----------\n\nDrive describes files by types. This list shows all available\nfile types:\n\n*Blob*\n: A file that contains text or binary content such as images, videos, and\n PDFs.\n\n*Folder*\n\n: A container you can use to organize other types of files on\n Drive. Folders are files that only contain metadata, and have\n the MIME type `application/vnd.google-apps.folder`. For more information,\n see [Create and populate folders](/workspace/drive/api/guides/folder).\n\n **Note:** A single file stored on My Drive can be in multiple\n folders. A single file stored on a [shared\n drive](/workspace/drive/api/guides/about-shareddrives) can only have one parent folder.\n\n*Google Workspace document*\n\n: A file that a Google Workspace application\n creates, such as Google Docs, Sheets, or\n Slides. The MIME type format is\n `application/vnd.google-apps.*app*` where *app* is the application name\n (such as `application/vnd.google-apps.spreadsheet` for a\n Sheets file). For a list of Drive and\n Google Workspace-specific MIME types, see [Google Workspace and\n Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).\n\n*Shortcut*\n\n: A metadata-only file that points to another file on Drive. The\n shortcut file MIME type is `application/vnd.google-apps.shortcut`. For more\n information, see [Create a shortcut to a Drive\n file](/workspace/drive/api/guides/shortcuts).\n\n*Third-party shortcut*\n\n: A metadata-only file that links to content stored on a third-party storage\n system. The third-party shortcut file MIME type is\n `application/vnd.google-apps.drive-sdk`. For more information, see [Create a\n shortcut file to content stored by your\n app](/workspace/drive/api/guides/third-party-shortcuts).\n\n| **Note:** You cannot upload or download folders, Google Workspace documents, shortcuts, and third-party shortcuts to or from Drive. However, if they use compatible formats you can upload or export Google Workspace documents. For example, you can create a Docs document when you import a PDF. Similarly, you can export a Google Slides presentation as a Microsoft PowerPoint file.\n\nFile characteristics\n--------------------\n\nThis list shows some characteristics of a Drive file:\n\n*Access proposal*\n: A proposal from a requester to an approver to grant a recipient access to a\n Drive item. For more information, see [List and resolve\n pending access\n proposals](/workspace/drive/api/guides/manage-sharing#access-proposals).\n\n*Content*\n: The binary or text body of the file. Some content examples you can store in\n Drive are images, videos, text, and PDFs.\n\n*File ID*\n: A unique, opaque ID for each file. File IDs are stable throughout the life of\n the file, even if the file name changes. [Search\n expressions](/workspace/drive/api/guides/search-files) are used to locate files by name,\n type, content, parent container, owner, or other metadata.\n\n*Metadata*\n: Data describing the contents of the file. This data includes the name, type,\n creation, and modification times. Some metadata fields, such as the `name`,\n are user-agnostic and appear the same for each user. Other fields, such as\n `capabilities` and `viewedByMeDate` contain user-specific values. File\n types, such as images and videos, contain additional metadata extracted from\n EXIF and other embedded metadata. For more information, see [Manage file\n metadata](/workspace/drive/api/guides/file).\n\n*Permission*\n: An access grant for a user, group, domain, or the world to access a file or a\n folder hierarchy. Users control who can access a file with the access\n control list (ACL), which is a list of permissions for the file. For more\n information, see [Share files, folders and\n drives](/workspace/drive/api/guides/manage-sharing).\n\n*Revision history*\n: The record of changes to the file content only, not the file metadata. For\n more details about revisions, see [Changes and revisions overview](/workspace/drive/api/guides/change-overview).\n\n*Thumbnail*\n: A graphical representation of a file. Drive automatically\n generates thumbnails for many common file types. For shortcuts and other\n file types that Drive can't render, you can provide a\n thumbnail image. For more information, see [Upload thumbnails](/workspace/drive/api/guides/file#upload-thumbnails).\n\nFile organization\n-----------------\n\nThe Drive API organizes files into storage locations, called `spaces`,\nand collections, called `corpora`.\n\n*Spaces*\n\n: Specific storage locations that are isolated from each other. All content in\n Drive is stored in one of these two defined spaces: `drive`\n and `appDataFolder`.\n\n - `drive`: Includes all user-visible files created in\n Drive. PDFs, documents, Google Docs, shortcuts, and\n other content the user uploads is located in the `drive` space.\n\n - `appDataFolder`: Includes per-user application data. Applications\n typically store configuration files and other data not intended to be\n directly accessible by users.\n\n Files cannot move between `spaces`.\n\n*Corpora*\n\n: Collections of files used to narrow the scope of file and folder searches. The\n corpora for Drive are: `user`, `domain`, `drive`, and\n `allDrives`.\n\n - `user`: Includes all files created by and opened by the user in \"My\n Drive\", and those shared directly with the user in\n \"Shared with me.\"\n\n - `drive`: Includes all files contained in a single shared drive, as\n indicated by the `driveId`.\n\n - `domain`: Includes all searchable files shared with the user's domain.\n\n - `allDrives`: Includes all files in shared drives where the user is a\n member, and all files in \"My Drive\" and \"Shared with me.\"\n Use the `allDrives` corpora with caution as it has a broad scope and can\n affect performance. When possible, use `user` or `drive` instead of\n `allDrives` for efficiency.\n\n Files can move freely between `corpora` as permissions and ownership change.\n\nRelated topics\n--------------\n\nHere are a few next steps you might take:\n\n- Learn how to [Create and manage files](/workspace/drive/api/guides/create-file).\n- Learn how to [Create and populate folders](/workspace/drive/api/guides/folder).\n- Learn how to [Upload file data](/workspace/drive/api/guides/manage-uploads).\n- Learn how to [Download and export files](/workspace/drive/api/guides/manage-downloads).\n- Learn how to [Store application-specific data](/workspace/drive/api/guides/appdata).\n- Learn how to [Display the Google Picker](/workspace/drive/api/guides/picker) on a page."]]
