Subidas

En partes, al bucket

Un archivo de más de 8 MiB va en partes, cada una a una dirección firmada para su longitud exacta, unas cuantas a la vez.

• POST /uploads dice adónde enviar cada parte; las partes van al bucket; POST /uploads/finish las une, y el servidor comprueba el tamaño que llegó antes de listar el archivo.
• Una parte que falla se reintenta, cinco veces con una espera más larga cada vez, desde lo que llegó. Archivos de hasta 5 GiB, salvo que maxSize diga otra cosa.
• El bucket debe exponer ETag en su regla de orígenes: la página lo lee de cada parte, y el servidor lo necesita para unirlas.

El panel de subidas

Tres archivos a la vez; cada uno dice cuánto ha subido, a qué velocidad y cuánto le queda, y lo mismo de todos juntos.

Uno se detiene, y lo que llegó de él se retira; uno que falló se reintenta desde lo que llegó. La velocidad es la de los últimos segundos, así que el tiempo restante sigue los cambios sin saltar a cada sacudida.

const { uploads, summary } = useUploads({ check: true });
// summary.remaining: seconds until all are up, at the speed all go at together
// uploads[i].remaining: the same, of one

Reanudadas tras un corte

Una subida cortada, o dejada al cerrar la página, sigue desde donde iba cuando el mismo archivo se vuelve a subir al mismo sitio.

// A file cut halfway, or left when the page closed, is uploaded again:
await client.upload(file, { parent });  // asks the server what arrived, sends the rest

La página lo recuerda en localStorage durante un día, mientras el servidor conserve las partes. Una que nunca se continúa espera en el bucket a una regla de ciclo de vida (“abortar subidas multiparte incompletas tras 1 día”).

Carpetas enteras

Soltada sobre el drive, o elegida con “Subir una carpeta”, una carpeta sube con todo lo que contiene: sus carpetas creadas de arriba abajo, también las vacías, y “(2)” para un nombre ya ocupado.

El mismo archivo, consultado

Antes de subir cada archivo, se busca en el drive.

Los bytes se distinguen por un SHA-256 hecho en la página, para archivos de hasta 64 MiB, guardado con la versión (POST /duplicates lo encuentra). “Hacer lo mismo con todos los demás” responde de una vez a todos los de un tipo. checkUploads={false} sube sin preguntar.

Lo que va con él

Hecho en la página y enviado tras el archivo, que queda subido tanto si llegan como si no.

• De una imagen, copias en los cuatro tamaños del drive y un placeholder de unos pocos píxeles: Vistas previas.
• De un archivo de texto o un documento de Word, lo que tiene escrito: Búsqueda.