基本的なサムネイルの取得

ガイド レプリゼンテーション 基本的なサムネイルの取得

基本的なサムネイルの取得

サムネイルとは小さい画像のことで、アプリケーション内でファイルのレプリゼンテーションとして使用できる.pngまたは.jpgで表されます。たとえば、ファイルをダウンロードまたはプレビューするリンクのプレースホルダとして使用されます。

ファイルのサムネイルを取得するには、レプリゼンテーションAPIを使用する方法をお勧めします。

リクエスト

ファイルのサムネイルをリクエストするには、GET /files/:id/thumbnail.:extensionエンドポイントを使用します。

cURL
curl -i -X GET "https://api.box.com/2.0/files/12345/thumbnail.png" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
.NET
Stream thumbnailContents = await client.FilesManager.GetThumbnailAsync("11111", maxWidth: 160, maxHeight: 160);
Python
file_id = '11111'

thumbnail = client.file(file_id).get_thumbnail_representation('92x92', extension='jpg')
iOS
client.files.getThumbnail(forFile: "11111", extension: .png) { (result: Result<Data, BoxSDKError>) in
    guard case let .success(thumbnailData) = result else {
        print("Error getting file thumbnail")
        return
    }

    let thumbnailImage = UIImage(data: thumbnailData)
}

サムネイルの作成に成功すると、そのサムネイルがレスポンスの本文内でバイナリデータとして返されます。

サムネイルの非同期的な作成

場合によっては、サムネイルを直接作成できないこともあります。代わりに、APIからlocationレスポンスヘッダーでHTTP 202が返されます。この場所は、サムネイルの生成中に使用できる一時的な画像のためのものです。

このエンドポイントを再試行するまでの推定秒数を示すretry-afterレスポンスヘッダーも返されます。

サポートされているファイルサイズ

以下のサムネイルの形式とサイズが使用可能です。

ファイルの種類サイズ
JPG32x32, 94x94, 160x160, 320x320, 1024x1024, 2048x2048*
PNG1024x1024*, 2048x2048*

*が付いているサイズには、いくつかの制限があります。

ファイルサイズの制限

元のファイルサイズ

サムネイルは拡大されません。Boxにアップロードされたファイルの元のファイルサイズがレプリゼンテーションのサイズより小さい場合は、作成されるサムネイルのサイズの上限は元のファイルのサイズになります。

サポートされているファイルの種類

現時点でサポートされているファイルの種類は以下のとおりです。

ファイルの種類ファイル拡張子
ドキュメントdoc, docx, gdoc, gsheet, gslide, gslides, odp, ods, odt, pdf, ppt, pptx, rtf, wpd, xls, xlsm, xlsx, key, pages, numbers
画像ai, bmp, dcm, dicm, eps, gif, idml, indd, indt, inx, jpeg, jpg, png, ps, psd, svg, svs, tif, tiff, tga
オーディオaac, aifc, aiff, amr, au, flac, m4a, mp3, ogg, ra, wav, wma
動画3g2, 3gp, avi, m2v, m2ts, m4v, mkv, mov, mp4, mpeg, mpg, mts, ogg, qt, wmv