Un partage est un lien vers un objet qui peut expirer, être révoqué, limiter le nombre de téléchargements et, sur Pro et Enterprise, demander un mot de passe. Voir Liens et partage pour le comportement des liens.
Partage ou downloadUrl() ?
Utilisez downloadUrl() pour des liens de courte durée que vous distribuez vous-même, et un partage lorsque vous devez pouvoir retirer le lien ou contrôler qui télécharge.
Créer un partage
Le résultat contient id, url, expires_at, max_downloads, password (indique si un mot de passe est défini), object et object_is_public.
Si object_is_public vaut true, le lien de partage redirige vers l’URL publique permanente de l’objet : le mot de passe, la limite de téléchargements et l’expiration ne protègent rien, car le fichier reste accessible à cette URL. Rendez d’abord l’objet privé, puis partagez-le : Lister les partages
Renvoie un tableau de partages, chacun avec id, url, object, expires_at, remaining_downloads, password et created_at.
Révoquer un partage
Le lien cesse de fonctionner. revoke() ne renvoie rien, et révoquer un partage qui n’existe pas échoue avec SHARE_NOT_FOUND.
Supprimer, déplacer ou renommer l’objet, ou modifier sa visibilité, casse aussi ses liens de partage : ils pointent vers l’ancien identifiant. Créez de nouveaux partages pour le nouvel identifiant.
shares.create() et shares.revoke() ont droit à une seule tentative. Seule shares.list(), une lecture, fait l’objet de nouvelles tentatives. 
