Un enlace compartido (share) es un enlace a un objeto que puede caducar, revocarse, limitar el número de descargas y, en Pro y Enterprise, pedir una contraseña. Consulta Enlaces y compartir para ver cómo se comportan los enlaces.
¿Enlace compartido o downloadUrl()?
Usa downloadUrl() para enlaces de corta duración que repartes tú mismo, y un enlace compartido cuando necesites retirar el enlace o controlar quién lo descarga.
Crear un enlace compartido
El resultado tiene id, url, expires_at, max_downloads, password (si hay una definida), object y object_is_public.
Si object_is_public es true, el enlace compartido redirige a la URL pública permanente del objeto: la contraseña, el límite de descargas y la expiración no protegen nada, porque el archivo sigue accesible en esa URL. Haz primero el objeto privado y después compártelo: Listar enlaces compartidos
Devuelve un array de enlaces compartidos, cada uno con id, url, object, expires_at, remaining_downloads, password y created_at.
Revocar un enlace compartido
El enlace deja de funcionar. revoke() no se resuelve con ningún valor, y revocar un enlace compartido que no existe falla con SHARE_NOT_FOUND.
Eliminar, mover o renombrar el objeto, o cambiar su visibilidad, también rompe sus enlaces compartidos: apuntan al id antiguo. Crea nuevos enlaces compartidos para el nuevo id.
shares.create() y shares.revoke() tienen un único intento. Solo shares.list(), que es una lectura, se reintenta. 
