メインコンテンツへスキップ
レプリゼンテーションとは、Boxに保存されているファイルの代替アセットです。このようなアセットには、PDF、サムネイル、またはテキスト抽出を使用できます。レプリゼンテーションを使用すると、ドキュメントからテキストを抽出して処理のために言語モデルに送信するなど、ファイルを手動で変換することなく、さまざまな形式のコンテンツにアクセスできます。 レプリゼンテーションは、Boxへのアップロード時またはアセットのリクエスト時に、サポートされているファイルの種類に対して自動的に生成されます。 このようなレプリゼンテーションは、fields=representationsクエリパラメータとx-rep-hintsヘッダーを使用することで、GET /files/:idエンドポイントを介して公開されます。 このワークフローでは以下の処理が行われます。
  1. ファイルの利用可能なレプリゼンテーションのリストを取得する。
  2. 特定のレプリゼンテーションのステータスを確認し、そのurl_templateを取得する。
  3. レプリゼンテーションをダウンロードする (利用可能な場合)。
Box Python SDKには、これらの機能にアクセスするためのfile.get_representation_info(rep_hints)メソッドが用意されています。