.pngまたは.jpgで表されます。たとえば、ファイルをダウンロードまたはプレビューするリンクのプレースホルダとして使用されます。
ファイルのサムネイルを取得するには、レプリゼンテーションAPIを使用する方法をお勧めします。
リクエスト
ファイルのサムネイルをリクエストするには、GET /files/:id/thumbnail.:extensionエンドポイントを使用します。
サムネイルの非同期的な作成
場合によっては、サムネイルを直接作成できないこともあります。代わりに、APIからlocationレスポンスヘッダーでHTTP 202が返されます。この場所は、サムネイルの生成中に使用できる一時的な画像のためのものです。
このエンドポイントを再試行するまでの推定秒数を示すretry-afterレスポンスヘッダーも返されます。
サポートされているファイルサイズ
以下のサムネイルの形式とサイズが使用可能です。| ファイルの種類 | サイズ |
|---|---|
| JPG | 32x32, 94x94, 160x160, 320x320, 1024x1024, 2048x2048* |
| PNG | 1024x1024*, 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 |