圧縮アーカイブをダウンロード
zipアーカイブのコンテンツをバイナリ形式で返します。このURLは、どのような形式の認証も要求せず、ユーザーのブラウザでユーザーのデバイスにアーカイブをダウンロードする際に使用できます。
デフォルトでは、このURLの有効期間は、このアーカイブに対するリクエストを作成してから数秒間だけです。いったんダウンロードが開始されると、停止して再開することはできません。代わりに、圧縮アーカイブに対する新しいリクエストを作成する必要があります。
このエンドポイントのURLは固定であるとは考えないでください。代わりに、圧縮ダウンロードを作成 APIを使用してzipアーカイブの作成をリクエストした後、このエンドポイントの応答にあるdownload_urlフィールドに従ってください。
リクエスト
application/json
パスパラメータ
stringパス内必須
Lu6fA9Ob-jyysp3AAvMF4AkLEwZwAYbL=tgj2zIC=eK9RvJnJbjJl9rNh2qBgHDpyOCAOhpM=vajg2mKq8Mddこのzipアーカイブを表す一意の識別子。
レスポンス
application/octet-stream
zipアーカイブのファイルおよびフォルダをストリームの形式にして、このダウンロードに対してリクエストされた項目のコンテンツを返します。
application/jsonクライアントエラー
このダウンロードリクエストのIDが無効な場合にエラーを返します。また、このエラーは、以前にこのURLが呼び出されている場合にも返されます。このアーカイブを再度ダウンロードするには、圧縮ダウンロードの新しいリクエストを作成してください。
application/jsonクライアントエラー
ユーザーまたは会社の同時実行圧縮ダウンロード数に達した場合にエラーを返します。
user_too_many_concurrent_downloads- ユーザーあたりの圧縮アーカイブの並行ダウンロード数が最大値5に達しました。enterprise_too_many_concurrent_downloads- 会社あたりの圧縮アーカイブの並行ダウンロード数が最大値10に達しました。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://dl.boxcloud.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/content"Java
ArrayList<BoxZipItem> items = new ArrayList<BoxZipItem>();
BoxZipItem file = new BoxZipItem("file", "12345");
BoxZipItem folder = new BoxZipItem("folder", "156472");
items.add(file);
items.add(folder);
BoxZip zip = new BoxZip(api);
FileOutputStream stream = new FileOutputStream();
BoxZipDownloadStatus zipDownloadStatus = zip.download("Another Awesome Zip File", items, stream);
stream.close();
if (zipDownloadStatus.getState() == BoxZipDownloadStatus.State.SUCCEEDED) {
System.out.println("Zip downloaded successfully");
}Node
var name = 'test',
items = [
{
type: 'file',
id: '466239504569'
},
{
type: 'folder',
id: '466239504580'
}
],
stream = new Readable();
client.files.downloadZip(name, items, stream)
.then(status => {
/* status -> {
"total_file_count": 20,
"downloaded_file_count": 10,
"skipped_file_count": 10,
"skipped_folder_count": 10,
"state": "succeeded"
}
*/
});