サムネイルレプリゼンテーションの取得

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

サムネイルレプリゼンテーションの取得

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

1024x1024および2048x2048のPNGを除くすべてのサムネイルレプリゼンテーションは、元のファイルをBoxにアップロードしたときに生成されます。

An deprecated way to get a thumbnail for a file is using the thumbnail API.

手順

サムネイルレプリゼンテーションを取得するには、以下の手順に従います。

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

A retry-after response header is also provided to present you with an estimated amount of seconds before retrying this endpoint.

x-rep-hintsヘッダーの値の例を以下に示します。

x-rep-hints: [jpg?dimensions=32x32]
32x32のJPEGサムネイルを返します。
x-rep-hints: [jpg?dimensions=32x32][jpg?dimensions=1024x1024]
32x32および1024x1024のJPEGサムネイルを返します。
x-rep-hints: [jpg?dimensions=32x32][png?dimensions=2048x2048]
32x32のJPEGサムネイルおよび2048x2048のPNGサムネイルを返します。
x-rep-hints: [jpg?dimensions=2048x2048,png?dimensions=2048x2048]
2048x2048のJPEGサムネイルおよび2048x2048のPNGサムネイルを返し、使用可能な最初のレプリゼンテーションを返します。どちらも使用可能でない場合は、レプリゼンテーションは返されません。

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

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

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

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

ファイルサイズの制限

2048x2048のJPEG

2048x2048サイズのJPEGを使用できるのは、元のファイルがJPEGの場合のみです。このサイズを使用する場合は、PNGか、PNGとJPEGの両方をリクエストすることをお勧めします。

動画ファイル

2048x2048のJPEG、2048x20148のPNG、および1024x1024のPNGのレプリゼンテーションは、動画ファイルでは使用できません。

元のファイルサイズ

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

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

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

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

For document file types the representation returned will be a placeholder icon and not an actual thumbnail.