Google Drive organiza los archivos en colecciones, describe los archivos por tipo y proporciona atributos específicos para cada archivo a fin de facilitar la manipulación.
La API de Google Drive representa los archivos almacenados en Drive como un recurso File
.
Responsabilidad
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 dentro de Drive. La principal diferencia entre Mi unidad y las colecciones de unidades compartidas es la propiedad de los archivos. Un solo usuario es propietario de los archivos en su Mi unidad, mientras que un grupo o una organización es propietario de los archivos de una unidad compartida.
- Mi unidad
- Cada usuario tiene una carpeta "raíz" llamada "Mi unidad" que funciona como su jerarquía principal y contiene todo lo que desciende de esa 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 se aloja en paralelo a Mi unidad. Puedes organizar un archivo individual dentro de una unidad compartida o Mi unidad, pero no ambos. Sin embargo, se pueden usar accesos directos de Drive para señalar archivos o carpetas de unidades compartidas a Mi unidad, o viceversa.
Tipos de archivo
Drive describe los archivos según su tipo. En esta lista, se muestran todos los tipos de archivos disponibles:
- BLOB
- Archivo que contiene texto o contenido binario, como imágenes, videos y PDF.
- Carpeta
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
.Nota: Un solo archivo almacenado en Mi unidad puede estar en varias carpetas. Un archivo almacenado en una unidad compartida solo puede tener una carpeta superior.
- Combinación de teclas
Es un archivo de solo metadatos que apunta a otro archivo de Drive. El tipo de MIME del archivo de acceso directo es
application/vnd.google-apps.shortcut
. Si deseas obtener más información, consulta Cómo crear un acceso directo a un archivo de Drive.- Acceso directo de terceros
Es un archivo de solo metadatos que se vincula al 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 Cómo crear un acceso directo a un archivo externo.- 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 de tipo de MIME es
application/vnd.google-apps.*app*
, en el que app es el nombre de la aplicación (comoapplication/vnd.google-apps.spreadsheet
para un archivo de Hojas de cálculo de Google). Para obtener una lista de los tipos de MIME específicos de Drive y Google Workspace, consulta Tipos de MIME compatibles con Google Workspace y Google Drive.
Nota: No puedes subir ni descargar carpetas, accesos directos, accesos directos de terceros ni documentos de Google Workspace desde o hacia Drive. Sin embargo, si usan formatos compatibles, puedes subir o exportar documentos de Google Workspace. Por ejemplo, puedes crear un documento de Google cuando importas un PDF. Del mismo modo, puedes exportar un archivo de Presentaciones de Google como un archivo de Microsoft PowerPoint.
Características del archivo
En esta lista, se muestran algunas características de un archivo de Drive:
- ID del archivo
- Un ID único y opaco para cada archivo. Los IDs de archivo son estables durante toda la vida del archivo, incluso si cambia el nombre. Las expresiones de búsqueda se usan para ubicar archivos por nombre, tipo, contenido, contenedor superior, propietario y otros metadatos.
- Metadatos
- Son 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 se muestran iguales para cada usuario. Otros campos, comocapabilities
yviewedByMeDate
, contienen valores específicos del usuario. Los tipos de archivo, como las imágenes y los videos, contienen metadatos adicionales extraídos de EXIF y otros metadatos incorporados. - Permiso
- Es un permiso de acceso para que un usuario, grupo, dominio o el mundo accedan a un archivo o 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.
- Contenido
- El objeto binario o el cuerpo de texto del archivo. Algunos ejemplos de contenido que puedes almacenar en Google Drive son las imágenes, los videos, el texto y el PDF.
- Historial de revisión
- Es el registro de cambios solo en el contenido del archivo, no en los metadatos del archivo. Para obtener más detalles sobre las revisiones, consulta Descripción general de cambios y revisiones.
- Thumbnail
- Representación gráfica de un archivo. Drive genera automáticamente miniaturas para muchos tipos de archivos comunes. Para los accesos directos y otros tipos de archivos que Drive no puede procesar, puedes proporcionar una imagen en miniatura.
Organización de archivos
La API de Drive organiza los archivos en ubicaciones de almacenamiento, denominadas spaces
,
y colecciones, llamadas corpora
.
- Espacios
Ubicaciones de almacenamiento específicas que están aisladas entre sí. Todo el contenido de Drive se almacena en uno de estos 2 espacios definidos:
drive
yappDataFolder
.drive
: Incluye todos los archivos visibles para el usuario creados en Drive. Los PDF, documentos, Documentos de Google, accesos directos y demás contenido que sube el usuario se encuentran en el espaciodrive
.appDataFolder
: Incluye datos de aplicación por usuario. Por lo general, las aplicaciones almacenan archivos de configuración y otros datos a los que los usuarios no pueden acceder directamente.
Los archivos no se pueden mover entre espacios.
- Corpora
Colecciones de archivos que se usan para reducir el alcance de las búsquedas de archivos y carpetas. La corpus de Drive es
user
,domain
,drive
yallDrives
.user
: Incluye todos los archivos creados y abiertos por el usuario en “Mi unidad”, y aquellos compartidos directamente con el usuario en “Compartidos conmigo”.drive
: Incluye todos los archivos contenidos en una sola unidad compartida, como lo indicadriveId
.domain
: Incluye todos los archivos de búsqueda compartidos con el dominio del usuario.allDrives
: Se incluyen todos los archivos de las unidades compartidas de las que es miembro el usuario, así como todos los archivos de “Mi unidad” y “Compartidos conmigo”. Usa corpusallDrives
con precaución, ya que tiene un alcance amplio y puede afectar el rendimiento. Cuando sea posible, usauser
odrive
en lugar deallDrives
para una mayor eficiencia.
Los archivos pueden moverse libremente entre corpus a medida que cambian los permisos y la propiedad.
Próximos pasos
Aquí hay algunos pasos que puedes seguir:
- Obtén información para subir datos de archivos a Drive.
- Obtén información para descargar y exportar archivos desde Drive.
- Obtén más información sobre cómo almacenar datos específicos de la aplicación.
- Obtén más información sobre cómo mostrar el selector de Google en una página.