En esta guía, se explica cómo crear y administrar archivos en Google Drive.
Crear archivo
Para crear un archivo en Drive que no contenga metadatos ni contenido, usa el método files.create
sin parámetros. El archivo recibe un kind
de drive.file
, un id
, un name
de “Untitled” y un mimeType
de application/octet-stream
. El uploadType
está marcado como obligatorio, pero su valor predeterminado es media
, por lo que no tienes que proporcionarlo.
Para obtener más información sobre los límites de archivos de Drive, consulta Límites de archivos y carpetas.
Crea archivos solo de metadatos
Los archivos de solo metadatos no incluyen contenido. Los metadatos son datos (como name
, mimeType
y createdTime
) que describen el archivo. Los campos como name
son independientes del usuario y aparecen iguales para cada usuario, mientras que los campos como viewedByMeTime
contienen valores específicos del usuario.
Un ejemplo de archivo de solo metadatos es una carpeta con el tipo de MIME application/vnd.google-apps.folder
. Para obtener más información, consulta Cómo crear y propagar carpetas. Otro ejemplo es un acceso directo que apunta a otro archivo de Drive con el tipo de MIME application/vnd.google-apps.shortcut
. Para obtener más información, consulta Cómo crear un acceso directo a un archivo de Drive.
Cómo administrar imágenes en miniatura
Las miniaturas ayudan a los usuarios a identificar los archivos de Drive. Drive puede generar miniaturas automáticamente para tipos de archivos comunes, o bien puedes proporcionar una imagen en miniatura generada por tu app. Para obtener más información, consulta Cómo subir miniaturas.
Cómo copiar un archivo existente
Para copiar un archivo y aplicar las actualizaciones solicitadas, usa el método files.copy
. Para encontrar el fileId
que se copiará, usa el método files.list
.
Ten en cuenta que debes usar un alcance de API de Drive adecuado para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Cómo elegir los permisos de la API de Google Drive.
Límites y consideraciones
Mientras te preparas para copiar archivos, ten en cuenta estos límites y consideraciones:
Permisos:
- La restricción de archivos
copyRequiresWriterPermission
determina quién puede copiar el archivo. Para obtener más información, consulta Cómo evitar que los usuarios descarguen, impriman o copien tu archivo. - El campo
capabilities/canCopy
de un recursofiles
determina si el usuario puede copiar un archivo. Para obtener más información, consulta Funciones. - El usuario que creó la copia es propietario del archivo copiado. No se replicará ninguna otra configuración de uso compartido del archivo de origen. Si la copia se crea en una carpeta compartida, hereda los permisos de esa carpeta.
- La propiedad de un archivo copiado puede cambiar y es posible que la copia no herede la configuración de uso compartido del archivo original. Es posible que debas restablecer esta configuración.
- La restricción de archivos
Administración de archivos:
- Algunos archivos, como los accesos directos de terceros, no se pueden copiar.
- Solo puedes copiar un archivo en una carpeta superior. No se admite la especificación de varios elementos superiores. Si no se especifica el campo
parents
, el archivo hereda los elementos superiores detectables del archivo fuente. - Si bien una carpeta es un tipo de archivo, no puedes copiar una carpeta.
En su lugar, crea una carpeta de destino y establece el campo
parents
de los archivos existentes en la carpeta de destino. Luego, puedes borrar la carpeta de origen original. - A menos que se especifique un nombre de archivo nuevo, el método
files.copy
genera un archivo con el mismo nombre que el original. - El uso excesivo de
files.copy
puede provocar que se excedan los límites de la cuota de la API de Drive. Para obtener más información, consulta Límites de uso.
Temas relacionados
Estos son algunos pasos que puedes probar:
Para subir datos de archivos cuando creas o actualizas un archivo, consulta Cómo subir datos de archivos.
Para crear un archivo en una carpeta específica, consulta Cómo crear un archivo en una carpeta específica.
Para trabajar con metadatos de archivos, consulta Administra metadatos de archivos.
Para borrar un archivo, consulta Papelera o borra archivos y carpetas.