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

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

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

ファイルのサムネイルは、サムネイルAPIを使用して取得することもできます。

手順

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

• すべてのレプリゼンテーションのリストを取得する
• [jpg?dimensions=32x32]のように目的のサムネイル形式とサイズを表すX-Ref-Hintsヘッダーを渡して、サムネイルをリクエストする。
• url_templateを呼び出してサムネイルをダウンロードする。その際、{+asset_path}を空の文字列に置き換えます。

例

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

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

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

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

ファイルサイズの制限

2048x2048のJPEG

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

動画ファイル

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

元のファイルサイズ

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

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

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