Eine Freigabe ist ein Link zu einem Objekt, der ablaufen, widerrufen werden, die Anzahl der Downloads begrenzen und bei Pro und Enterprise ein Passwort abfragen kann. Wie sich die Links verhalten, erfährst du unter Links und Freigabe.
Freigabe oder downloadUrl()?
Verwende downloadUrl() für kurzlebige Links, die du selbst weitergibst, und eine Freigabe, wenn du den Link zurücknehmen oder kontrollieren musst, wer herunterlädt.
Eine Freigabe erstellen
Das Ergebnis hat id, url, expires_at, max_downloads, password (ob eines gesetzt ist), object und object_is_public.
Ist object_is_public gleich true, leitet der Freigabelink auf die dauerhafte öffentliche URL des Objekts weiter: Passwort, Download-Limit und Ablauf schützen nichts, weil die Datei unter dieser URL erreichbar bleibt. Mache das Objekt zuerst privat und gib es dann frei: Freigaben auflisten
Gibt ein Array von Freigaben zurück, jede mit id, url, object, expires_at, remaining_downloads, password und created_at.
Eine Freigabe widerrufen
Der Link funktioniert nicht mehr. revoke() wird ohne Wert aufgelöst, und das Widerrufen einer Freigabe, die nicht existiert, schlägt mit SHARE_NOT_FOUND fehl.
Das Löschen, Verschieben oder Umbenennen des Objekts oder eine Änderung seiner Sichtbarkeit macht seine Freigabelinks ebenfalls ungültig: Sie verweisen auf die alte ID. Erstelle neue Freigaben für die neue ID.
shares.create() und shares.revoke() erhalten einen einzigen Versuch. Nur shares.list(), ein Lesevorgang, wird wiederholt. 
