> ## 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 /collections/{collection_id}/items 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: /collections/{collection_id}/items: get: tags: - Collections summary: コレクション項目のリストを取得 description: このコレクションに含まれるファイルやフォルダを取得します。 operationId: get_collections_id_items parameters: - name: collection_id in: path description: コレクションのID。 required: true schema: type: string example: '926489' - 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: limit in: query description: 返す項目の1ページあたりの最大数。 required: false schema: type: integer format: int64 maximum: 1000 example: 1000 responses: '200': description: コレクション内の項目の配列を返します。 content: application/json: schema: $ref: '#/components/schemas/ItemsOffsetPaginated' 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/collections/926489/items" \ -H "authorization: Bearer " - lang: dotnet label: コレクション項目のリストを取得 source: >- await client.Collections.GetCollectionItemsAsync(collectionId: NullableUtils.Unwrap(favouriteCollection.Id)); - lang: swift label: コレクション項目のリストを取得 source: >- try await client.collections.getCollectionItems(collectionId: favouriteCollection.id!) - lang: node label: コレクション項目のリストを取得 source: >- await client.collections.getCollectionItems(favouriteCollection.id!); - lang: python label: コレクション項目のリストを取得 source: client.collections.get_collection_items(favourite_collection.id) components: schemas: ItemsOffsetPaginated: description: Mini版の表示に含まれるファイル、フォルダ、ウェブリンクのリスト。 type: object allOf: - 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_offset_paginated x-box-tag: folders 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 Item: description: 項目は、ファイル、フォルダ、またはウェブリンクを表します。 type: object oneOf: - $ref: '#/components/schemas/File--Full' - $ref: '#/components/schemas/Folder--Mini' - $ref: '#/components/schemas/WebLink' title: 項目 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--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 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 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--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 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 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 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 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 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: リーガルホールドの管理 ````