> ## Documentation Index > Fetch the complete documentation index at: https://developer.box.com/llms.txt > Use this file to discover all available pages before exploring further. # コンテンツを検索 > ユーザーのコンテンツまたは会社全体でファイル、フォルダ、ウェブリンク、および共有ファイルを検索します。 このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 [**Box APIのバージョン管理**](/ja/guides/api-calls/api-versioning-strategy/)を参照してください。 「[Box SDKのバージョニング戦略](/ja/guides/tooling/sdks/sdk-versioning/)について詳しく学ぶ。」 ## OpenAPI ````yaml box-openapi-jp.json GET /search openapi: 3.0.2 info: title: Box Platform API description: >- [Box Platform](https://developer.box.com)では、[Box](https://box.com)内に保存されているコンテンツへのアクセス権限を付与する機能が提供されています。また、ファイルとフォルダの基本操作、会社内のユーザーの管理、リーガルホールドやリテンションポリシーなどの複雑なトピックのためのエンドポイントも提供されています。 termsOfService: https://cloud.app.box.com/s/rmwxu64h1ipr41u49w3bbuvbsa29wku9 contact: name: Box, Inc url: https://developer.box.com email: devrel@box.com license: name: Apache-2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: '2024.0' x-box-commit-hash: e1aaef784a servers: - url: https://api.box.com/2.0 description: Box Platform APIサーバー。 security: - OAuth2Security: [] tags: - name: AI description: サポート対象のLLMの操作に使用される、一連のエンドポイント。 x-box-tag: ai - name: AI Studio description: AI Studioの操作に使用される、一連のエンドポイント。 x-box-tag: ai_studio - name: アプリ項目の関連付け x-box-tag: app_item_associations - name: 承認 description: ユーザー承認プロセスを管理するために使用される、一連のエンドポイント。 x-box-tag: authorization x-box-priority: true - name: Box Signリクエスト description: Box Signリクエストは、署名用ファイルを送信するために使用されます。 x-box-tag: sign_requests - name: Classifications description: 分類ラベルは、機密性の高いコンテンツやセキュリティ上の制限が適用されるコンテンツに使用されます。 x-box-tag: classifications - name: ファイルの分類 description: 分類ラベルは、機密性の高いファイルやセキュリティ上の制限が適用されるファイルに使用されます。 x-box-tag: file_classifications - name: フォルダの分類 description: 分類ラベルは、機密性の高いフォルダやセキュリティ上の制限が適用されるフォルダに使用されます。 x-box-tag: folder_classifications - name: Collaborations description: コラボレーションは、アクセス制限リストと同様に、ユーザーやグループがファイルやフォルダにアクセスする際の権限を定義します。 x-box-tag: user_collaborations - name: コラボレーション (リスト) description: ファイル、フォルダ、保留、グループコラボレーションを取得するために使用される、一連のエンドポイント。 x-box-tag: list_collaborations - name: Collections description: コレクションを利用して、ファイル、フォルダ、ウェブリンクを1つのフォルダにまとめることなくグループ化できます。 x-box-tag: collections - name: Comments description: >- コメントは、ユーザーがファイルに対して生成するメッセージです。コメントを使用すると、複数のユーザーがファイル上でコラボレーションし、コンテンツに対するフィードバックについて話し合うことができます。 x-box-tag: comments - name: Device Pinners description: Device Pinnerを使用すると、どのデバイスでネイティブBoxアプリケーションの使用を許可するかを企業レベルで制御できます。 x-box-tag: device_pinners - name: ドメインの制限 (ユーザーの除外) description: 特定の企業に許可されたコラボレーションドメインのリストによって課せられた制限からユーザーを除外できる、一連のエンドポイント。 x-box-tag: collaboration_allowlist_exempt_targets - name: コラボレーションに対するドメインを制限 description: ユーザーが企業のファイルやフォルダでコラボレーションできるドメインを管理する、一連のエンドポイント。 x-box-tag: collaboration_allowlist_entries - name: ダウンロード description: ダウンロードを利用して、ファイルをアプリケーションのサーバーに保存することも、エンドユーザーがブラウザで直接保存することもできます。 x-box-tag: downloads - name: メールエイリアス description: メールエイリアスを使用することで、ユーザーのログイン用プライマリメールアドレスに加えて複数のメールアドレスを指定できます。 x-box-tag: email_aliases - name: Events description: イベントを利用して、企業内の任意のユーザー (複数可) またはサービスによって実行される操作をアプリケーションが登録できます。 x-box-tag: events - name: ファイルリクエスト description: >- ファイルリクエストを利用すると、任意のユーザーに対してファイルとそれに関連付けられたメタデータを迅速かつ安全にリクエストできます。ユーザーは、既存のファイルリクエストを基にして新しいファイルリクエストを作成できるほか、ファイルリクエストの設定を更新したり、プログラムによってファイルリクエストの有効化、無効化、削除を実行したりできます。 x-box-tag: file_requests - name: ファイルバージョンリーガルホールド description: >- リーガルホールドとは、係争中の訴訟や当然予期される訴訟で、関連する可能性のあるさまざまな形式の情報を企業が保全するために利用できるプロセスのことです。ファイルバージョンリーガルホールドは、特定のファイルバージョンに割り当てられているすべてのポリシーを表します。 x-box-tag: file_version_legal_holds - name: ファイルバージョンリテンション description: >- リテンションポリシーは、指定した期間にわたってコンテンツが完全に削除されるのを防止します。ファイルバージョンリテンションとは、保持されているファイルバージョンのレコードです。 x-box-tag: file_version_retentions - name: ファイルバージョン description: ファイルの特定のバージョンを管理するために使用される、一連のエンドポイント。 x-box-tag: file_versions - name: Files description: >- ファイルは、フォルダとともに、Box APIの中核を成します。ファイルはアップロードおよびダウンロードが可能で、コンテンツに関する重要なメタデータ情報を保持できます。 x-box-tag: files - name: フォルダロック description: フォルダロックでは、特定のフォルダが移動または削除されないように、フォルダ所有者によって設定されるアクセス制限を定義します。 x-box-tag: folder_locks - name: Folders description: >- フォルダは、ファイルとともに、Box APIの中核を成します。フォルダはアップロードおよびダウンロードが可能で、コンテンツに関する重要なメタデータ情報を保持できます。 x-box-tag: folders - name: 統合マッピング description: 統合マッピングを使用すると、ユーザーはパートナーアプリからのコンテンツがBoxのどこに保存されるかを管理できます。 x-box-tag: integration_mappings - name: グループメンバーシップ description: グループメンバーシップは、ユーザーがグループに属していることを示します。 x-box-tag: memberships - name: Groups description: 企業内に作成されたグループ。 x-box-tag: groups - name: Invites description: 招待は、ユーザーを企業に招待するために使用されます。 x-box-tag: invites - name: リーガルホールドポリシー description: >- リーガルホールドとは、係争中の訴訟や当然予期される訴訟で、関連する可能性のあるさまざまな形式の情報を企業が保全するために利用できるプロセスのことです。 x-box-tag: legal_hold_policies - name: リーガルホールドポリシー割り当て description: >- リーガルホールドポリシー割り当ては、ポリシーとカストディアンの関係です。この場合、カストディアンにはユーザー、フォルダ、ファイル、またはファイルバージョンを指定できます。 x-box-tag: legal_hold_policy_assignments - name: メタデータカスケードポリシー description: メタデータカスケードポリシーには、フォルダに適用されているメタデータインスタンスを、そのフォルダ内の項目にどのように適用するかが記載されています。 x-box-tag: metadata_cascade_policies - name: メタデータインスタンス (ファイル) description: メタデータインスタンスには、テンプレートとファイル間の関係が記載されています。これには、各フィールドに割り当てられている値が含まれます。 x-box-tag: file_metadata - name: メタデータインスタンス (フォルダ) description: メタデータインスタンスには、テンプレートとフォルダ間の関係が記載されています。これには、各フィールドに割り当てられている値が含まれます。 x-box-tag: folder_metadata - name: メタデータ階層 description: メタデータ階層とは、企業内のメタデータを整理して管理するために役立つ、階層型分類システムです。 x-box-tag: metadata_taxonomies - name: メタデータテンプレート description: メタデータテンプレートには、ファイルに割り当てることができる、一連の再利用可能なキー/値ペアが記載されています。 x-box-tag: metadata_templates - name: 最近使用した項目 description: 最近使用した項目は、ユーザーが最近アクセスしたファイルやフォルダなどの項目を表します。 x-box-tag: recent_items - name: リテンションポリシー description: >- リテンションポリシーは、指定した期間にわたってコンテンツが完全に削除されるのを防止します。管理者はリテンションポリシーを作成して特定のフォルダや企業全体に割り当てることができます。 x-box-tag: retention_policies - name: リテンションポリシー割り当て description: >- リテンションポリシー割り当ては、ポリシーとフォルダや企業の関係です。割り当てを作成すると、そのフォルダや企業に属するすべてのファイルバージョンにリテンションが適用されます。 x-box-tag: retention_policy_assignments - name: 検索 description: Box APIを使用すると、ファイルコンテンツ検索クエリを使用してBox内のコンテンツを探すことができます。 x-box-tag: search - name: セッション終了 description: セッション終了APIを使用すると、グループのロールと権限を検証し、グループのセッションを終了させる非同期ジョブを作成できます。 x-box-tag: session_termination - name: 共有リンク (ファイル) description: >- ファイル共有リンクは、Boxに保存されているファイルを対象として生成されるURLです。これにより、リソースへの直接的な読み取り専用アクセスが可能になります。 x-box-tag: shared_links_files - name: 共有リンク (フォルダ) description: >- フォルダ共有リンクは、Boxに保存されているフォルダを対象として生成されるURLです。これにより、リソースへの直接的な読み取り専用アクセスが可能になります。 x-box-tag: shared_links_folders - name: 共有リンク (ウェブリンク) description: >- ファイル用ウェブリンクは、Box内のウェブリンクを対象として生成されるURLです。これにより、リソースへの直接的な読み取り専用アクセスが可能になります。 x-box-tag: shared_links_web_links - name: 共有リンク (アプリ項目) description: Boxに保存されているアプリ項目に対して生成されるURL。これにより、リソースへの直接的な読み取り専用アクセスが可能になります。 x-box-tag: shared_links_app_items - name: Shield情報バリア description: >- BoxのShield情報バリアは、倫理的境界を定義します。倫理的境界とは、利益相反につながり、結果として倫理的または法的に問題のあるビジネス活動につながる可能性があるやり取りまたは通信を防ぐメカニズムです。 x-box-tag: shield_information_barriers - name: Shield情報バリアのセグメント description: >- Shield情報バリアのセグメントは、ユーザーの定義済みグループを表します。セグメントがグループと異なる点は、ユーザーが所属できるセグメントが1つのみであることです。 x-box-tag: shield_information_barrier_segments - name: Shield情報バリアのセグメントメンバー description: Shield情報バリアのセグメントメンバーは、特定のセグメントに割り当てられたユーザーを表します。 x-box-tag: shield_information_barrier_segment_members - name: Shield情報バリアレポート description: Shield情報バリアレポートには、情報バリアが有効化されるときに完全に削除される既存のコラボレーションに関する情報が含まれます。 x-box-tag: shield_information_barrier_reports - name: Shield情報バリアのセグメント制限 description: Shield情報バリアのセグメント制限とは、コンテンツ (ファイルまたはフォルダ) の所有者に基づいて適用されるアクセス制限です。 x-box-tag: shield_information_barrier_segment_restrictions - name: Box Signテンプレート description: >- 署名テンプレートを使用すると、署名リクエストの作成時に、あらかじめ定義されたBox Signテンプレートを使用できます。このテンプレートに含まれるプレースホルダには、リクエストの作成時にデータが自動的に入力されます。 x-box-tag: sign_templates - name: Skills description: >- Box Skillsは、ファイルの基盤となるメタデータを強化することを目的として、Boxにアップロードされたファイルにカスタム処理を実行するための機能です。 x-box-tag: skills - name: 標準およびZonesのストレージポリシー description: ストレージポリシー割り当ては、特定の企業内の項目に対するストレージゾーンを表します。 x-box-tag: storage_policies - name: 標準およびZonesのストレージポリシー割り当て description: ストレージポリシー割り当ては、ストレージゾーンと割り当てられた項目 (特定のゾーンに保存されているファイルなど) の間の関係を表します。 x-box-tag: storage_policy_assignments - name: タスク割り当て description: タスク割り当てでは、完了するためにどのタスクをどのユーザーに割り当てるかを定義します。 x-box-tag: task_assignments - name: Tasks description: >- ユーザーはタスクを使用することで、ファイルのコラボレータに対して、ファイルのレビューや作業の一部の完了をリクエストできます。タスクは、開発者がファイル中心のワークフローを作成するために使用できます。 x-box-tag: tasks - name: サービス利用規約 description: サービス利用規約を管理するために使用される、一連のエンドポイント。 x-box-tag: terms_of_services - name: サービス利用規約のユーザーステータス description: 特定ユーザーのサービス利用規約のステータスを管理するために使用される、一連のエンドポイント。 x-box-tag: terms_of_service_user_statuses - name: フォルダの移動 description: ユーザーが所有するすべての項目 (ファイル、フォルダ、およびワークフロー) を別のユーザーのアカウントに移動するためのAPI。 x-box-tag: transfer - name: ごみ箱内のファイル description: 削除されて現在ごみ箱にあるファイル。 x-box-tag: trashed_files - name: ごみ箱内のフォルダ description: 削除されて現在ごみ箱にあるフォルダ。 x-box-tag: trashed_folders - name: ごみ箱内の項目 description: 削除されて現在ごみ箱にある項目。 x-box-tag: trashed_items - name: ごみ箱内のウェブリンク description: 削除されて現在ごみ箱にあるウェブリンク。 x-box-tag: trashed_web_links - name: アップロード description: >- 直接ファイルアップロードAPIは最大50 MBのファイルをサポートしており、1回のAPIリクエストですべてのバイナリデータをBox APIに送信します。 x-box-tag: uploads - name: アップロード (分割) description: >- 分割アップロードエンドポイントは20 MB以上のファイルをサポートしており、アプリケーションでファイルを複数のパーツに分割してアップロードすることで、エラーのキャッチと個別のパーツの再送信を詳細に制御できます。 x-box-tag: chunked_uploads - name: ユーザーのアバター description: >- ユーザーのアバターとは、ユーザー画像を表すためにBoxにアップロードされたJPGファイルまたはPNGファイルです。これはユーザーアカウントで表示されます。 x-box-tag: avatars - name: Users description: >- Box APIは、管理対象ユーザーアカウントでログインする実際の従業員や、App Userを使用して強力な自動化ワークフローを推進するアプリケーションなど、さまざまなユーザーをサポートしています。 x-box-tag: users - name: 電子すかし (ファイル) description: >- 電子すかしとは、埋め込みファイルのプレビューに適用される半透明のオーバーレイです。電子すかしには、ビューアーのメールアドレスまたはユーザーIDと、ファイルのアクセス日時が表示されます。 x-box-tag: file_watermarks - name: 電子すかし (フォルダ) description: >- 電子すかしとは、埋め込みフォルダのプレビューに適用される半透明のオーバーレイです。電子すかしには、ビューアーのメールアドレスまたはユーザーIDと、フォルダコンテンツのアクセス日時が表示されます。 x-box-tag: folder_watermarks - name: ウェブリンク description: ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。 x-box-tag: web_links - name: Webhooks description: >- Webhookを使用すると、Boxコンテンツのイベントを監視し、イベントの発生時に任意のURLへの通知を受け取ることができます。たとえば、ファイルがダウンロードされるのを待ち、ダウンロード後に共有リンクを削除するワークフローを作成できます。 x-box-tag: webhooks - name: ワークフロー (リスト) description: Box Relayワークフローは、名前が付けられたフローのコレクションを表すオブジェクトです。 x-box-tag: workflows - name: zipダウンロード description: zipダウンロードは、ファイルやフォルダを含むZIPアーカイブを作成するリクエストが成功したことを表します。 x-box-tag: zip_downloads externalDocs: description: Box Developerドキュメント。 url: https://developer.box.com paths: /search: get: tags: - 検索 summary: コンテンツを検索 description: ユーザーのコンテンツまたは会社全体でファイル、フォルダ、ウェブリンク、および共有ファイルを検索します。 operationId: get_search parameters: - name: query in: query description: >- 検索する文字列。このクエリは、項目名、説明、ファイルのテキストコンテンツなど、さまざまな項目タイプのフィールドと照合されます。 このパラメータでは、返された結果をさらに絞り込むためのさまざまな演算子がサポートされます。 - `""` - クエリを二重引用符で囲むと、APIによって完全一致のみが返されます。完全一致検索では、特定の文字の並びに基づいた検索結果は返されません。代わりに、フレーズ (つまり、単語の並び) に基づいた一致が返されます。たとえば、`"Blue-Box"`を検索すると、`"blue.box"`、`"Blue Box"`、`"Blue-Box"`などの並びを含む、検索結果が返されます。つまり、`Blue`および`Box`という単語が指定した順序で連続して含まれている項目です。 - `AND` - 両方の検索語句を含む項目が返されます。たとえば、`marketing AND BoxWorks`を検索すると、`marketing`と`BoxWorks`の両方が任意の順番でテキストに含まれている項目が返されます。テキストに`BoxWorks`のみが含まれる結果は返されません。 - `OR` - 検索語句のいずれかを含む項目が返されます。たとえば、`marketing OR BoxWorks`を検索すると、`marketing`と`BoxWorks`のいずれかがテキストに含まれている結果が返されます。サポートされている別のブール条件が使用されている場合を除き、複数語のクエリは暗黙的に`OR`として解釈されるため、この演算子の使用は必須ではありません。 - `NOT` - 指定された検索語句が含まれていない項目が返されます。たとえば、`marketing AND NOT BoxWorks`を検索すると、テキストに`marketing`のみが含まれている結果が返され、`BoxWorks`が含まれる結果は省略されます。 小文字の演算子 (`and`、`or`および`not`) および大文字と小文字を組み合わせた演算子 (`And`、`Or`および`Not`) はサポートされていません。 このフィールドは、`mdfilters`パラメータが定義されていない場合に必須です。 required: false schema: type: string example: sales - name: scope in: query description: >- ユーザーがアクセスできるファイルまたは会社全体で利用可能なファイルに検索結果を絞り込みます。 スコープは、デフォルトで`user_content`に設定されます。これにより、検索結果は、現在認証されているユーザーが使用できるコンテンツに絞り込まれます。 `enterprise_content`は、管理者がサポートチャネルを通じてリクエストできます。このスコープがユーザーに対して有効になっていると、そのユーザーは、アクセスできるコンテンツだけでなく、会社全体のコンテンツに対してクエリを実行できます。 required: false schema: type: string default: user_content enum: - user_content - enterprise_content example: user_content - name: file_extensions in: query description: >- 指定したファイル拡張子のいずれかと一致するファイルのみに検索結果を絞り込みます。このリストは、ドットなしのファイル拡張子のコンマ区切りリストです。 required: false schema: type: array items: type: string example: - pdf - png - gif explode: false - name: created_at_range in: query description: >- 指定した日付範囲内に作成されたすべての項目に検索結果を絞り込みます。 日付範囲はコンマ区切りのRFC3339タイムスタンプとして定義されます。 開始日が省略されている場合 (`,2014-05-17T13:35:01-07:00`)、終了日より前に作成された項目がすべて返されます。 終了日が省略されている場合 (`2014-05-15T13:35:01-07:00,`)、代わりに現在の日付が終了日として使用されます。 required: false schema: type: array items: type: string example: - '2014-05-15T13:35:01-07:00' - '2014-05-17T13:35:01-07:00' explode: false - name: updated_at_range in: query description: |- 指定した日付範囲内に更新された項目に検索結果を絞り込みます。 日付範囲はコンマ区切りのRFC3339タイムスタンプとして定義されます。 開始日が省略されている場合 (`,2014-05-17T13:35:01-07:00`)、終了日より前に更新された項目が返されます。 終了日が省略されている場合 (`2014-05-15T13:35:01-07:00,`)、代わりに現在の日付が終了日として使用されます。 required: false schema: type: array items: type: string example: - '2014-05-15T13:35:01-07:00' - '2014-05-17T13:35:01-07:00' explode: false - name: size_range in: query description: |- 特定のファイルサイズ範囲内のサイズの項目に検索結果を絞り込みます。これはファイルとフォルダに適用されます。 サイズ範囲は、バイトサイズの下限と上限 (下限と上限も含む) のコンマ区切りリストとして定義します。 上限または下限を省略すると、上限または下限のないサイズ範囲を指定できます。 required: false schema: type: array items: type: integer example: - 1000000 - 5000000 explode: false - name: owner_user_ids in: query description: >- 指定した所有者リスト (ユーザーIDのコンマ区切りリストとして定義) によって所有される項目のみに検索結果を絞り込みます。 検索結果に項目が表示されるように、項目は現在認証されているユーザーによって所有または共有されている必要もあります。いずれかのユーザーが所有するファイルにユーザーがアクセスできない場合は、空の結果セットが返されます。 会社全体で検索するには、サポートチームにリクエスト可能な`enterprise_content`スコープパラメータを使用することをお勧めします。 required: false schema: type: array items: type: string example: - '123422' - '23532' - '3241212' explode: false - name: recent_updater_user_ids in: query description: >- 指定したユーザーリスト (ユーザーIDのコンマ区切りリストとして定義) によって更新された項目のみに検索結果を絞り込みます。 検索結果に項目が表示されるように、項目は現在認証されているユーザーによって所有または共有されている必要もあります。いずれかのユーザーが所有するファイルにユーザーがアクセスできない場合は、空の結果セットが返されます。 この機能では、項目の過去10バージョンのみを検索します。 required: false schema: type: array items: type: string example: - '123422' - '23532' - '3241212' explode: false - name: ancestor_folder_ids in: query description: >- フォルダIDのコンマ区切りリストとして定義された、指定したフォルダリスト内の項目のみに検索結果を絞り込みます。 検索結果には、これらの先祖フォルダのサブフォルダ内の項目も含まれます。 フォルダは現在認証されているユーザーによって所有または共有されている必要もあります。このユーザーがフォルダにアクセスできない場合、またはフォルダがない場合は、代わりに`HTTP 404`エラーコードが返されます。 会社全体で検索するには、サポートチームにリクエスト可能な`enterprise_content`スコープパラメータを使用することをお勧めします。 required: false schema: type: array items: type: string example: - '4535234' - '234123235' - '2654345' explode: false - name: content_types in: query description: >- ファイルの説明など、ファイルの特定の部分に対する検索クエリと一致する項目のみに検索結果を絞り込みます。 コンテンツタイプの定義には、Boxで認識されるコンテンツタイプのコンマ区切りリストを使用します。許可されるコンテンツタイプは以下のとおりです。 - `name` - `name`フィールドで定義されている、項目の名前。 - `description` - `description`フィールドで定義されている、項目の説明。 - `file_content` - ファイルの実際のコンテンツ。 - `comments` - ファイルまたはフォルダに対するコメントのコンテンツ。 - `tags` - `tags`フィールドで定義されている、項目に適用されるタグ。 required: false schema: type: array items: type: string enum: - name - description - file_content - comments - tags example: - name - description explode: false - name: type in: query description: >- このタイプの項目に検索結果を絞り込みます。このパラメータが受け取る値は1つだけです。デフォルトでは、このAPIによって、以下のいずれかのタイプと一致する項目が返されます。 - `file` - 検索結果をファイルに絞り込みます。 - `folder` - 検索結果をフォルダに絞り込みます。 - `web_link` - 検索結果をウェブリンク (ブックマークとも呼ばれます) に絞り込みます。 required: false schema: type: string enum: - file - folder - web_link example: file - name: trash_content in: query description: |- 検索時にごみ箱で項目を探すかどうかを決定します。 デフォルトでは、このAPIで返されるのは、現在ごみ箱にない項目の検索結果のみです (`non_trashed_only`)。 - `trashed_only` - 現在ごみ箱にある項目のみを検索します。 - `non_trashed_only` - 現在ごみ箱にない項目のみを検索します。 - `all_items` - ごみ箱内の項目とごみ箱にない項目の両方を検索します。 required: false schema: type: string default: non_trashed_only enum: - non_trashed_only - trashed_only - all_items example: non_trashed_only - name: mdfilters in: query description: >- 指定したフィルタとメタデータが一致する項目のみに検索結果を絞り込みます。このパラメータは、検索結果のフィルタに使用するメタデータテンプレートを**1つ**だけ指定するリストです。このパラメータは、`query`パラメータが指定されていない場合に必須です。 required: false schema: type: array items: $ref: '#/components/schemas/MetadataFilter' maxItems: 1 minItems: 1 example: - scope: enterprise templateKey: contract filters: - category: online - contractValue: 100000 - name: sort in: query description: >- 結果が返される順序を定義します。このパラメータが明示的に指定されていない限り、このAPIはデフォルトで、関連度を基準として項目を返します。 - `relevance` (デフォルト) を指定すると、クエリの検索語句との関連度を基準として並べ替えられた結果が返されます。関連度は、項目の名前、説明、コンテンツ、およびその他のプロパティでの検索語句の出現回数に基づきます。 - `modified_at`を指定すると、項目が最後に変更された日付を基準にして降順で並べ替えられた結果が返されます。 required: false schema: type: string default: relevance enum: - modified_at - relevance example: modified_at - name: direction in: query description: >- 検索結果の並べ替えの方向を定義します。このパラメータが明示的に指定されていない限り、このAPIはデフォルトで、降順 (`DESC`) で項目を返します。 結果が`relevance`を基準にして並べ替えられると、関連度の降順で項目が返されるよう並べ替えはロックされ、このパラメータは無視されます。 required: false schema: type: string default: DESC enum: - DESC - ASC example: ASC - name: limit in: query description: 結果ページの一部として返す項目の最大数を定義します。 required: false schema: type: integer format: int64 default: 30 maximum: 200 example: 100 - name: include_recent_shared_links in: query description: >- ユーザーが最近共有リンクを介してアクセスした項目を検索結果に含めるかどうかを定義します。 このパラメータがtrueに設定されている場合は、[共有リンクを含む検索結果](/reference/resources/search-results-with-shared-links)のリストを返すよう、このAPIのレスポンス形式が変更されます。 required: false schema: type: boolean default: false example: true - name: fields in: query description: >- レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。 このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。 required: false schema: type: array items: type: string example: - id - type - name explode: false - name: offset in: query description: |- レスポンスが開始される項目のオフセット。 オフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。 required: false schema: type: integer format: int64 default: 0 example: 1000 - name: deleted_user_ids in: query description: >- 指定したユーザーリスト (ユーザーIDのコンマ区切りリストとして定義) によって削除された項目に検索結果を絞り込みます。 `trash_content`パラメータは`trashed_only`に設定する必要があります。 ごみ箱内検索が実行されていない場合は、空の結果セットが返されます。検索結果に項目が表示されるように、項目は現在認証されているユーザーによって所有または共有されている必要があります。 いずれかのユーザーが所有するファイルにユーザーがアクセスできない場合は、空の結果セットが返されます。 2023年2月1日以降利用できるデータです。 required: false schema: type: array items: type: string example: - '123422' - '23532' - '3241212' - name: deleted_at_range in: query description: |- 指定した日付範囲内に削除されたすべての項目に検索結果を絞り込みます。 日付範囲はコンマ区切りのRFC3339タイムスタンプとして定義されます。 開始日が省略されている場合 (`2014-05-17T13:35:01-07:00`)、終了日より前に削除された項目がすべて返されます。 終了日が省略されている場合 (`2014-05-15T13:35:01-07:00`)、代わりに現在の日付が終了日として使用されます。 `trash_content`パラメータは`trashed_only`に設定する必要があります。 ごみ箱内検索が実行されていない場合は、空の結果が返されます。 2023年2月1日以降利用できるデータです。 required: false schema: type: array items: type: string example: - '2014-05-15T13:35:01-07:00' - '2014-05-17T13:35:01-07:00' responses: '200': description: 検索結果のコレクションを返します。一致する検索結果がない場合、`entries`配列は空になります。 content: application/json: schema: $ref: '#/components/schemas/SearchResultsResponse' '400': description: >- リクエストが無効だった場合にエラーを返します。これには、複数の理由があり、`context_info`オブジェクトによって詳細が示されます。 - `missing_parameter` - 検索で少なくとも`query`または`mdfilters`クエリパラメータを指定してください。 - `invalid_parameter` - いずれかのフィールドの形式に誤りがある可能性があります。たとえば、RFC3339日付のいずれかが正しくないか、整数が想定されている場所に文字列が指定されることを意味します。 content: application/json: schema: $ref: '#/components/schemas/ClientError' '403': description: >- このAPIコールを行う権限がユーザーにない場合にエラーを返します。 - 開発者は、`scope`として`enterprise_content`を指定しましたが、Boxのサポートチャネルを通じて、このスコープをユーザーに対して有効にするようリクエストしませんでした。 content: application/json: schema: $ref: '#/components/schemas/ClientError' '404': description: >- ユーザーが、リクエストで取り上げられた項目にアクセスできない場合にエラーを返します。 - 開発者は、存在しないフォルダIDまたはユーザーがアクセスできないフォルダIDを`ancestor_folder_ids`で指定しました。 content: application/json: schema: $ref: '#/components/schemas/ClientError' default: description: 予期しないクライアントエラー。 content: application/json: schema: $ref: '#/components/schemas/ClientError' x-codeSamples: - lang: curl label: コンテンツを検索 source: |- curl -i -X GET "https://api.box.com/2.0/search?query=sales" \ -H "authorization: Bearer " - lang: java label: コンテンツを検索 source: >- client.getSearch().searchForContent(new SearchForContentQueryParams.Builder().ancestorFolderIds(Arrays.asList("0")).mdfilters(Arrays.asList(new MetadataFilter.Builder().scope(MetadataFilterScopeField.ENTERPRISE).templateKey(templateKey).filters(searchFilters).build())).build()) - lang: node label: コンテンツを検索 source: |- await client.search.searchForContent({ ancestorFolderIds: ['0'], mdfilters: [ { filters: searchFilters, scope: 'enterprise' as MetadataFilterScopeField, templateKey: templateKey, } satisfies MetadataFilter, ], } satisfies SearchForContentQueryParams); - lang: python label: コンテンツを検索 source: |- client.search.search_for_content( ancestor_folder_ids=["0"], mdfilters=[ MetadataFilter( filters=search_filters, scope=MetadataFilterScopeField.ENTERPRISE, template_key=template_key, ) ], ) components: schemas: MetadataFilter: description: 検索結果のフィルタに使用されたメタデータテンプレート。 type: object properties: scope: description: >- 検索結果のフィルタに使用する、テンプレートのスコープを指定します。 これは、この会社で使用するために定義されたテンプレートの場合は`enterprise_{enterprise_id}`、Boxを使用するすべての会社が利用できる一般的なテンプレートの場合は`global`になります。 type: string example: enterprise enum: - global - enterprise - enterprise_{enterprise_id} templateKey: description: >- 検索結果のフィルタに使用されたテンプレートのキー。 多くの場合、テンプレートキーはその表示名から自動的に派生します。たとえば、`Contract Template`の場合は`contractTemplate`となります。場合によっては、テンプレートの作成者が独自のテンプレートキーを指定することもあります。 テンプレートのキーを調べるには、[会社のテンプレートのリストを取得する][list]か、[ファイル][file]または[フォルダ][folder]上のすべてのインスタンスを取得してください。 [list]: /reference/get-metadata-templates-enterprise [file]: /reference/get-files-id-metadata [folder]: /reference/get-folders-id-metadata type: string example: contract filters: description: >- 検索結果のフィルタに使用するテンプレートのフィールドを指定します。複数のフィールドを指定すると、クエリでは論理`AND`が実行され、指定された各フィールドに一致するテンプレートのインスタンスが取得されます。 type: object example: category: online additionalProperties: allOf: - $ref: '#/components/schemas/MetadataFilterValue' - example: online - x-box-example-key: category title: メタデータフィルタ x-box-resource-id: metadata_filter x-box-tag: search SearchResultsResponse: description: コンテンツの検索エンドポイントからの検索結果。 type: object oneOf: - $ref: '#/components/schemas/SearchResults' - $ref: '#/components/schemas/SearchResultsWithSharedLinks' title: 検索結果のレスポンス ClientError: description: 一般的なエラー。 type: object properties: type: description: 値は常に`error`になります。 type: string example: error enum: - error nullable: false status: description: レスポンスのHTTPステータス。 type: integer format: int32 example: 400 nullable: false code: description: Box固有のエラーコード。 type: string example: item_name_invalid enum: - created - accepted - no_content - redirect - not_modified - bad_request - unauthorized - forbidden - not_found - method_not_allowed - conflict - precondition_failed - too_many_requests - internal_server_error - unavailable - item_name_invalid - insufficient_scope message: description: エラーについての短い説明メッセージ。 type: string example: Method Not Allowed nullable: false context_info: description: >- このエラーに関する追加コンテキストを含む自由形式のオブジェクト。使用できるフィールドは、エンドポイントごとに定義されています。`message`は唯一の例です。 type: object example: message: Something went wrong additionalProperties: {} nullable: true help_url: description: このエラーの原因に関する詳細情報にリンクされたURL。 type: string example: >- https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/ nullable: false request_id: description: Boxサポートに連絡するときに使用できる、このレスポンスの一意の識別子。 type: string example: abcdef123456 nullable: false title: クライアントエラー x-box-resource-id: client_error MetadataFilterValue: description: メタデータフィルタの値。 oneOf: - type: string - type: number - title: Metadata field filter (multi-select) type: array items: type: string description: >- Specifies the values to match for a `multiSelect` metadata field. When performing a search, the query will essentially perform an `OR` operation to match any template where any of the provided values match this field. example: - online - enterprise - $ref: '#/components/schemas/MetadataFieldFilterFloatRange' - $ref: '#/components/schemas/MetadataFieldFilterDateRange' title: メタデータフィルタ値 SearchResults: description: 検索クエリに一致するファイル、フォルダ、およびウェブリンクのリスト。 type: object allOf: - type: object properties: total_count: description: >- 検索結果の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。 type: integer format: int64 example: 5000 limit: description: この検索で使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。 type: integer format: int64 example: 1000 offset: description: >- このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータを使用した場合と同じになります。 type: integer format: int64 example: 2000 - properties: type: description: 共有リンクを含まない検索結果項目としてレスポンスを指定します。 type: string example: search_results_items enum: - search_results_items nullable: false entries: description: 指定されたクエリの検索結果。 type: array items: $ref: '#/components/schemas/SearchResultItem' required: - type title: 検索結果 x-box-resource-id: search_results x-box-tag: search SearchResultsWithSharedLinks: description: >- 検索クエリと一致したファイル、フォルダ、ウェブリンクのリスト (項目がユーザーと共有されたときに使用されたすべての共有リンクに関する追加情報を含む)。 このレスポンス形式は、`include_recent_shared_links`クエリパラメータが`true`に設定されている場合にのみ返されます。 type: object allOf: - type: object properties: total_count: description: >- 検索結果の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。 type: integer format: int64 example: 5000 limit: description: この検索で使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。 type: integer format: int64 example: 1000 offset: description: >- このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータを使用した場合と同じになります。 type: integer format: int64 example: 2000 - properties: type: description: 共有リンクを含む検索結果項目としてレスポンスを指定します。 type: string example: search_results_with_shared_links enum: - search_results_with_shared_links nullable: false entries: description: 指定されたクエリの検索結果 (項目がユーザーと共有されたときに使用されたすべての共有リンクに関する追加情報を含む)。 type: array items: $ref: '#/components/schemas/SearchResultWithSharedLink' required: - type title: 検索結果 (複数の共有リンクを含む) x-box-resource-id: search_results_with_shared_links x-box-tag: search MetadataFieldFilterFloatRange: description: 検索結果のフィルタに使用するテンプレートの`float`フィールドを指定して、照合する値の範囲を指定します。 type: object properties: lt: description: >- メタデータフィールド値の上限 (その値を含む) を指定します。検索クエリがこのテンプレートに一致するには、フィールドの値をこの値より小さくする (`lt`) かこの値と等しくする必要があります。 type: number example: 200000 gt: description: >- メタデータフィールド値の下限 (その値を含む) を指定します。検索クエリがこのテンプレートに一致するには、フィールドの値をこの値より大きくする (`gt`) かこの値と等しくする必要があります。 type: number example: 100000 title: メタデータフィールドのフィルタ (浮動小数点の範囲) x-box-resource-id: metadata_field_filter_float_range MetadataFieldFilterDateRange: description: 検索結果のフィルタに使用するテンプレートの`date`フィールドを指定して、照合する日付の範囲を指定します。 type: object properties: lt: description: >- メタデータフィールド値の上限 (その値を含む) を指定します。検索クエリがこのテンプレートに一致するには、フィールドの値をこの値より小さくする (`lt`) かこの値と等しくする必要があります。 type: string format: date-time example: '2017-08-01T00:00:00Z' gt: description: >- メタデータフィールド値の下限 (その値を含む) を指定します。検索クエリがこのテンプレートに一致するには、フィールドの値をこの値より大きくする (`gt`) かこの値と等しくする必要があります。 type: string format: date-time example: '2016-08-01T00:00:00Z' title: メタデータフィールドのフィルタ (日付範囲) x-box-resource-id: metadata_field_filter_date_range SearchResultItem: description: 検索結果の項目。ファイル、フォルダ、またはウェブリンクの場合があります。 type: object oneOf: - $ref: '#/components/schemas/File--Full' - $ref: '#/components/schemas/Folder--Full' - $ref: '#/components/schemas/WebLink' title: 検索結果の項目 SearchResultWithSharedLink: description: >- 検索クエリと一致したファイル、フォルダ、ウェブリンクの単一リスト (項目がユーザーと共有されたときに使用された共有リンクに関する追加情報を含む)。 このレスポンス形式は、`include_recent_shared_links`クエリパラメータが`true`に設定されている場合にのみ返されます。 type: object properties: accessible_via_shared_link: description: >- ユーザーがこの項目にアクセスする際に使用する共有リンク (省略可)。この値は、ユーザーが最近共有リンクを介してファイルにアクセスした項目のみに返されます。その他すべての項目には、`null`が返されます。 type: string format: url example: https://www.box.com/s/vspke7y05sb214wjokpk item: allOf: - $ref: '#/components/schemas/SearchResultWithSharedLinkItem' - description: 検索クエリと一致したファイル、フォルダ、またはウェブリンク。 type: description: 結果の種類。値は常に`search_result`になります。 type: string example: search_result title: 検索結果 (共有リンクを含む) x-box-resource-id: search_result_with_shared_link x-box-tag: search File--Full: description: 任意のファイルAPIエンドポイントからデフォルトで返される可能性があるファイルのFull版の表示。 type: object allOf: - $ref: '#/components/schemas/File' - properties: version_number: description: このファイルのバージョン番号。 type: string example: '1' comment_count: description: このファイルに関するコメントの数。 type: integer example: 10 permissions: allOf: - type: object description: このファイルに対して認証済みユーザーが持っている権限。 required: - can_annotate - can_comment - can_preview - can_upload - can_view_annotations_all - can_view_annotations_self allOf: - type: object description: この項目に対して認証済みユーザーが持っている権限。 required: - can_delete - can_download - can_invite_collaborator - can_rename - can_set_share_access - can_share properties: can_delete: description: 現在のユーザーがこの項目を削除できるかどうかを指定します。 type: boolean example: true nullable: false can_download: description: 現在のユーザーがこの項目をダウンロードできるかどうかを指定します。 type: boolean example: true nullable: false can_invite_collaborator: description: >- 現在のユーザーがこの項目でのコラボレーションに新しいユーザーを招待できるかどうかと、この項目ですでにコラボレーションしているユーザーのロールを更新できるかどうかを指定します。 type: boolean example: true nullable: false can_rename: description: ユーザーがこの項目の名前を変更できるかどうかを指定します。 type: boolean example: true nullable: false can_set_share_access: description: ユーザーがこの項目の既存の共有リンクのアクセスレベルを変更できるかどうかを指定します。 type: boolean example: true nullable: false can_share: description: ユーザーがこの項目の共有リンクを作成できるかどうかを指定します。 type: boolean example: true nullable: false - properties: can_annotate: description: ユーザーがこのファイルに注釈を付けられるかどうかを指定します。 type: boolean example: true nullable: false can_comment: description: ユーザーがこのファイルにコメントを追加できるかどうかを指定します。 type: boolean example: true nullable: false can_preview: description: ユーザーがこのファイルをプレビューできるかどうかを指定します。 type: boolean example: true nullable: false can_upload: description: ユーザーがこのファイルの新しいバージョンをアップロードできるかどうかを指定します。 type: boolean example: true nullable: false can_view_annotations_all: description: ユーザーに対してこのファイルに付けられたすべての注釈を表示するかどうかを指定します。 type: boolean example: true nullable: false can_view_annotations_self: description: ユーザーに対して自分がファイルに付けた注釈を表示するかどうかを指定します。 type: boolean example: true nullable: false can_apply_watermark: description: ユーザーがこのファイルに電子すかしを適用できるかどうかを指定します。 type: boolean example: true nullable: false - description: このファイルに対して現在のユーザーが持っている権限について説明します。 - nullable: false tags: allOf: - type: array example: - approved items: type: string minItems: 1 maxItems: 100 description: |- この項目のタグ。これらのタグはBoxウェブアプリおよびモバイルアプリで項目の横に表示されます。 タグを追加または削除するには、項目の現在のタグを取得して変更してから、このフィールドを更新します。 タグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに制限されます。 - nullable: false lock: allOf: - title: Lock type: object description: >- ファイルで保持されているロック。ロックにより、ロックを作成したユーザー以外は、ファイルを移動、名前変更、および変更できません。 properties: id: description: このロックの一意の識別子。 type: string example: '11446498' type: description: 値は常に`lock`になります。 type: string example: lock enum: - lock created_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: ロックを作成したユーザー。 created_at: description: このロックが作成された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' expired_at: description: このロックが期限切れになる日時。過去の日時になる場合もあります。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' is_download_prevented: description: ロック中でもファイルのダウンロードを許可するかどうか。 type: boolean example: true app_type: description: >- ロックを管理しているのがユーザーではなくアプリケーションの場合、このフィールドは、ロックを保持しているアプリケーションの種類を示します。これはオープンな列挙型で、今後、値の追加により拡張される可能性があります。 type: string example: office_wopiplus enum: - gsuite - office_wopi - office_wopiplus - other nullable: true - description: このファイルで保持されているロック。ロックが存在しない場合は`null`になるか、過去のタイムスタンプになります。 nullable: true extension: description: このファイルのファイル拡張子 (省略可) を示します。デフォルトでは、空の文字列に設定されます。 type: string example: pdf is_package: description: >- ファイルがパッケージかどうかを示します。パッケージはMacアプリケーションで一般的に使用され、iWorkファイルを含めることができます。 type: boolean example: true expiring_embed_link: allOf: - title: 有効期限付き埋め込みリンク type: object description: 有効期限付きのBox Embedリンク。 allOf: - type: object description: アクセストークンの基本情報。 properties: access_token: description: リクエストされたアクセストークン。 type: string format: token example: >- c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ expires_in: description: このトークンが期限切れになるまでの秒数。 type: integer format: int64 example: 3600 token_type: description: 返されるアクセストークンのタイプ。 type: string example: bearer enum: - bearer restricted_to: description: >- このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。 type: array items: $ref: '#/components/schemas/ResourceScope' - properties: url: description: >- このファイルの実際の有効期限付き埋め込みURL。このオブジェクトで指定されたファイルIDとアクセストークンから作成されます。 type: string format: url example: https://cloud.app.box.com/preview/expiring_embed/... - description: >- このフィールドをリクエストすると、`iframe`に埋め込まれたプレビューセッション用の有効期限付きBox Embed URLが作成されます。 このURLは60秒後に有効期限切れとなり、セッションはその60分後に有効期限切れとなります。 一部のファイルタイプは、これらの埋め込みURLでサポートされていません。Box Embedはモバイルブラウザ向けに最適化されていないため、モバイルデバイス用に設計されたウェブエクスペリエンスでは使用しないでください。多くのUI Element (**ダウンロード**オプションや**印刷**オプションなど) はモバイルブラウザに表示されない可能性があります。 watermark_info: allOf: - type: object description: この項目に適用された電子すかしに関する詳細。 properties: is_watermarked: description: この項目に電子すかしが適用されているかどうかを指定します。 type: boolean example: true nullable: false is_watermark_inherited: description: 電子すかしが階層のいずれかの親フォルダから継承されるかどうかを指定します。 type: boolean example: false nullable: false is_watermarked_by_access_policy: description: 電子すかしがアクセスポリシーで適用されるかどうかを指定します。 type: boolean example: false nullable: false - description: このファイルに適用された電子すかしに関する詳細。 is_accessible_via_shared_link: description: 直接共有リンクまたは親フォルダへの共有リンクを使用してファイルにアクセスできるかどうかを指定します。 type: boolean example: true allowed_invitee_roles: description: このファイルを共有するときに招待できるユーザーの役割タイプのリスト。 type: array items: type: string enum: - editor - viewer - previewer - uploader - previewer uploader - viewer uploader - co-owner example: - editor nullable: false is_externally_owned: description: このファイルが認証済みの会社以外のユーザーによって所有されているかどうかを指定します。 type: boolean example: true nullable: false has_collaborations: description: このファイルに他のコラボレータが存在するかどうかを指定します。 type: boolean example: true nullable: false metadata: allOf: - title: 項目メタデータインスタンス type: object description: >- `scope`および`templateKey`のキー/値ペア内にネストされている、メタデータインスタンスのリスト。 ファイルまたはフォルダのメタデータにアクセスするには、最初にメタデータエンドポイントを使用して、会社で使用できるメタデータテンプレートを特定します。 その後、`fields`クエリパラメータを指定して`GET /files/:id`または`GET /folder/:id`エンドポイントを使用すると、IDを指定してメタデータを取得できます。 特定の`scope`および`templateKey`のメタデータインスタンスをリクエストするには、`fields`パラメータに`metadata..`の形式を使用してください。 たとえば、`?fields=metadata.enterprise_27335.marketingCollateral`のようになります。 example: enterprise_27335: marketingCollateral: $canEdit: true $id: 01234500-12f1-1234-aa12-b1d234cb567e $parent: folder_59449484661 $scope: enterprise_27335 $template: marketingCollateral $type: properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0 $typeVersion: 2 $version: 1 additionalProperties: type: object description: '`scope`および`templateKey`のキー/値ペア内にネストされている、メタデータインスタンスのリスト。' example: marketingCollateral: $canEdit: true $id: 01234500-12f1-1234-aa12-b1d234cb567e $parent: folder_59449484661 $scope: enterprise_27335 $template: marketingCollateral $type: properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0 $typeVersion: 2 $version: 1 additionalProperties: $ref: '#/components/schemas/Metadata--Full' - description: >- このファイルに追加されたメタデータインスタンスを含むオブジェクト。 各メタデータインスタンスは、その`scope`と`templateKey`によって一意に識別されます。各ファイルに追加されるメタデータテンプレートのインスタンスは1つだけです。各メタデータインスタンスは、キーとして`templateKey`が指定されているオブジェクト内にネストされ、さらにそのオブジェクト自体もキーとして`scope`が指定されているオブジェクト内にネストされます。 expires_at: description: ファイルが自動的に削除される日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true representations: allOf: - title: Representations description: ファイルレプリゼンテーションのリスト。 type: object properties: entries: description: ファイルのリスト。 type: array items: type: object description: ファイルレプリゼンテーション。 properties: content: description: レプリゼンテーションを実際に取得するために使用できるURLを含むオブジェクト。 properties: url_template: description: >- レプリゼンテーションを取得するために使用できるダウンロードURL。このエンドポイントに対しては必ず認証済みAPIコールを行ってください。 このURLはテンプレートであるため、`{+asset_path}`を実際のパスに置き換える必要があります。通常、ページ付けが行われていないレプリゼンテーションの場合は、空の文字列に置き換えることができます。 ページ割りされたレプリゼンテーションの場合は、`1.pdf`など、リクエストするページにファイル拡張子を付けた文字列で`{+asset_path}`を置き換えます。 ダウンロードURLをリクエストする際には、以下の追加クエリパラメータを渡すことができます。 - `set_content_disposition_type` - 配置タイプとして`inline`または`attachment`のいずれかを指定してAPIレスポンスの`Content-Disposition`ヘッダーを設定します。このパラメータを指定しない場合、レスポンスに`Content-Disposition`ヘッダーは含まれません。 - `set_content_disposition_filename` - `Content-Disposition`ヘッダーで使用するレプリゼンテーションのファイル名をアプリケーションで定義できます。定義しない場合は、Boxのソースファイル名から派生したファイル名とレプリゼンテーション拡張子の組み合わせがファイル名になります。 type: string example: >- https://dl.boxcloud.com/api/2.0/internal_files/123/versions/345/representations/png_paged_2048x2048/content/{+asset_path}?watermark_content=4567 type: object info: description: このレプリゼンテーションの詳細を取得するために使用できるURLを含むオブジェクト。 type: object properties: url: description: >- このファイルレプリゼンテーションの詳細を取得するために使用できるAPI URL。このエンドポイントに対しては必ず認証済みAPIコールを行ってください。 type: string example: >- https://api.box.com/2.0/internal_files/123/versions/345/representations/png_paged_2048x2048 properties: description: このプレゼンテーションのサイズとタイプを含むオブジェクト。 type: object properties: dimensions: type: string format: x example: 2048x2048 description: このレプリゼンテーションの幅と高さ。 paged: type: string example: 'true' description: レプリゼンテーションが複数のページで構成されているかどうかを示します。 thumb: type: string example: 'true' description: そのレプリゼンテーションをファイルのサムネイルとして使用できるかどうかを示します。 representation: description: 返されたレプリゼンテーションのファイルタイプを示します。 type: string example: png status: description: このレプリゼンテーションのステータスを含むオブジェクト。 type: object properties: state: description: >- レプリゼンテーションのステータス。 - `success`はそのレプリゼンテーションが表示可能な状態であることを示します。 - `viewable`は視聴可能な動画であることを示します。 - `pending`はそのレプリゼンテーションがこれから生成されることを示します。ステータスを再確認するにはこのエンドポイントを再試行します。 - `none`はリクエストされたときにレプリゼンテーションが再作成されることを示します。この生成をトリガーするには、`info`オブジェクトで定義されたURLをリクエストします。 type: string example: success enum: - success - viewable - pending - none - description: >- アプリケーション内でファイルのプレースホルダを表示するために使用できるレプリゼンテーションのリスト。デフォルトでは、すべてのレプリゼンテーションが返されるため、`x-rep-hints`ヘッダーを使用して目的のレプリゼンテーションをさらにカスタマイズすることをお勧めします。 classification: allOf: - type: object description: 項目に適用される分類。 properties: name: description: 分類の名前。 type: string example: Top Secret definition: description: この分類の意味の説明。 type: string example: Content that should not be shared outside the company. color: description: >- ユーザーインターフェースでの分類ラベルの表示に使用される色。色は、Boxウェブアプリで分類を作成した管理者または共同管理者によって定義されます。 type: string example: '#FF0000' - description: このファイルに適用された分類に関する詳細 - nullable: true uploader_display_name: allOf: - title: アップローダーの表示名 type: string example: Ellis Wiggins nullable: false description: >- ファイルをアップロードしたユーザーの表示名。ほとんどの場合、これはアップロード時点でログインしているユーザーの名前です。 このファイルのアップロードに、ユーザーに対してメールアドレスの入力を要求するファイルリクエストフォームが使用された場合、このフィールドにはそのメールアドレスが設定されます。メールアドレスがファイルリクエストフォームで要求されなかった場合、このフィールドは、`File Request`という値を返すように設定されます。 メールアドレスが指定されなかったその他すべての匿名のケースでは、このフィールドの値がデフォルトで`Someone`になります。 disposition_at: description: 特定のファイルのリテンションの有効期限のタイムスタンプ。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true shared_link_permission_options: description: このファイルを共有するときに招待できるユーザーの役割タイプのリスト。 type: array items: type: string enum: - can_preview - can_download - can_edit example: - can_preview nullable: true is_associated_with_app_item: description: >- ファイルまたはファイルの先祖が1つ以上のアプリ項目に関連付けられている場合、このフィールドはtrueを返します。コンテキストユーザーがそのファイルに関連付けられたアプリ項目にアクセスできない場合でもtrueが返されることに注意してください。 type: boolean example: true nullable: false collections: description: |- このファイルが属しているコレクション。 詳細については、[コレクションのガイド](/guides/collections)を参照してください。 type: array items: $ref: '#/components/schemas/Collection' is_download_available: description: >- ファイルのバイナリコンテンツがダウンロードの対象かどうか。 これはコンテンツレベルのフラグで、現在のユーザーがファイルのダウンロードを承認されているかどうかは反映されていません。現在のユーザーがファイルのダウンロードを承認されているかどうかを示すには、`permissions.can_download`を使用します (使用可能な場合)。 type: boolean example: true download_url: description: |- ファイルのコンテンツを直接ダウンロードできる、事前承認された有効期限付きのURL。認証が必要で、現在のセッションでのみ有効です。 このフィールドはファイルについてのみ返され、フォルダまたはウェブリンクの場合は返されません。 type: string format: url example: https://dl.boxcloud.com/d/1/example_token/download authenticated_download_url: description: >- ファイルコンテンツエンドポイントの安定したAPI URL (`/2.0/files/{id}/content`)。`download_url`とは異なり、有効なアクセストークンを使用してURLがリクエストされたときに承認が評価されます。 このフィールドはファイルについてのみ返され、フォルダまたはウェブリンクの場合は返されません。 type: string format: url example: https://api.box.com/2.0/files/12345/content allowed_shared_link_access_levels: description: >- 認証済みユーザーがこのファイルの共有リンクを作成または更新するときに使用できる、共有リンクのアクセスレベル。 リストは項目のポリシーとユーザーの承認によって決まるため、所有者の使用できるレベルよりも狭くなる場合があります。空の配列は、このユーザーには使用できるアクセスレベルがないことを意味します。 type: array items: title: 共有リンクのアクセスレベル type: string description: 共有リンクのアクセスレベル。 example: open enum: - open - company - collaborators example: - open nullable: false title: ファイル (Full) x-box-resource-id: file--full x-box-tag: files x-box-variant: full Folder--Full: description: 任意のフォルダAPIエンドポイントからデフォルトで返される可能性があるフォルダのFull版の表示。 type: object allOf: - $ref: '#/components/schemas/Folder' - properties: sync_state: allOf: - type: string example: synced nullable: false description: >- フォルダをユーザーのデバイスに同期する必要があるかどうかを指定します。これはBox Sync (廃止済み) で使用され、Box Driveでは 使用されません。 enum: - synced - not_synced - partially_synced has_collaborations: description: このフォルダに他のコラボレータが存在するかどうかを指定します。 type: boolean example: true nullable: false permissions: allOf: - type: object description: フォルダに対して認証済みユーザーが持っている権限。 required: - can_upload allOf: - type: object description: この項目に対して認証済みユーザーが持っている権限。 required: - can_delete - can_download - can_invite_collaborator - can_rename - can_set_share_access - can_share properties: can_delete: description: 現在のユーザーがこの項目を削除できるかどうかを指定します。 type: boolean example: true nullable: false can_download: description: 現在のユーザーがこの項目をダウンロードできるかどうかを指定します。 type: boolean example: true nullable: false can_invite_collaborator: description: >- 現在のユーザーがこの項目でのコラボレーションに新しいユーザーを招待できるかどうかと、この項目ですでにコラボレーションしているユーザーのロールを更新できるかどうかを指定します。 type: boolean example: true nullable: false can_rename: description: ユーザーがこの項目の名前を変更できるかどうかを指定します。 type: boolean example: true nullable: false can_set_share_access: description: ユーザーがこの項目の既存の共有リンクのアクセスレベルを変更できるかどうかを指定します。 type: boolean example: true nullable: false can_share: description: ユーザーがこの項目の共有リンクを作成できるかどうかを指定します。 type: boolean example: true nullable: false - properties: can_upload: description: ユーザーがこのフォルダにアップロードできるかどうかを指定します。 type: boolean example: true nullable: false can_apply_watermark: description: ユーザーがこのフォルダとそのコンテンツに電子すかしを適用できるかどうかを指定します。 type: boolean example: true nullable: false - description: このフォルダに対して現在のユーザーが持っている権限について説明します。 - nullable: false tags: allOf: - type: array example: - approved items: type: string minItems: 1 maxItems: 100 description: |- この項目のタグ。これらのタグはBoxウェブアプリおよびモバイルアプリで項目の横に表示されます。 タグを追加または削除するには、項目の現在のタグを取得して変更してから、このフィールドを更新します。 タグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに制限されます。 - nullable: false can_non_owners_invite: allOf: - type: boolean example: true description: フォルダの所有者ではないユーザーがそのフォルダに新しいコラボレータを招待できるかどうかを指定します。 - nullable: false is_externally_owned: description: このフォルダが認証済みの会社以外のユーザーによって所有されているかどうかを指定します。 type: boolean example: true nullable: false metadata: allOf: - title: 項目メタデータインスタンス type: object description: >- `scope`および`templateKey`のキー/値ペア内にネストされている、メタデータインスタンスのリスト。 ファイルまたはフォルダのメタデータにアクセスするには、最初にメタデータエンドポイントを使用して、会社で使用できるメタデータテンプレートを特定します。 その後、`fields`クエリパラメータを指定して`GET /files/:id`または`GET /folder/:id`エンドポイントを使用すると、IDを指定してメタデータを取得できます。 特定の`scope`および`templateKey`のメタデータインスタンスをリクエストするには、`fields`パラメータに`metadata..`の形式を使用してください。 たとえば、`?fields=metadata.enterprise_27335.marketingCollateral`のようになります。 example: enterprise_27335: marketingCollateral: $canEdit: true $id: 01234500-12f1-1234-aa12-b1d234cb567e $parent: folder_59449484661 $scope: enterprise_27335 $template: marketingCollateral $type: properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0 $typeVersion: 2 $version: 1 additionalProperties: type: object description: '`scope`および`templateKey`のキー/値ペア内にネストされている、メタデータインスタンスのリスト。' example: marketingCollateral: $canEdit: true $id: 01234500-12f1-1234-aa12-b1d234cb567e $parent: folder_59449484661 $scope: enterprise_27335 $template: marketingCollateral $type: properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0 $typeVersion: 2 $version: 1 additionalProperties: $ref: '#/components/schemas/Metadata--Full' - description: >- このフォルダに追加されたメタデータインスタンスを含むオブジェクト。 各メタデータインスタンスは、その`scope`と`templateKey`によって一意に識別されます。各フォルダに追加されるメタデータテンプレートのインスタンスは1つだけです。各メタデータインスタンスは、キーとして`templateKey`が指定されているオブジェクト内にネストされ、さらにそのオブジェクト自体もキーとして`scope`が指定されているオブジェクト内にネストされます。 is_collaboration_restricted_to_enterprise: allOf: - type: boolean example: true description: このフォルダへの招待を社内のユーザーのみに限定するかどうかを指定します。既存のコラボレーションには影響しません。 - nullable: false allowed_shared_link_access_levels: description: >- 認証済みユーザーがこのフォルダの共有リンクを作成または更新するときに使用できる、共有リンクのアクセスレベル。 リストは項目のポリシーとユーザーの承認によって決まります。ルートフォルダなど一部のフォルダについては、そのレベルで共有が許可されていないため、これは常に空になります。 type: array items: title: 共有リンクのアクセスレベル type: string description: 共有リンクのアクセスレベル。 example: open enum: - open - company - collaborators example: - open nullable: false allowed_invitee_roles: description: このフォルダを共有するときに招待できるユーザーの役割タイプのリスト。 type: array items: type: string enum: - editor - viewer - previewer - uploader - previewer uploader - viewer uploader - co-owner example: - editor nullable: false watermark_info: allOf: - type: object description: この項目に適用された電子すかしに関する詳細。 properties: is_watermarked: description: この項目に電子すかしが適用されているかどうかを指定します。 type: boolean example: true nullable: false is_watermark_inherited: description: 電子すかしが階層のいずれかの親フォルダから継承されるかどうかを指定します。 type: boolean example: false nullable: false is_watermarked_by_access_policy: description: 電子すかしがアクセスポリシーで適用されるかどうかを指定します。 type: boolean example: false nullable: false - description: このフォルダに適用された電子すかしに関する詳細。 - nullable: false is_accessible_via_shared_link: description: 直接共有リンクまたは親フォルダへの共有リンクを使用してフォルダにアクセスできるかどうかを指定します。 type: boolean example: true can_non_owners_view_collaborators: description: |- このフォルダの所有者ではないコラボレータがこのフォルダの他のコラボレータを表示できないように制限するかどうかを指定します。 この制限を有効にした場合は、所有者ではないユーザーが新しいコラボレータを招待することも制限されます。 type: boolean example: true classification: allOf: - type: object description: 項目に適用される分類。 properties: name: description: 分類の名前。 type: string example: Top Secret definition: description: この分類の意味の説明。 type: string example: Content that should not be shared outside the company. color: description: >- ユーザーインターフェースでの分類ラベルの表示に使用される色。色は、Boxウェブアプリで分類を作成した管理者または共同管理者によって定義されます。 type: string example: '#FF0000' - description: このフォルダに適用された分類に関する詳細。 - nullable: true is_associated_with_app_item: description: >- フォルダまたはフォルダの先祖が1つ以上のアプリ項目に関連付けられている場合、このフィールドはtrueを返します。コンテキストユーザーがそのフォルダに関連付けられたアプリ項目にアクセスできない場合でもtrueが返されることに注意してください。 type: boolean example: true nullable: false collections: description: |- このフォルダが属しているコレクション。 詳細については、[コレクションのガイド](/guides/collections)を参照してください。 type: array items: $ref: '#/components/schemas/Collection' title: フォルダ (Full) x-box-resource-id: folder--full x-box-tag: folders x-box-variant: full WebLink: description: |- ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。 ウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。 type: object allOf: - $ref: '#/components/schemas/WebLink--Mini' - properties: parent: allOf: - $ref: '#/components/schemas/Folder--Mini' - description: ウェブリンクが属する親オブジェクト。 description: description: ウェブリンクに付加される説明。この説明は、Boxウェブアプリケーション内に表示されます。 type: string example: Example page path_collection: allOf: - title: パスのコレクション description: 項目の親フォルダのリスト。 type: object required: - total_count - entries properties: total_count: description: このリスト内のフォルダの数。 type: integer format: int64 example: 1 nullable: false entries: description: この項目の親フォルダ。 type: array items: $ref: '#/components/schemas/Folder--Mini' nullable: false - description: ルートフォルダを起点にした、このウェブリンクを含むフォルダツリー。 - nullable: false created_at: description: このファイルがBoxのサーバー上に作成された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' modified_at: description: このファイルがBoxサーバー上で最後に更新された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' trashed_at: description: このファイルがごみ箱に移動された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true purged_at: description: このファイルが完全に削除される日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true created_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このウェブリンクを作成したユーザー。 modified_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このウェブリンクを最後に変更したユーザー。 owned_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このウェブリンクを所有するユーザー。 shared_link: allOf: - title: 共有リンク description: >- 共有リンクを作成すると、Box上のファイルやフォルダに対する読み取り専用アクセスを直接実行できます。 アクセスレベルがopenに設定されている共有リンクの場合は、URLを知っているすべてのユーザーが項目にアクセスでき、アクセスレベルがcompanyまたはcollaboratorsに設定されている共有リンクの場合は、適切に認証されたBoxユーザーのみが項目にアクセスできます。 type: object required: - url - accessed - effective_access - effective_permission - is_password_enabled - download_count - preview_count properties: url: description: >- Box上の項目にアクセスするために使用できるURL。 このURLに移動すると、BoxのプレビューUIに項目が表示され、許可されている場合は、このUIからファイルをダウンロードできます。 このURLは、この共有リンクに対してカスタムの`vanity_url`が 設定されている場合でも動作します。 type: string format: url example: https://www.box.com/s/vspke7y05sb214wjokpk nullable: false download_url: description: >- ファイルをダウンロードするために使用できるURL。このURLをブラウザで使用すると、ファイルをダウンロードできます。このURLには、ファイルを正しいファイルタイプで保存できるように、ファイル拡張子が含まれます。 フォルダの場合、このプロパティは`null`になります。 type: string format: url example: >- https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg nullable: true x-box-premium-feature: true vanity_url: description: >- Boxで項目をプレビューする目的にも使用できる「カスタムURL」。カスタムURLの作成と変更は、Boxウェブアプリケーションでのみ行えます。 type: string format: url example: https://acme.app.box.com/v/my_url/ nullable: true vanity_name: description: '`vanity_url`フィールドで使用される、共有リンクのカスタム名。' type: string example: my_url nullable: true access: description: >- この共有リンクのアクセスレベル - `open` - このリンクを知っている全員にこの項目へのアクセスを許可します - `company` - 同じ会社のユーザーにのみこの項目へのアクセスを許可します - `collaborators` - この項目のコラボレータとなっているユーザーに対してのみこの項目へのアクセスを許可します 共有リンクの作成時にこのフィールドを省略した場合は、Enterprise管理者によって指定されたデフォルトのアクセスレベルに設定されます。 type: string example: open enum: - open - company - collaborators nullable: false effective_access: description: >- 共有リンクの実際のアクセスレベル。許可されるアクセスレベルが会社の設定で制限されている場合は、`access`フィールドの値よりも低いアクセスレベルになることがあります。 type: string example: company enum: - open - company - collaborators nullable: false effective_permission: description: >- この共有リンクの実際の権限。これらにより、共有リンクの権限と、管理者、所有者、任意の先祖項目 (フォルダなど) によって設定される項目の権限の組み合わせの制限が厳しくなります。 type: string example: can_download enum: - can_edit - can_download - can_preview - no_access nullable: false unshared_at: description: このリンクが共有解除される日時。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。 type: string format: date-time example: '2018-04-13T13:53:23-07:00' nullable: true is_password_enabled: description: 共有リンクを通じて項目にアクセスする際にパスワードを要求するかどうかを定義します。 type: boolean example: true nullable: false permissions: description: >- このリンクを通じてユーザーが項目のプレビュー、編集、およびダウンロードを行うことを許可するかどうかを定義します。これらの権限は、共有リンクのみに適用され、その項目自体に適用される権限より優先されることはありません。 type: object properties: can_download: description: >- 共有リンクを通じて項目をダウンロードすることを許可するかどうかを定義します。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。 実際のアクセスレベルが`collaborators`ではなく、`open`または`company`に設定されている場合は、この値を`true`に設定できます。 type: boolean example: true nullable: false can_preview: description: >- 共有リンクを通じて項目をプレビューすることを許可するかどうかを定義します。 この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。 type: boolean example: true nullable: false can_edit: description: >- 共有リンクからの項目の編集を許可するかどうかを定義します。 `can_download`が`true`で、項目のタイプが`file`の場合のみ、この値も`true`に設定できます。 type: boolean example: false nullable: false required: - can_download - can_preview - can_edit download_count: description: この項目がダウンロードされた回数。 type: integer example: 3 nullable: false preview_count: description: この項目がプレビューされた回数。 type: integer example: 3 nullable: false - description: この項目の共有リンクオブジェクト。共有リンクがまだ作成されていない場合は、`null`になります。 - nullable: true item_status: description: >- この項目が削除されたかどうか。値には、`active`、`trashed` (ファイルがごみ箱に移動された場合)、`deleted` (ファイルが完全に削除された場合) があります。 type: string example: active enum: - active - trashed - deleted collections: description: |- このウェブリンクが属しているコレクション。 詳細については、[コレクションのガイド](/guides/collections)を参照してください。 type: array items: $ref: '#/components/schemas/Collection' allowed_shared_link_access_levels: description: >- 認証済みユーザーがこのウェブリンクの共有リンクを作成または更新するときに使用できる、共有リンクのアクセスレベル。 リストは項目のポリシーとユーザーの承認によって決まるため、所有者の使用できるレベルよりも狭くなる場合があります。空の配列は、このユーザーには使用できるアクセスレベルがないことを意味します。 type: array items: title: 共有リンクのアクセスレベル type: string description: 共有リンクのアクセスレベル。 example: open enum: - open - company - collaborators example: - open nullable: false title: ウェブリンク x-box-resource-id: web_link x-box-tag: web_links x-box-variant: standard SearchResultWithSharedLinkItem: description: 共有リンク付きの検索結果の項目。ファイル、フォルダ、またはウェブリンクの場合があります。 type: object oneOf: - $ref: '#/components/schemas/File--Full' - $ref: '#/components/schemas/Folder--Full' - $ref: '#/components/schemas/WebLink' title: 検索結果の項目 File: description: 任意のファイルAPIエンドポイントからデフォルトで返されるファイルのStandard版の表示。 type: object allOf: - $ref: '#/components/schemas/File--Mini' - properties: description: description: >- このファイルの説明 (省略可)。説明が255文字を超える場合は、最初の255文字がファイルの説明として設定され、残りは無視されます。 type: string example: Contract for Q1 renewal maxLength: 255 nullable: false size: description: >- ファイルサイズ (バイト単位)。この整数を解析する際には、非常に大きな数値となって整数オーバーフローになる可能性があるため、注意が必要です。 type: integer example: 629644 nullable: false path_collection: allOf: - title: パスのコレクション description: 項目の親フォルダのリスト。 type: object required: - total_count - entries properties: total_count: description: このリスト内のフォルダの数。 type: integer format: int64 example: 1 nullable: false entries: description: この項目の親フォルダ。 type: array items: $ref: '#/components/schemas/Folder--Mini' nullable: false - description: ルートフォルダを起点にした、このファイルを含むフォルダツリー。 - nullable: false created_at: description: Box上でこのファイルが作成された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: false modified_at: description: Boxでこのファイルが最後に更新された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: false trashed_at: description: このファイルがごみ箱に移動された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true purged_at: description: このファイルがごみ箱から削除される予定日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true content_created_at: description: このファイルが最初に作成された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true content_modified_at: description: このファイルが最後に更新された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true created_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このファイルを作成したユーザー。 modified_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このファイルを最後に変更したユーザー。 - nullable: false owned_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このファイルを所有するユーザー。 - nullable: false shared_link: allOf: - title: 共有リンク description: >- 共有リンクを作成すると、Box上のファイルやフォルダに対する読み取り専用アクセスを直接実行できます。 アクセスレベルがopenに設定されている共有リンクの場合は、URLを知っているすべてのユーザーが項目にアクセスでき、アクセスレベルがcompanyまたはcollaboratorsに設定されている共有リンクの場合は、適切に認証されたBoxユーザーのみが項目にアクセスできます。 type: object required: - url - accessed - effective_access - effective_permission - is_password_enabled - download_count - preview_count properties: url: description: >- Box上の項目にアクセスするために使用できるURL。 このURLに移動すると、BoxのプレビューUIに項目が表示され、許可されている場合は、このUIからファイルをダウンロードできます。 このURLは、この共有リンクに対してカスタムの`vanity_url`が 設定されている場合でも動作します。 type: string format: url example: https://www.box.com/s/vspke7y05sb214wjokpk nullable: false download_url: description: >- ファイルをダウンロードするために使用できるURL。このURLをブラウザで使用すると、ファイルをダウンロードできます。このURLには、ファイルを正しいファイルタイプで保存できるように、ファイル拡張子が含まれます。 フォルダの場合、このプロパティは`null`になります。 type: string format: url example: >- https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg nullable: true x-box-premium-feature: true vanity_url: description: >- Boxで項目をプレビューする目的にも使用できる「カスタムURL」。カスタムURLの作成と変更は、Boxウェブアプリケーションでのみ行えます。 type: string format: url example: https://acme.app.box.com/v/my_url/ nullable: true vanity_name: description: '`vanity_url`フィールドで使用される、共有リンクのカスタム名。' type: string example: my_url nullable: true access: description: >- この共有リンクのアクセスレベル - `open` - このリンクを知っている全員にこの項目へのアクセスを許可します - `company` - 同じ会社のユーザーにのみこの項目へのアクセスを許可します - `collaborators` - この項目のコラボレータとなっているユーザーに対してのみこの項目へのアクセスを許可します 共有リンクの作成時にこのフィールドを省略した場合は、Enterprise管理者によって指定されたデフォルトのアクセスレベルに設定されます。 type: string example: open enum: - open - company - collaborators nullable: false effective_access: description: >- 共有リンクの実際のアクセスレベル。許可されるアクセスレベルが会社の設定で制限されている場合は、`access`フィールドの値よりも低いアクセスレベルになることがあります。 type: string example: company enum: - open - company - collaborators nullable: false effective_permission: description: >- この共有リンクの実際の権限。これらにより、共有リンクの権限と、管理者、所有者、任意の先祖項目 (フォルダなど) によって設定される項目の権限の組み合わせの制限が厳しくなります。 type: string example: can_download enum: - can_edit - can_download - can_preview - no_access nullable: false unshared_at: description: このリンクが共有解除される日時。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。 type: string format: date-time example: '2018-04-13T13:53:23-07:00' nullable: true is_password_enabled: description: 共有リンクを通じて項目にアクセスする際にパスワードを要求するかどうかを定義します。 type: boolean example: true nullable: false permissions: description: >- このリンクを通じてユーザーが項目のプレビュー、編集、およびダウンロードを行うことを許可するかどうかを定義します。これらの権限は、共有リンクのみに適用され、その項目自体に適用される権限より優先されることはありません。 type: object properties: can_download: description: >- 共有リンクを通じて項目をダウンロードすることを許可するかどうかを定義します。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。 実際のアクセスレベルが`collaborators`ではなく、`open`または`company`に設定されている場合は、この値を`true`に設定できます。 type: boolean example: true nullable: false can_preview: description: >- 共有リンクを通じて項目をプレビューすることを許可するかどうかを定義します。 この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。 type: boolean example: true nullable: false can_edit: description: >- 共有リンクからの項目の編集を許可するかどうかを定義します。 `can_download`が`true`で、項目のタイプが`file`の場合のみ、この値も`true`に設定できます。 type: boolean example: false nullable: false required: - can_download - can_preview - can_edit download_count: description: この項目がダウンロードされた回数。 type: integer example: 3 nullable: false preview_count: description: この項目がプレビューされた回数。 type: integer example: 3 nullable: false - description: このファイルの共有リンク。このファイルに対してまだ共有リンクが作成されていない場合、この値は`null`になります。 - nullable: true parent: allOf: - $ref: '#/components/schemas/Folder--Mini' - description: >- このフォルダが配置されているフォルダ。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる可能性があります。 nullable: true item_status: description: |- この項目が削除されたかどうかを定義します。 - `active` - 項目がごみ箱に移動されていない場合。 - `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。 - `deleted` - 項目がすでに完全に削除されている場合。 type: string example: active enum: - active - trashed - deleted nullable: false title: File x-box-resource-id: file x-box-tag: files x-box-variant: standard User--Mini: description: 他のリソース内にネストされたときに返される可能性があるユーザーのMini版の表示。 type: object allOf: - $ref: '#/components/schemas/User--Base' - properties: name: description: このユーザーの表示名。 type: string example: Aaron Levie maxLength: 50 nullable: false login: description: このユーザーのプライマリメールアドレス。 type: string format: email example: ceo@example.com nullable: false title: ユーザー (Mini) x-box-resource-id: user--mini x-box-tag: users x-box-variant: mini ResourceScope: description: リソース (ファイルまたはフォルダ) とそのリソースにアクセスできるスコープの関係。 type: object properties: scope: description: リソースへのアクセスのスコープ。 type: string example: item_download enum: - annotation_edit - annotation_view_all - annotation_view_self - base_explorer - base_picker - base_preview - base_upload - item_delete - item_download - item_preview - item_rename - item_share - item_upload - item_read object: $ref: '#/components/schemas/Resource' title: リソースのスコープ Metadata--Full: description: ファイルまたはフォルダに適用された、メタデータテンプレートのインスタンス。 type: object allOf: - $ref: '#/components/schemas/Metadata' - properties: $canEdit: description: このメタデータインスタンスをユーザーが編集できるかどうか。 type: boolean example: true $id: description: メタデータインスタンスを識別するためのUUID。 type: string format: uuid example: 01234500-12f1-1234-aa12-b1d234cb567e maxLength: 36 $type: description: >- このインスタンスの「タイプ」に対応する一意の識別子。これは内部システムプロパティであるため、クライアントアプリケーションでは使用しないでください。 type: string example: properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0 $typeVersion: description: >- オブジェクトテンプレートの既知の最新バージョン。これは内部システムプロパティであるため、クライアントアプリケーションでは使用しないでください。 type: integer example: 2 - additionalProperties: allOf: - {} - example: Aaron Levie - description: >- メタデータテンプレートに存在する各フィールドの値。`global.properties`テンプレートの場合、汎用的なキー/値ペアをテンプレートに保存できるため、0個以上のフィールドのリストにすることができます。 x-box-example-key: name title: メタデータインスタンス (Full) x-box-resource-id: metadata--full x-box-tag: file_metadata x-box-variant: full Collection: description: |- ファイルやフォルダなどの項目のコレクション。 現時点で利用可能なコレクションは、`favorites`コレクションのみです。 コレクションのコンテンツは、フォルダのコンテンツと同じ方法で調べることができます。 type: object properties: id: description: このコレクションの一意の識別子。 type: string example: '11446498' type: description: 値は常に`collection`になります。 type: string example: collection enum: - collection name: description: コレクションの名前。 type: string example: Favorites enum: - Favorites collection_type: description: コレクションのタイプ。これは、コレクションの視覚効果を適切に決定するために使用されます。 type: string example: favorites enum: - favorites title: Collection x-box-resource-id: collection x-box-tag: collections Folder: description: 任意のフォルダAPIエンドポイントからデフォルトで返されるフォルダのStandard版の表示。 type: object allOf: - $ref: '#/components/schemas/Folder--Mini' - properties: created_at: description: >- このフォルダが作成された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true modified_at: description: >- このフォルダが最後に更新された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true description: allOf: - type: string description: このフォルダの説明 (省略可)。 maxLength: 256 example: Legal contracts for the new ACME deal nullable: false - nullable: false size: description: |- フォルダサイズ (バイト単位)。 この整数を解析する際には、値が非常に大きくなることがあるため注意が必要です。 type: integer format: int64 example: 629644 nullable: false path_collection: allOf: - title: パスのコレクション description: 項目の親フォルダのリスト。 type: object required: - total_count - entries properties: total_count: description: このリスト内のフォルダの数。 type: integer format: int64 example: 1 nullable: false entries: description: この項目の親フォルダ。 type: array items: $ref: '#/components/schemas/Folder--Mini' nullable: false - description: ルートフォルダを起点にした、このフォルダを含むフォルダツリー。 - nullable: false created_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このフォルダを作成したユーザー。 - nullable: false modified_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このフォルダを最後に変更したユーザー。 - nullable: false trashed_at: description: このフォルダがごみ箱に移動された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true purged_at: description: このフォルダがごみ箱から削除される予定日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true content_created_at: description: このフォルダが最初に作成された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true content_modified_at: description: このフォルダが最後に更新された日時。 type: string format: date-time example: '2012-12-12T10:53:43-08:00' nullable: true owned_by: allOf: - $ref: '#/components/schemas/User--Mini' - description: このフォルダを所有するユーザー。 - nullable: false shared_link: allOf: - title: 共有リンク description: >- 共有リンクを作成すると、Box上のファイルやフォルダに対する読み取り専用アクセスを直接実行できます。 アクセスレベルがopenに設定されている共有リンクの場合は、URLを知っているすべてのユーザーが項目にアクセスでき、アクセスレベルがcompanyまたはcollaboratorsに設定されている共有リンクの場合は、適切に認証されたBoxユーザーのみが項目にアクセスできます。 type: object required: - url - accessed - effective_access - effective_permission - is_password_enabled - download_count - preview_count properties: url: description: >- Box上の項目にアクセスするために使用できるURL。 このURLに移動すると、BoxのプレビューUIに項目が表示され、許可されている場合は、このUIからファイルをダウンロードできます。 このURLは、この共有リンクに対してカスタムの`vanity_url`が 設定されている場合でも動作します。 type: string format: url example: https://www.box.com/s/vspke7y05sb214wjokpk nullable: false download_url: description: >- ファイルをダウンロードするために使用できるURL。このURLをブラウザで使用すると、ファイルをダウンロードできます。このURLには、ファイルを正しいファイルタイプで保存できるように、ファイル拡張子が含まれます。 フォルダの場合、このプロパティは`null`になります。 type: string format: url example: >- https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg nullable: true x-box-premium-feature: true vanity_url: description: >- Boxで項目をプレビューする目的にも使用できる「カスタムURL」。カスタムURLの作成と変更は、Boxウェブアプリケーションでのみ行えます。 type: string format: url example: https://acme.app.box.com/v/my_url/ nullable: true vanity_name: description: '`vanity_url`フィールドで使用される、共有リンクのカスタム名。' type: string example: my_url nullable: true access: description: >- この共有リンクのアクセスレベル - `open` - このリンクを知っている全員にこの項目へのアクセスを許可します - `company` - 同じ会社のユーザーにのみこの項目へのアクセスを許可します - `collaborators` - この項目のコラボレータとなっているユーザーに対してのみこの項目へのアクセスを許可します 共有リンクの作成時にこのフィールドを省略した場合は、Enterprise管理者によって指定されたデフォルトのアクセスレベルに設定されます。 type: string example: open enum: - open - company - collaborators nullable: false effective_access: description: >- 共有リンクの実際のアクセスレベル。許可されるアクセスレベルが会社の設定で制限されている場合は、`access`フィールドの値よりも低いアクセスレベルになることがあります。 type: string example: company enum: - open - company - collaborators nullable: false effective_permission: description: >- この共有リンクの実際の権限。これらにより、共有リンクの権限と、管理者、所有者、任意の先祖項目 (フォルダなど) によって設定される項目の権限の組み合わせの制限が厳しくなります。 type: string example: can_download enum: - can_edit - can_download - can_preview - no_access nullable: false unshared_at: description: このリンクが共有解除される日時。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。 type: string format: date-time example: '2018-04-13T13:53:23-07:00' nullable: true is_password_enabled: description: 共有リンクを通じて項目にアクセスする際にパスワードを要求するかどうかを定義します。 type: boolean example: true nullable: false permissions: description: >- このリンクを通じてユーザーが項目のプレビュー、編集、およびダウンロードを行うことを許可するかどうかを定義します。これらの権限は、共有リンクのみに適用され、その項目自体に適用される権限より優先されることはありません。 type: object properties: can_download: description: >- 共有リンクを通じて項目をダウンロードすることを許可するかどうかを定義します。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。 実際のアクセスレベルが`collaborators`ではなく、`open`または`company`に設定されている場合は、この値を`true`に設定できます。 type: boolean example: true nullable: false can_preview: description: >- 共有リンクを通じて項目をプレビューすることを許可するかどうかを定義します。 この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。 type: boolean example: true nullable: false can_edit: description: >- 共有リンクからの項目の編集を許可するかどうかを定義します。 `can_download`が`true`で、項目のタイプが`file`の場合のみ、この値も`true`に設定できます。 type: boolean example: false nullable: false required: - can_download - can_preview - can_edit download_count: description: この項目がダウンロードされた回数。 type: integer example: 3 nullable: false preview_count: description: この項目がプレビューされた回数。 type: integer example: 3 nullable: false - description: このフォルダの共有リンク。このフォルダに対してまだ共有リンクが作成されていない場合は、`null`になります。 nullable: true folder_upload_email: description: >- 以下のオプションのいずれかが**true**の場合、`folder_upload_email`パラメータは`null`ではありません。 - \[**このフォルダへのメールによるアップロードを許可する**] および \[**このフォルダのコラボレータにのみメールによるアップロードを許可する**] が[管理コンソールで1フォルダに対して有効](https://support.box.com/hc/en-us/articles/360043697534-Upload-to-Box-Through-Email)になっていて、ユーザーには少なくとも**アップロード**権限が付与されています。 - \[**このフォルダへのメールによるアップロードを許可する**] の設定が管理コンソールで1フォルダに対して有効になっていて、\[**このフォルダのコラボレータにのみメールによるアップロードを許可する**] の設定が無効 (オフ) になっています。 条件が満たされていない場合、パラメータには次の値が設定されます: `folder_upload_email: null`。 type: object nullable: true properties: access: description: >- このパラメータが設定されている場合、ユーザーは、このフォルダに対して自動的に作成されたメールアドレスに メールでファイルを送信できます。 メールアドレスを作成するには、フォルダを作成するとき、または更新するときにこのプロパティを設定します。 `collaborators`に設定すると、コラボレータの登録済み メールアドレスからのメールのみが受け入れられます。これには、ユーザーが登録しているすべてのメールエイリアスも含まれます。 `open`に設定すると、どのメールアドレスからのメールでも受け入れられます。 type: string example: open enum: - open - collaborators nullable: false email: description: このフォルダのアップロードメールアドレス (省略可)。 type: string format: email example: upload.Contracts.asd7asd@u.box.com nullable: false parent: allOf: - $ref: '#/components/schemas/Folder--Mini' - description: |- このフォルダが配置されているフォルダ (省略可) ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になることがあります。 nullable: true item_status: description: |- この項目が削除されたかどうかを定義します。 - `active` - 項目がごみ箱に移動されていない場合。 - `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。 - `deleted` - 項目がすでに完全に削除されている場合。 type: string example: active enum: - active - trashed - deleted nullable: false item_collection: allOf: - $ref: '#/components/schemas/Items' - description: >- フォルダ内の項目のページ。 このフィールドをリクエストできるのは、フォルダの情報をクエリで照会するときのみで、フォルダの項目をクエリで照会するときにはリクエストできません。 - nullable: false title: Folder x-box-resource-id: folder x-box-tag: folders x-box-variant: standard WebLink--Mini: description: |- ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。 ウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。 type: object allOf: - $ref: '#/components/schemas/WebLink--Base' - properties: url: description: このウェブリンクが指すURL。 type: string example: https://www.example.com/example/1234 sequence_id: allOf: - type: string example: '3' nullable: true description: >- この項目に適用された最新のUser Eventを表す数値の識別子。 これを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。 たとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。 - nullable: false name: description: ウェブリンクの名前。 type: string example: My Bookmark title: ウェブリンク (Mini) x-box-resource-id: web_link--mini x-box-tag: web_links x-box-variant: mini Folder--Mini: description: 他のリソースの下にネストされたときに使用されるファイルバージョンのMini版の表示。 type: object allOf: - $ref: '#/components/schemas/Folder--Base' - properties: sequence_id: allOf: - type: string example: '3' nullable: true description: >- この項目に適用された最新のUser Eventを表す数値の識別子。 これを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。 たとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。 - nullable: false name: description: フォルダの名前。 type: string example: Contracts nullable: false title: フォルダ (Mini) x-box-resource-id: folder--mini x-box-tag: folders x-box-variant: mini File--Mini: description: 他のリソースの下にネストされたときに使用されるファイルのMini版の表示。 type: object allOf: - $ref: '#/components/schemas/File--Base' - properties: sequence_id: allOf: - type: string example: '3' nullable: true description: >- この項目に適用された最新のUser Eventを表す数値の識別子。 これを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。 たとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。 - nullable: false name: description: ファイルの名前。 type: string example: Contract.pdf sha1: description: ファイルのSHA1ハッシュ。Box上のファイルとローカルファイルの内容を比較する目的に使用できます。 type: string format: digest example: 85136C79CBF9FE36BB9D05D0639C70C265C18D37 nullable: false file_version: allOf: - $ref: '#/components/schemas/FileVersion--Mini' - description: ファイルの現在のバージョンに関する情報。 nullable: true title: ファイル (Mini) x-box-resource-id: file--mini x-box-tag: files x-box-variant: mini User--Base: description: 他のリソース内にネストされたときに使用されるユーザーのMini版の表示。 type: object properties: id: description: このユーザーの一意の識別子。 type: string example: '11446498' type: description: 値は常に`user`になります。 type: string example: user enum: - user nullable: false required: - type - id title: ユーザー (Base) x-box-resource-id: user--base x-box-tag: users x-box-variant: base x-box-variants: - base - mini - standard - full Resource: description: ファイルまたはフォルダのリソース。 type: object oneOf: - $ref: '#/components/schemas/Folder--Mini' - $ref: '#/components/schemas/File--Mini' title: リソース Metadata: description: ファイルまたはフォルダに適用された、メタデータテンプレートのインスタンス。 type: object allOf: - $ref: '#/components/schemas/Metadata--Base' title: メタデータインスタンス x-box-resource-id: metadata x-box-tag: file_metadata x-box-variant: standard Items: description: Mini版の表示に含まれるファイル、フォルダ、ウェブリンクのリスト。 type: object allOf: - type: object description: マーカーベースのページネーションについて説明しているAPIレスポンスの部分。 properties: limit: description: >- これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。 type: integer format: int64 example: 1000 next_marker: description: 次の検索結果ページの開始場所のマーカー。 type: string example: JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii nullable: true prev_marker: description: 前の検索結果ページの開始場所のマーカー。 type: string example: JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih nullable: true - type: object description: ページネーションについて説明しているAPIレスポンスの部分。 properties: total_count: description: >- コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。 このフィールドは、オフセットベースのページネーションを使用する呼び出しのみで返されます。マーカーベースでページネーションされたAPIでは、このフィールドは省略されます。 type: integer format: int64 example: 5000 limit: description: >- これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。 type: integer format: int64 example: 1000 offset: description: >- このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。 このフィールドは、オフセットベースのページネーションを使用する呼び出しのみで返されます。マーカーベースでページネーションされたAPIでは、このフィールドは省略されます。 type: integer format: int64 example: 2000 order: description: >- 項目が返される順序。 このフィールドは、オフセットベースのページネーションを使用する呼び出しのみで返されます。マーカーベースでページネーションされたAPIでは、このフィールドは省略されます。 type: array items: type: object description: ページネーションの順序。 properties: by: description: 並べ替えに使用するフィールド。 type: string example: type direction: description: 並べ替えの方向 (昇順または降順)。 type: string example: ASC enum: - ASC - DESC - properties: entries: description: このコレクション内の項目。 type: array items: $ref: '#/components/schemas/Item' title: Items x-box-resource-id: items x-box-tag: folders WebLink--Base: description: |- ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。 ウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。 type: object properties: id: description: このウェブリンクの一意の識別子。 type: string example: '11446498' type: description: 値は常に`web_link`になります。 type: string example: web_link enum: - web_link etag: description: このウェブリンクのエンティティタグ。`If-Match`ヘッダーで使用します。 type: string example: '1' required: - id - type title: ウェブリンク (Base) x-box-resource-id: web_link--base x-box-tag: web_links x-box-variant: base x-box-variants: - base - mini - standard Folder--Base: description: 最も基本的なフォルダのBase版の表示。`fields`クエリパラメータを使用すると、最小限の数のフィールドが返されます。 type: object properties: id: description: >- フォルダを表す一意の識別子。 フォルダIDを確認するには、ウェブアプリケーションでフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folders/123`の場合、`folder_id`は`123`です。 type: string example: '12345' nullable: false etag: description: >- このフォルダのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にフォルダに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。 type: string example: '1' nullable: true type: description: 値は常に`folder`になります。 type: string example: folder enum: - folder nullable: false required: - id - type title: フォルダ (Base) x-box-resource-id: folder--base x-box-tag: folders x-box-variant: base x-box-variants: - base - mini - standard - full File--Base: description: 最も基本的なファイルのBase版の表示。`fields`クエリパラメータを使用すると、最小限の数のフィールドが返されます。 type: object properties: id: description: >- ファイルを表す一意の識別子。 ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。 type: string example: '12345' nullable: false etag: description: >- このファイルのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にファイルに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。 type: string example: '1' nullable: true type: description: 値は常に`file`になります。 type: string example: file enum: - file nullable: false nullable: true required: - id - type title: ファイル (Base) x-box-resource-id: file--base x-box-tag: files x-box-variant: base x-box-variants: - base - mini - standard - full FileVersion--Mini: description: 他のリソース内にネストされたときに使用されるファイルバージョンのMini版の表示。 type: object allOf: - $ref: '#/components/schemas/FileVersion--Base' - properties: sha1: description: ファイルの現在のバージョンのSHA1ハッシュ。 type: string example: 134b65991ed521fcfe4724b7d814ab8ded5185dc title: ファイルバージョン (Mini) x-box-resource-id: file_version--mini x-box-variant: mini Metadata--Base: description: メタデータインスタンスのBase版の表示。 type: object properties: $parent: description: >- このメタデータインスタンスが追加されている項目の識別子。これは、親の`type`と`id`を`{type}_{id}`という形式で組み合わせたものです。 type: string example: folder_59449484661, $template: description: テンプレートの名前。 type: string example: marketingCollateral $scope: description: >- このテンプレートが適用されているスコープのID。これは、この会社で使用するために定義されたテンプレートの場合は`enterprise_{enterprise_id}`、Boxを使用するすべての会社が利用できる一般的なテンプレートの場合は`global`になります。 type: string example: enterprise_27335 $version: description: メタデータインスタンスのバージョン。このバージョンは0から始まり、ユーザー定義プロパティが変更されるたびに増加します。 type: integer example: 1 title: メタデータインスタンス (Base) x-box-resource-id: metadata--base x-box-tag: file_metadata x-box-variant: base x-box-variants: - base - standard - full Item: description: 項目は、ファイル、フォルダ、またはウェブリンクを表します。 type: object oneOf: - $ref: '#/components/schemas/File--Full' - $ref: '#/components/schemas/Folder--Mini' - $ref: '#/components/schemas/WebLink' title: 項目 FileVersion--Base: description: 最も基本的なファイルバージョンのBase版の表示。`fields`クエリパラメータを使用すると、最小限の数のフィールドが返されます。 type: object properties: id: description: ファイルバージョンを表す一意の識別子。 type: string example: '12345' nullable: false type: description: 値は常に`file_version`になります。 type: string example: file_version enum: - file_version nullable: false required: - id - type title: ファイルバージョン (Base) x-box-resource-id: file_version--base x-box-variant: base x-box-variants: - base - mini - standard - full securitySchemes: OAuth2Security: type: oauth2 description: >- The access token received from the authorization server in the OAuth 2.0 flow. flows: authorizationCode: authorizationUrl: https://account.box.com/api/oauth2/authorize tokenUrl: https://api.box.com/oauth2/token scopes: root_readonly: Boxに格納されているすべてのファイルとフォルダの読み取り root_readwrite: Boxに格納されているすべてのファイルとフォルダの読み取りと書き込み manage_app_users: App Userのプロビジョニングと管理 manage_managed_users: 管理対象ユーザーのプロビジョニングと管理 manage_groups: 企業のグループの管理 manage_webhook: APIを使用したプログラムによるWebhookの作成 manage_enterprise_properties: Enterpriseのプロパティを管理 manage_data_retention: データリテンションポリシーの管理 manage_legal_hold: リーガルホールドの管理 ````