Cómo crear y administrar archivos

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 tiene un kind de drive.file, un id, un name de "Sin título" y un mimeType de application/octet-stream. uploadType está marcado como obligatorio, pero el valor predeterminado es media, por lo que no tienes que proporcionarlo.

Para obtener más información sobre los límites de los archivos de Drive, consulta Límites de archivos y carpetas.

Crea archivos de solo metadatos

Los archivos de solo metadatos no contienen 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 un archivo solo de metadatos es una carpeta con el tipo MIME application/vnd.google-apps.folder. Para obtener más información, consulta Crea y propaga carpetas. Otro ejemplo es un acceso directo que dirige a otro archivo en Drive con el tipo MIME application/vnd.google-apps.shortcut. Para obtener más información, consulta Cómo crear un atajo a un archivo de Drive.

Administra 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 de miniatura que genere 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 alcances de Drive, consulta Cómo elegir los alcances de la API de Google Drive.

Límites y consideraciones

Cuando te prepares 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 recurso files determina si el usuario puede copiar un archivo. Para obtener más información, consulta Funciones.
    • El usuario que creó la copia es el propietario del archivo copiado. No se replica ningún otro parámetro de configuración de uso compartido del archivo fuente. Si la copia se crea en una carpeta compartida, hereda los permisos de esa carpeta.
    • Es posible que cambie la propiedad de un archivo copiado y que la copia no herede la configuración de uso compartido del archivo original. Es posible que debas restablecer esta configuración.

  • Administración de archivos:

    • Algunos archivos, como los atajos de terceros, nunca se pueden copiar.
    • Solo puedes copiar un archivo en una carpeta superior. No se admite especificar varios elementos superiores. Si no se especifica el campo parents, el archivo hereda cualquier elemento superior detectable del archivo fuente.
    • Aunque una carpeta es un tipo de archivo, no puedes copiarla. 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 produce un archivo con el mismo nombre que el original.
    • El uso excesivo de files.copy puede hacer que superes los límites de cuota de la API de Drive. Para obtener más información, consulta Límites de uso.

Estos son algunos pasos que puedes seguir: