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

リクエスト

ファイルのサムネイルをリクエストするには、エンドポイントを使用します。
サムネイルの作成に成功すると、そのサムネイルがレスポンスの本文内でバイナリデータとして返されます。

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

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

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

以下のサムネイルの形式とサイズが使用可能です。 *が付いているサイズには、いくつかの制限があります。

ファイルサイズの制限

元のファイルサイズ

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

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

現時点でサポートされているファイルの種類は以下のとおりです。
最終更新日 2026年4月15日