ファイルライブラリ
ファイルライブラリには、現在のアカウントがアクセス可能なソースファイル、ジョブ結果、およびアプリファイルが表示されます。各項目には固有の file_id が付与されており、呼び出し元が現在実行可能な操作を返します。
翻訳の入力として使用されるドキュメントにも、/api/v1/documents のリスト、詳細表示、更新、削除エンドポイントがあります。document_id は処理ジョブの作成に使用され、file_id はライブラリ全体の権限およびダウンロードに使用されます。これら2つの ID が互換性があると想定しないでください。
GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}リスト応答:
{ "items": [ { "id": "x7m4q2k9n6c1v8pa", "name": "report.docx", "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "size_bytes": 45678, "status": "ready", "publication_status": "draft", "origin": { "product_code": "omnidoc-main", "display_name": "OmniDoc" }, "capabilities": { "can_view": true, "can_download": true, "can_update": true, "can_delete": true, "can_share": true }, "created_at": "2026-10-01T12:00:00Z", "updated_at": "2026-10-01T12:00:00Z" } ], "has_more": true, "next_offset": 50}次のページを取得するには、offset に next_offset を渡してください。false が has_more になったら停止します。
各アイテムのcapabilitiesを必ず使用して、ダウンロード、共有、またはアプリへの付与が可能かどうかを判断してください。元のフィールドから権限を推測しないでください。
ダウンロード
Section titled “ダウンロード”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content は一時的なダウンロードアドレスへ(302)リダイレクトします。リダイレクト先にアクセスする際は API キーを送信しないでください。まず download-ticket を取得することを推奨します。有効期限が切れた後は新しいアドレスを取得し、保存しないでください。
権限とリンク
Section titled “権限とリンク”GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}権限の変更と公開リンクは別々の機能です。リンクを作成する際は、対象者、ダウンロード権限、有効期限、およびオプションでダウンロード回数を明示的に設定し、不要になったら速やかに無効化してください。
ワークスペース ビュー
Section titled “ワークスペース ビュー”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsワークスペースのエンドポイントはファイルセンターに適しており、/storage/filesは単一ファイルに対する権限およびダウンロード操作に適しています。