{ "openapi": "3.0.2", "info": { "title": "Box Platform API", "description": "[Box Platform](https://box.dev)では、[Box](https://box.com)内に保存されているコンテンツへのアクセス権限を付与する機能が提供されています。また、ファイルとフォルダの基本操作、会社内のユーザーの管理、リーガルホールドやリテンションポリシーなどの複雑なトピックのためのエンドポイントも提供されています。", "termsOfService": "https://cloud.app.box.com/s/rmwxu64h1ipr41u49w3bbuvbsa29wku9", "contact": { "name": "Box, Inc", "url": "https://box.dev", "email": "devrel@box.com" }, "license": { "name": "Apache-2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "2.0.0", "x-box-commit-hash": "a2f6edcf0a" }, "servers": [ { "url": "https://api.box.com/2.0", "description": "Box Platform APIサーバー" } ], "paths": { "/authorize": { "get": { "operationId": "get_authorize", "summary": "ユーザーを承認", "description": "ユーザーを[Box](https://box.com)ウェブサイトにリダイレクトして承認し、ユーザーに代わって操作を実行する権限をリクエストします。\n\nこれは、OAuth 2.0を使用してユーザーを承認する際の最初の手順です。Box APIをユーザーに代わって使用することについて、ユーザーに承認してもらうようリクエストするには、この形式を使用してユーザーを所定のURLにリダイレクトする必要があります。", "tags": [ "承認" ], "x-box-tag": "authorization", "security": [], "servers": [ { "url": "https://account.box.com/api/oauth2", "description": "クライアント側認証用サーバー" } ], "parameters": [ { "name": "response_type", "description": "受信するレスポンスのタイプ。", "in": "query", "example": "code", "required": true, "schema": { "type": "string", "format": "token", "enum": [ "code" ] } }, { "name": "client_id", "description": "ユーザーの認証をリクエストしているアプリケーションのクライアントID。アプリケーションのクライアントIDを取得するには、Box開発者コンソールにログインして、該当するアプリケーションの \\[**アプリケーションの編集**] リンクをクリックします。\\[構成] ページの \\[OAuth2パラメータ] セクションで、`client_id`というラベルの付いた項目を探します。その項目のテキストが、アプリケーションのクライアントIDです。", "in": "query", "example": "ly1nj6n11vionaie65emwzk575hnnmrk", "required": true, "schema": { "type": "string" } }, { "name": "redirect_uri", "description": "ユーザーがアプリケーションの権限を許可または拒否した後にブラウザがリダイレクトされるURI。このURIは、アプリケーションの構成に含まれるリダイレクトURIのいずれかと一致します。このURIは有効なHTTPS URIでなければならず、OAuth 2.0フローの次の手順を完了するには、リダイレクトを処理できる状態になっている必要があります。このパラメータは省略可能ですが、開発者コンソールでアプリケーション用にリダイレクトURIを複数設定した場合は、承認URLに含める必要があります。パラメータが指定されていないと、ユーザーがアプリケーションにアクセス権限を付与した後に`redirect_uri_missing`エラーが発生します。", "in": "query", "example": "http://example.com/auth/callback", "required": false, "schema": { "type": "string", "format": "url" } }, { "name": "state", "description": "任意のカスタム文字列。認証が完了すると、同じ文字列がBoxからリダイレクトURLに渡されます。このパラメータを使用するとリダイレクト時にユーザーを識別できるだけでなく、ハイジャックされたセッションやその他の悪用を防止できます。", "in": "query", "example": "my_state", "required": false, "schema": { "type": "string" } }, { "name": "scope", "description": "ユーザーを認証するアプリケーションスコープのスペース区切りのリスト。デフォルトでは、\\[構成] ページでアプリケーションに対して構成されているすべてのスコープになります。", "in": "query", "example": "admin_readwrite", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "何もデータを返しませんが、ブラウザで使用するようにしてください。", "content": { "text/html": { "schema": { "type": "string", "format": "html" } } } }, "default": { "description": "何もデータを返しませんが、ブラウザで使用するようにしてください。", "content": { "text/html": { "schema": { "type": "string", "format": "html" } } } } } } }, "/oauth2/token": { "post": { "operationId": "post_oauth2_token", "summary": "アクセストークンをリクエスト", "description": "クライアント側で取得したOAuth 2.0認証コードまたはサーバー側のJWTアサーションを使用してアクセストークンをリクエストします。\n\nアクセストークンとは、リクエストが認証済みセッションに属していることをBoxで検証するための文字列です。通常の手順では、最初にユーザーが[承認](#get-authorize)エンドポイントに対して認証をリクエストした後で、Boxが認証コードを送信します。\n\nユーザーはこのエンドポイントに認証コードを送信してアクセストークンと交換します。返されたアクセストークンは、Box APIコールを行うときに使用できます。", "tags": [ "承認" ], "servers": [ { "url": "https://api.box.com", "description": "サーバー側認証に使用するサーバー" } ], "x-box-tag": "authorization", "security": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PostOAuth2Token" } } } }, "responses": { "200": { "description": "`Authorization: Bearer `のように承認ヘッダー内でトークンを渡すことによって認証済みのAPIコールを行うために使用できる新しいアクセストークンを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessToken" } } } }, "400": { "description": "認証エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuth2Error" } } } }, "default": { "description": "認証エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuth2Error" } } } } } } }, "/oauth2/token#refresh": { "post": { "operationId": "post_oauth2_token#refresh", "summary": "アクセストークンを更新", "description": "クライアントID、シークレット、更新トークンを使用してアクセストークンを更新します。", "tags": [ "承認" ], "servers": [ { "url": "https://api.box.com", "description": "サーバー側認証に使用するサーバー" } ], "x-box-tag": "authorization", "x-box-is-variation": true, "security": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PostOAuth2Token--RefreshAccessToken" } } } }, "responses": { "200": { "description": "`Authorization: Bearer `のように承認ヘッダー内でトークンを渡すことによって認証済みのAPIコールを行うために使用できる新しいアクセストークンを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessToken" } } } }, "400": { "description": "認証エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuth2Error" } } } }, "default": { "description": "認証エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuth2Error" } } } } } } }, "/oauth2/revoke": { "post": { "operationId": "post_oauth2_revoke", "summary": "アクセストークンを取り消し", "description": "アクティブなアクセストークンを無効にします。これにより、認証されていたユーザーはログアウトされます。", "tags": [ "承認" ], "servers": [ { "url": "https://api.box.com", "description": "サーバー側認証に使用するサーバー" } ], "x-box-tag": "authorization", "security": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PostOAuth2Revoke" } } } }, "responses": { "200": { "description": "トークンが正常に無効化された場合は、空のレスポンスを返します。" }, "400": { "description": "認証エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuth2Error" } } } }, "default": { "description": "認証エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuth2Error" } } } } } } }, "/files/{file_id}": { "get": { "operationId": "get_files_id", "summary": "ファイル情報を取得", "tags": [ "Files" ], "x-box-tag": "files", "x-box-enable-explorer": true, "description": "ファイルに関する詳細を取得します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。\n\nまた、このフィールドを使用すると、ファイルに適用されている任意のメタデータに対してクエリを実行できます。その際、`metadata`フィールドのほか、取得するテンプレートのスコープとキー (例: `?fields=metadata.enterprise_12345.contractTemplate`) も指定します。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "if-none-match", "description": "項目が変更されている場合にのみ、その項目を返します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは`304 Not Modified`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "boxapi", "description": "この項目の共有リンクのURLと省略可能なパスワード。\n\nこのヘッダーを使用すると、ユーザーと明示的に共有されていない項目にアクセスできます。\n\n`shared_link=[link]`形式を使用するか、パスワードが必要な場合は`shared_link=[link]&shared_link_password=[password]`を使用します。\n\nこのヘッダーは、共有されているファイルまたはフォルダのほか、その項目内にネストされているすべてのファイルやフォルダで使用できます。", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "x-rep-hints", "description": "ファイルの特定の`representations`をリクエストするために必要なヘッダー。特定のファイルレプリゼンテーションをリクエストするには、このヘッダーを`fields`クエリパラメータと組み合わせて使用します。\n\nこれらのレプリゼンテーションの一般的な形式は`X-Rep-Hints: [...]`で、`[...]`の部分では`[fileType?query]`という形式で1つまたは複数のヒントを指定します。\n\nたとえば、ピクセルサイズ`32x32`および`64x64`の`png`レプリゼンテーションをリクエストするには、以下のヒントを指定します。\n\n`x-rep-hints: [jpg?dimensions=32x32][jpg?dimensions=64x64]`\n\nまた、`[extracted_text]`レプリゼンテーションを使用すると、Box内のすべてのドキュメントファイルタイプに`text`レプリゼンテーションを使用できます。\n\n`x-rep-hints: [extracted_text]`", "example": "[pdf]", "in": "header", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "ファイルオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" } } } }, "304": { "description": "`If-None-Match`ヘッダーがフォルダの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、フォルダが前回リクエストされたときから変更されていないことを示します。" }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "415": { "description": "誤ったメディアタイプのファイルに対してアクションが実行されると、エラーが返されます。\n\n* Box Embedでサポートされないファイルの`expiring_embed_link`をリクエストすると、`unsupported_media_type`が返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_files_id", "summary": "ファイルを復元", "tags": [ "ごみ箱内のファイル" ], "x-box-tag": "trashed_files", "description": "ごみ箱に移動されたファイルを復元します。\n\n元のフォルダが削除されている場合にフォルダの復元先となる新しい親ID (省略可) を指定することができます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "description": "ファイルの新しい名前 (省略可)。", "example": "Restored.docx", "type": "string" }, "parent": { "allOf": [ { "type": "object", "description": "この項目の親", "properties": { "id": { "type": "string", "description": "親項目のID", "example": "123" } } }, { "description": "元のフォルダがすでに存在しない場合にファイルの復元先となるフォルダのID (省略可) を指定します。\n\nこのIDは、元のフォルダがすでに存在しない場合にのみ使用されることに注意してください。このIDは、元の場所が削除されている場合にファイルの復元先となるフォールバックの場所を指定します。" } ] } } } } } }, "responses": { "201": { "description": "ファイルが復元されたときにファイルオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrashFileRestored" } } } }, "403": { "description": "ファイルの復元先フォルダに対してユーザーがアクセス権限を持っていない場合、またはごみ箱からファイルを復元する権限を持っていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "ファイルの復元先フォルダに同じ名前のファイルが存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_id", "summary": "ファイルを更新", "tags": [ "Files" ], "x-box-tag": "files", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ファイルを更新します。ファイルの名前変更や移動、共有リンクの作成、ファイルのロックといった目的に使用できます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "ファイルの別の名前 (省略可)。これを使用してファイルの名前を変更できます。", "example": "NewFile.txt" }, "description": { "type": "string", "description": "ファイルの説明。Boxウェブアプリでファイルを表示すると、右側のサイドバーパネルに表示されます。さらに、このインデックスはファイルの検索インデックスで使用されるため、ユーザーは説明の内容でファイルを見つけることができます。", "maxLength": 256, "example": "The latest reports. Automatically updated" }, "parent": { "allOf": [ { "type": "object", "description": "この項目の親", "properties": { "id": { "type": "string", "description": "親項目のID", "example": "123" } } }, { "description": "ファイルの新しい親フォルダ (省略可)。これを使用して、ファイルを新しいフォルダに移動できます。" } ] }, "shared_link": { "allOf": [ { "description": "項目の共有リンクを定義します。これを`null`に設定すると、共有リンクが削除されます。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" } } } } }, { "description": "ファイルの共有リンクを定義します。これを`null`に設定すると、共有リンクが削除されます。" } ] }, "lock": { "type": "object", "description": "項目のロックを定義します。これにより、ロックを作成したユーザー以外は、この項目を移動、名前変更、および変更できなくなります。\n\nこれを`null`に設定すると、ロックが削除されます。", "required": [ "type" ], "properties": { "access": { "type": "string", "description": "このオブジェクトのタイプ。", "enum": [ "lock" ], "example": "lock" }, "expires_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "ロックが期限切れになる日時を定義します。" }, "is_download_prevented": { "type": "boolean", "example": true, "description": "ロック中でもファイルのダウンロードを許可するかどうかを定義します。" } } }, "disposition_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "特定のファイルのリテンションの有効期限のタイムスタンプ。この日付は、一度ファイルに設定すると短縮できません。" }, "permissions": { "description": "ファイルをダウンロードできるユーザーを定義します。", "type": "object", "properties": { "can_download": { "description": "このファイルのダウンロードが許可されるユーザーを定義します。使用可能な値は、`open` (すべてのユーザー) または`company` (ユーザーの会社のその他のメンバー) です。\n\nこの設定は、通常コラボレーションの`role`に含まれるダウンロード権限より優先されます。`company`に設定すると、基本的に、ロールが`viewer`または`editor`である外部ユーザーのダウンロードオプションが削除されます。", "type": "string", "example": "open", "enum": [ "open", "company" ] } } }, "collections": { "type": "array", "description": "このファイルをメンバーとして追加するコレクションの配列。現時点では、`favorites`コレクションのみがサポートされています。\n\nコレクションのIDを取得するには、[すべてのコレクションのリストを取得][1]エンドポイントを使用します。\n\n空の配列`[]`または`null`を渡すと、すべてのコレクションからこのファイルが削除されます。\n\n[1]: e://get-collections", "items": { "title": "Reference", "description": "オブジェクトの最も基本的な参照", "type": "object", "properties": { "id": { "type": "string", "description": "このオブジェクトの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "このオブジェクトのタイプ", "example": "file" } } } }, "tags": { "type": "array", "example": [ "approved" ], "items": { "type": "string" }, "minItems": 1, "maxItems": 100, "description": "この項目のタグ。これらのタグはBoxウェブアプリおよびモバイルアプリで項目の横に表示されます。\n\nタグを追加または削除するには、項目の現在のタグを取得して変更してから、このフィールドを更新します。\n\nタグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに制限されます。" } } } } } }, "responses": { "200": { "description": "ファイルオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" } } } }, "400": { "description": "新しいリテンション期間が最大リテンション期間を超える場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。\n\n* 認証済みユーザーにファイルの移動先フォルダへのアクセス権限がない場合に`access_denied_insufficient_permissions`が返されます。\n* リテンション期間が現在のリテンションのタイムスタンプと等しいか、それより短い場合に返されます。\n* リテンションの対象でない`file_id`が入力された場合に返されます。\n* ファイルが保持されているものの、廃棄アクションが`remove_retention`に設定されている場合に返されます。\n* 情報バリアの制限によりフォルダのコピーが禁止されている場合に`forbidden_by_policy`が返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id", "summary": "ファイルを削除", "tags": [ "Files" ], "x-box-tag": "files", "x-box-sanitized": true, "description": "ファイルを削除します (完全に削除するか、ごみ箱に移動します)。\n\n項目がBoxから完全に削除されるか、ごみ箱に移動されるかは、会社の設定により決定されます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } } ], "responses": { "204": { "description": "ファイルが正常に削除された場合は、空のレスポンスを返します。" }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからないかすでに削除されている場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/content": { "get": { "operationId": "get_files_id_content", "summary": "ファイルをダウンロード", "tags": [ "ダウンロード" ], "x-box-tag": "downloads", "description": "ファイルのコンテンツをバイナリ形式で返します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "range", "description": "ダウンロードするコンテンツのバイト範囲。\n\n`bytes={start_byte}-{end_byte}`の形式を使用して、ダウンロードするファイルのセクションを指定できます。", "example": "bytes=0-1024", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "boxapi", "description": "この項目の共有リンクのURLと省略可能なパスワード。\n\nこのヘッダーを使用すると、ユーザーと明示的に共有されていない項目にアクセスできます。\n\n`shared_link=[link]`形式を使用するか、パスワードが必要な場合は`shared_link=[link]&shared_link_password=[password]`を使用します。\n\nこのヘッダーは、共有されているファイルまたはフォルダのほか、その項目内にネストされているすべてのファイルやフォルダで使用できます。", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "version", "description": "ダウンロードするファイルバージョン", "example": "4", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "access_token", "description": "このリクエストの事前認証に使用できるアクセストークン (省略可)。つまり、ダウンロードリンクは、認証の処理方法を知らなくても、ブラウザまたはサードパーティのサービスと共有できます。このパラメータを使用する際は、そのファイルへの読み取りアクセスだけを許可するよう、アクセストークンが十分にダウンスコープされていることを確認してください。", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "クライアントが自動的にリダイレクトとしてHTTP `3xx`レスポンスに従うように**リダイレクトに従う**設定を有効にしている場合は、リクエストされたファイルを返します。有効にしていない場合は、代わりに`302`が返されます。詳細については、[ファイルのダウンロードに関するガイド](g://downloads/file#download-url)を参照してください。", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "description": "ファイルのバイナリコンテンツ" } } } }, "202": { "description": "ファイルをダウンロードする準備ができていない場合は、クライアントがファイルをダウンロードできるようになるまでの秒数を示す`Retry-After`ヘッダーが返されます。\n\nこのレスポンスは、ダウンロードリクエストの直前にファイルがアップロードされた場合に発生することがあります。", "headers": { "Retry-After": { "description": "ダウンロードを再試行するまでの秒数", "schema": { "type": "integer" } } } }, "302": { "description": "ファイルがダウンロード可能な場合、レスポンスには`dl.boxcloud.com`上のファイルの`Location`ヘッダーが含まれます。\n\n`dl.boxcloud.com`というURLは永続的ではないため、クライアントで実際にファイルをダウンロードするには、リダイレクト指示に従う必要があります。", "headers": { "Location": { "description": "ダウンロードURLへのポインタ", "schema": { "type": "string", "format": "url" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_files_id_content", "tags": [ "アップロード" ], "x-box-tag": "uploads", "summary": "ファイルバージョンをアップロード", "description": "ファイルのコンテンツを更新します。ファイルサイズが50 MBを超える場合は、分割アップロードAPIを使用することをお勧めします。\n\n# リクエスト本文の順序\n\n本文の`attributes`部分は`file`部分の**前**に置く必要があります。ファイルのアップロード時にリクエストがこの形式に従っていない場合は、HTTP `400`エラーと`metadata_after_file_contents`エラーコードが返されます。", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "content-md5", "required": false, "schema": { "type": "string" }, "example": "134b65991ed521fcfe4724b7d814ab8ded5185dc", "in": "header", "description": "ファイルが転送中に破損していないことを確認するための、ファイルのSHA1ハッシュを含むヘッダー (省略可)。" } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "attributes", "file" ], "properties": { "attributes": { "description": "アップロードされるファイルの追加の属性。主に名前と親フォルダ。これらの属性はマルチパートリクエスト本文に含まれており、JSON形式です。\n\n\n\n 本文の`attributes`部分は`file`部分の**前**に置く必要があります。ファイルのアップロード時にリクエストがこの形式に従っていない場合は、HTTP `400`エラーと`metadata_after_file_contents`エラーコードが返されます。\n\n", "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "ファイルの新しい名前 (省略可)。指定した場合は、新しいバージョンがアップロードされると、ファイル名が変更されます。", "example": "Photo 2.0.png" }, "content_modified_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "ファイルが最後に変更された日時を示します。\n\n設定されていない場合は、アップロード日時が使用されます。" } } }, "file": { "type": "string", "format": "binary", "description": "Boxにアップロードするファイルのコンテンツ。\n\n\n\n 本文の`attributes`部分は`file`部分の**前**に置く必要があります。ファイルのアップロード時にリクエストがこの形式に従っていない場合は、HTTP `400`エラーと`metadata_after_file_contents`エラーコードが返されます。\n\n" } } } } } }, "responses": { "200": { "description": "リスト内の新しいファイルオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Files" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/content": { "options": { "operationId": "options_files_content", "summary": "アップロード前の事前チェック", "tags": [ "Files" ], "x-box-tag": "uploads", "description": "ファイル全体をアップロードする前に、ファイルがBoxで受け入れられるかどうかをチェックします。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "ファイルの名前", "example": "File.mp4" }, "size": { "type": "integer", "format": "int32", "description": "ファイルのサイズ (バイト単位)", "example": 1024 }, "parent": { "allOf": [ { "type": "object", "description": "この項目の親", "properties": { "id": { "type": "string", "description": "親項目のID", "example": "123" } } }, { "description": "ファイルのアップロード先の親フォルダ" } ] } } } } } }, "responses": { "200": { "description": "チェックに合格した場合、レスポンスにはファイルのアップロード先として使用できるセッションURLが含まれます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadUrl" } } } }, "409": { "description": "チェックに合格しなかった場合、レスポンスにはその理由に関する詳細が含まれます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_files_content", "tags": [ "アップロード" ], "x-box-tag": "uploads", "summary": "ファイルをアップロード", "description": "小さいファイルをBoxにアップロードします。ファイルサイズが50 MBを超える場合は、分割アップロードAPIを使用することをお勧めします。\n\n# リクエスト本文の順序\n\n本文の`attributes`部分は`file`部分の**前**に置く必要があります。ファイルのアップロード時にリクエストがこの形式に従っていない場合は、HTTP `400`エラーと`metadata_after_file_contents`エラーコードが返されます。", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "content-md5", "required": false, "schema": { "type": "string" }, "example": "134b65991ed521fcfe4724b7d814ab8ded5185dc", "in": "header", "description": "ファイルが転送中に破損していないことを確認するための、ファイルのSHA1ハッシュを含むヘッダー (省略可)。" } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "attributes", "file" ], "properties": { "attributes": { "description": "アップロードされるファイルの追加の属性。主に名前と親フォルダ。これらの属性はマルチパートリクエスト本文に含まれており、JSON形式です。\n\n\n\n 本文の`attributes`部分は`file`部分の**前**に置く必要があります。ファイルのアップロード時にリクエストがこの形式に従っていない場合は、HTTP `400`エラーと`metadata_after_file_contents`エラーコードが返されます。\n\n", "type": "object", "required": [ "name", "parent" ], "properties": { "name": { "type": "string", "description": "ファイルの名前", "example": "Photo.png" }, "parent": { "type": "object", "description": "ファイルのアップロード先の親フォルダ", "required": [ "id" ], "properties": { "id": { "type": "string", "example": "124132", "description": "親フォルダのID。ユーザーのルートフォルダを指定するには、`0`を使用します。" } } }, "content_created_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "ファイルが最初に作成された日時を定義します。\n\n設定されていない場合は、アップロード日時が使用されます。" }, "content_modified_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "ファイルが最後に変更された日時を示します。\n\n設定されていない場合は、アップロード日時が使用されます。" } } }, "file": { "type": "string", "format": "binary", "description": "Boxにアップロードするファイルのコンテンツ。\n\n\n\n 本文の`attributes`部分は`file`部分の**前**に置く必要があります。ファイルのアップロード時にリクエストがこの形式に従っていない場合は、HTTP `400`エラーと`metadata_after_file_contents`エラーコードが返されます。\n\n" } } } } } }, "responses": { "201": { "description": "リスト内の新しいファイルオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Files" } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `bad_request` - パラメータが指定されていないか誤っている場合に返されます。\n* `item_name_too_long` - フォルダ名が長すぎる場合に返されます。\n* `item_name_invalid` - フォルダ名に無効な文字が含まれている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "親フォルダが存在しない場合、またはユーザーが親フォルダへのアクセスを承認されていない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "ファイルがすでに存在する場合、またはアカウントのディスク容量が不足している場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/upload_sessions": { "post": { "operationId": "post_files_upload_sessions", "summary": "アップロードセッションを作成", "tags": [ "アップロード (分割)" ], "x-box-tag": "chunked_uploads", "description": "新しいファイルのアップロードセッションを作成します。", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "folder_id", "file_size", "file_name" ], "properties": { "folder_id": { "description": "新しいファイルのアップロード先フォルダのID。", "type": "string", "example": "0" }, "file_size": { "description": "アップロードされるファイルの合計バイト数", "example": 104857600, "type": "integer", "format": "int64" }, "file_name": { "description": "新規ファイルの名前", "example": "Project.mov", "type": "string" } } } } } }, "responses": { "201": { "description": "新しいアップロードセッションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadSession" } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `missing_destination`: `folder_id`が指定されていません\n* `invalid_folder_id`: `folder_id`が無効です\n* `item_name_invalid`: `file_name`が無効です\n* `missing_file_size`: `file_size`が指定されていません\n* `invalid_file_size`: `file_size`が有効な数値ではありません\n* `file_size_too_small`: `file_size`が、このAPIによるアップロードの最小ファイルサイズを下回っています\n* `missing_file_name`: `file_name`が指定されていません", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "何らかの理由で操作が許可されていない場合にエラーを返します。\n\n* `storage_limit_exceeded`: アカウントのストレージサイズの上限に達しました", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "親フォルダが見つからないか、認証済みユーザーが親フォルダにアクセスできない場合はエラーを返します。\n\n* `invalid_parameter`: `folder_id`値は、ユーザーがアクセスできないフォルダまたは存在しないフォルダを表します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "ファイルがすでに存在する場合、またはアカウントのディスク容量が不足している場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/upload_sessions": { "post": { "operationId": "post_files_id_upload_sessions", "summary": "既存ファイルのアップロードセッションを作成", "tags": [ "アップロード (分割)" ], "x-box-tag": "chunked_uploads", "description": "既存ファイルのアップロードセッションを作成します。", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "file_size" ], "properties": { "file_size": { "description": "アップロードされるファイルの合計バイト数", "example": 104857600, "type": "integer", "format": "int64" }, "file_name": { "description": "新規ファイルの新しい名前 (省略可)", "example": "Project.mov", "type": "string" } } } } } }, "responses": { "201": { "description": "新しいアップロードセッションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadSession" } } } }, "409": { "description": "ファイルがすでに存在する場合、またはアカウントのディスク容量が不足している場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/upload_sessions/{upload_session_id}": { "get": { "operationId": "get_files_upload_sessions_id", "summary": "アップロードセッションを取得", "tags": [ "アップロード (分割)" ], "description": "アップロードセッションに関する情報を返します。", "x-box-tag": "chunked_uploads", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "parameters": [ { "name": "upload_session_id", "description": "アップロードセッションのID。", "example": "D5E3F7A", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "アップロードセッションオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadSession" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_upload_sessions_id", "summary": "ファイルの一部をアップロード", "tags": [ "アップロード (分割)" ], "x-box-tag": "chunked_uploads", "description": "ファイルのアップロードセッションのチャンクを更新します。", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "parameters": [ { "name": "upload_session_id", "description": "アップロードセッションのID。", "example": "D5E3F7A", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "digest", "description": "分割アップロードの[RFC3230][1]メッセージのダイジェスト。\n\nサポートされているのはSHA1のみです。SHA1ダイジェストはbase64でエンコードされている必要があります。このヘッダーの形式は、`sha=BASE64_ENCODED_DIGEST`です。\n\n`SHA`ダイジェストの値を取得するには、openSSLコマンドを使用して、ファイルのパーツをエンコードします: `openssl sha1 -binary | base64`\n\n[1]: https://tools.ietf.org/html/rfc3230", "example": "sha=fpRyg5eVQletdZqEKaFlqwBXJzM=", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "content-range", "description": "チャンクのバイト範囲。\n\nこのセッションですでにアップロードされたパーツの範囲と重複しないようにしてください。各パーツのサイズは、作成したアップロードセッションで指定されているパーツサイズとまったく同じサイズである必要があります。ただし、ファイルの最後のパーツは小さくなる可能性があるため、例外となります。\n\n`content-range`の値を指定する際は、以下の点に注意してください。\n\n* 各パーツのバイト範囲の下限は、パーツサイズの倍数にする必要があります。\n* 上限は、パーツサイズの倍数から1を引いた値にする必要があります。", "example": "bytes 8388608-16777215/445856194", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "description": "ファイルのバイナリコンテンツ" } } } }, "responses": { "200": { "description": "チャンクは正常にアップロードされました。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadedPart" } } } }, "409": { "description": "チャンクがこれまでにアップロードされた別のチャンクと競合する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "前提条件を満たしていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "416": { "description": "コンテンツの範囲がセッションの指定範囲と一致しない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_upload_sessions_id", "summary": "アップロードセッションを削除", "tags": [ "アップロード (分割)" ], "description": "アップロードセッションを中断して、アップロードされたすべてのデータを破棄します。\n\nこの操作は元に戻せません。", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "x-box-tag": "chunked_uploads", "parameters": [ { "name": "upload_session_id", "description": "アップロードセッションのID。", "example": "D5E3F7A", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "セッションが正常に中断された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/upload_sessions/{upload_session_id}/parts": { "get": { "operationId": "get_files_upload_sessions_id_parts", "summary": "パーツのリストを取得", "tags": [ "アップロード (分割)" ], "x-box-tag": "chunked_uploads", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "description": "現在までにアップロードセッションにアップロードされたチャンクのリストを返します。", "parameters": [ { "name": "upload_session_id", "description": "アップロードセッションのID。", "example": "D5E3F7A", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "アップロードされたパーツのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadParts" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/upload_sessions/{upload_session_id}/commit": { "post": { "operationId": "post_files_upload_sessions_id_commit", "summary": "アップロードセッションをコミット", "tags": [ "アップロード (分割)" ], "x-box-tag": "chunked_uploads", "servers": [ { "url": "https://upload.box.com/api/2.0", "description": "ファイルアップロードに使用するサーバー" } ], "description": "アップロードセッションを閉じて、アップロード済みのチャンクからファイルを作成します。", "parameters": [ { "name": "upload_session_id", "description": "アップロードセッションのID。", "example": "D5E3F7A", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "digest", "description": "ファイル全体の[RFC3230][1]メッセージのダイジェスト。\n\nサポートされているのはSHA1のみです。SHA1ダイジェストはBase64でエンコードされている必要があります。このヘッダーの形式は、`sha=BASE64_ENCODED_DIGEST`です。\n\n[1]: https://tools.ietf.org/html/rfc3230", "in": "header", "example": "sha=fpRyg5eVQletdZqEKaFlqwBXJzM=", "required": true, "schema": { "type": "string" } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "if-none-match", "description": "項目が変更されている場合にのみ、その項目を返します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは`304 Not Modified`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "parts" ], "properties": { "parts": { "type": "array", "description": "アップロードされたパーツのリストの詳細", "items": { "$ref": "#/components/schemas/UploadPart" } } } } } } }, "responses": { "201": { "description": "リスト内のファイルオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Files" } } } }, "202": { "description": "すべてのチャンクがすでにアップロードされているものの、まだ処理されていない場合に返されます。\n\nアップロードセッションを調べてチャンク処理の進捗状況に関する詳細情報を取得し、すべてのチャンクが処理された後でファイルのコミットを再試行します。", "headers": { "Retry-After": { "description": "コミットリクエストの再試行までクライアントが待機する秒数を示します。", "schema": { "type": "integer" } } } }, "409": { "description": "ターゲットフォルダに同じ名前のファイルがすでに存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`または`If-None-Match`条件に一致しなかった場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/copy": { "post": { "operationId": "post_files_id_copy", "summary": "ファイルをコピー", "description": "ファイルのコピーを作成します。", "tags": [ "Files" ], "x-box-tag": "files", "x-box-enable-explorer": true, "x-box-sanitized": true, "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "parent" ], "nullable": false, "properties": { "name": { "type": "string", "description": "コピーされたファイルの新しい名前 (省略可)。\n\nファイル名にはいくつかの制約があります。印刷不可能なASCII文字、スラッシュ、およびバックスラッシュ (`/`、`\\`) を含む名前のほか、`.`や`..`のような予約済みの名前は、許可されていない文字を削除することで自動的にサニタイズされます。", "example": "FileCopy.txt", "maxLength": 255 }, "version": { "type": "string", "description": "コピーする特定のファイルバージョンのID (省略可)", "example": "0" }, "parent": { "type": "object", "description": "ファイルのコピー先となるフォルダ。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "ファイルのコピー先となるフォルダのID。", "example": "0" } } } } } } } }, "responses": { "201": { "description": "コピーされたファイルを表す新しいファイルオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" } } } }, "304": { "description": "`If-None-Match`ヘッダーがファイルの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、ファイルが前回リクエストされたときから変更されていないことを示します。" }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `bad_request` - パラメータが指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーにファイルのコピーを作成するための適切な権限がない場合にエラーを返します。\n\n* `forbidden_by_policy`: 情報バリアの制限によりファイルのコピーが禁止されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ソースファイルまたは宛先フォルダのどちらも見つからないか、認証済みユーザーがどちらにもアクセスできない場合はエラーを返します。\n\n* `not_found` - 認証済みユーザーがソースファイルまたは宛先フォルダにアクセスできない場合に返されます", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "* `operation_blocked_temporary`: 別の移動、コピー、削除、または復元操作が進行中であるために宛先フォルダまたは元のフォルダがロックされている場合に返されます。\n\n 操作は後で再試行することができます。\n\n* `item_name_in_use` - 同じ名前のフォルダがすでに存在している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/thumbnail.{extension}": { "get": { "operationId": "get_files_id_thumbnail_id", "summary": "ファイルサムネイルを取得", "description": "ファイルのサムネイル (小さい画像レプリゼンテーション) を取得します。\n\nサイズ`32x32`、`64x64`、`128x128`、`256x256`は`.png`形式で返すことができます。また、サイズ`32x32`、`160x160`、`320x320`は`.jpg`形式で返すことができます。\n\nサムネイルを生成できる画像および動画ファイルの形式については、[こちら][1]を参照してください。\n\n[1]: https://community.box.com/t5/Migrating-and-Previewing-Content/File-Types-and-Fonts-Supported-in-Box-Content-Preview/ta-p/327", "tags": [ "Files" ], "x-box-tag": "files", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "extension", "description": "サムネイルのファイル形式", "in": "path", "required": true, "example": "png", "schema": { "type": "string", "enum": [ "png", "jpg" ] } }, { "name": "min_height", "description": "サムネイルの高さの最小値", "in": "query", "example": 32, "schema": { "type": "integer", "minimum": 32, "maximum": 320 } }, { "name": "min_width", "description": "サムネイルの幅の最小値", "in": "query", "example": 32, "schema": { "type": "integer", "minimum": 32, "maximum": 320 } }, { "name": "max_height", "description": "サムネイルの高さの最大値", "in": "query", "required": false, "example": 320, "schema": { "type": "integer", "minimum": 32, "maximum": 320 } }, { "name": "max_width", "description": "サムネイルの幅の最大値", "in": "query", "required": false, "example": 320, "schema": { "type": "integer", "minimum": 32, "maximum": 320 } } ], "responses": { "200": { "description": "サムネイルを作成できる場合は、レスポンスの本文内でサムネイルデータが返されます。", "content": { "image/png": { "schema": { "type": "string", "format": "binary", "description": "サムネイル" } }, "image/jpg": { "schema": { "type": "string", "format": "binary", "description": "サムネイル" } } } }, "202": { "description": "サムネイルの生成には数秒かかることがあります。そのような場合、APIはこのファイルタイプに対して使用できるプレースホルダグラフィックを示す`Location`ヘッダーを返します。\n\nプレースホルダグラフィックはサムネイルの生成が完了するまでユーザーインターフェースで使用できます。`Retry-After`ヘッダーは、サムネイルの準備がいつ完了するかを示します。その時点で、このエンドポイントを再試行するとサムネイルを取得できます。", "headers": { "Retry-After": { "description": "サムネイルが利用可能になるまでの時間(秒)。\n\nアプリケーションはこの時間が経過するまでサムネイルの取得を再試行しません。", "schema": { "type": "integer", "format": "int64" } }, "Location": { "description": "サムネイルが生成されるまでの間使用できるプレースホルダ画像へのポインタ。", "schema": { "type": "string", "format": "url" } } } }, "302": { "description": "このファイルタイプのサムネイルをBoxで生成できない場合は、エラーを返します。\n\n代わりに、このファイルタイプのプレースホルダグラフィックを指す`Location`ヘッダーが返されます。", "headers": { "Location": { "description": "このファイルタイプに使用できるプレースホルダグラフィックへのポインタ。", "schema": { "type": "string", "format": "url" } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `requested_preview_unavailable` - 正しくないサイズがリクエストされました。これは、リクエストされたサイズが、サムネイル形式で使用可能なファイルサイズよりも大きいか小さい場合に、またはサイズの制約どうしが矛盾している場合に発生します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、ユーザーがファイルにアクセスできない場合、またはその他の理由でファイルを使用できない場合に返されます。\n\n* `preview_cannot_be_generated` - Boxはこのファイルタイプのサムネイルをサポートしていません", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/collaborations": { "get": { "operationId": "get_files_id_collaborations", "summary": "ファイルのコラボレーションのリストを取得", "description": "ファイルでの保留中のコラボレーションとアクティブなコラボレーションのリストを取得します。そのファイルに対するアクセス権限を持つか、そのファイルに招待されているすべてのユーザーを返します。", "tags": [ "コラボレーション (リスト)" ], "x-box-tag": "list_collaborations", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } } ], "responses": { "200": { "description": "コラボレーションオブジェクトのコレクションを返します。このファイルでのコラボレーションが存在しない場合は、空のコレクションが返されます。\n\nこのリストには、`status`が`pending`に設定されている保留中のコラボレーションが含まれます。これは、招待が送信されたもののまだ承認されていないことを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaborations" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/comments": { "get": { "operationId": "get_files_id_comments", "summary": "ファイルのコメントのリストを取得", "description": "ファイルに関するコメントのリストを取得します。", "tags": [ "Comments" ], "x-box-tag": "comments", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "コメントオブジェクトのコレクションを返します。このファイルに関するコメントが存在しない場合は、空のコレクションが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Comments" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/tasks": { "get": { "operationId": "get_files_id_tasks", "summary": "ファイルに対するタスクのリストを取得", "description": "そのファイルに関連するすべてのタスクのリストを取得します。このエンドポイントはページ割りをサポートしていません。", "tags": [ "Tasks" ], "x-box-tag": "tasks", "x-box-sanitized": true, "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルに関連するタスクのリストを返します。\n\nこのファイルに関連するタスクが存在しない場合は、空のコレクションが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Tasks" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が指定されていない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "IDが`0`のファイルのタスクを取得しようとした場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/trash": { "get": { "operationId": "get_files_id_trash", "summary": "ごみ箱内のファイルを取得", "tags": [ "ごみ箱内のファイル" ], "x-box-tag": "trashed_files", "description": "ごみ箱に移動されたファイルを取得します。\n\nそのファイル自体がごみ箱に移動されている場合のみ、このAPIコールを使用して取得できることに注意してください。そうではなく、その親フォルダのいずれかがごみ箱に移動された場合、[`GET /folders/:id/trash`](e://get_folders_id_trash) APIを使用して調べることができるのは、そのフォルダのみです。\n\nごみ箱に移動されたすべての項目のリストを取得するには、[`GET /folders/trash/items`](e://get-folders-trash-items/) APIを使用します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "ごみ箱に移動された日時の情報を含め、ごみ箱内にあるファイルを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrashFile" } } } }, "404": { "description": "ファイルがごみ箱で直接見つからない場合にエラーを返します。\n\nそのファイルの親フォルダのいずれかがごみ箱に移動されている場合も、`HTTP 404`が返されることに注意してください。\n\nその場合、[`GET /folders/:id/trash`](e://get_folders_id_trash) APIを使用して調べることができるのは、その親フォルダのみです。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id_trash", "summary": "ファイルを完全に削除", "tags": [ "ごみ箱内のファイル" ], "x-box-tag": "trashed_files", "description": "ごみ箱内にあるファイルを完全に削除します。このアクションは取り消せません。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ファイルが完全に削除された場合は、空のレスポンスを返します。" }, "404": { "description": "ファイルがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/versions": { "get": { "operationId": "get_files_id_versions", "summary": "すべてのファイルバージョンのリストを取得", "tags": [ "ファイルバージョン" ], "x-box-tag": "file_versions", "description": "ファイルの過去のバージョンのリストを取得します。\n\nバージョンを追跡するのは、プレミアム (有償) アカウントを持つBoxユーザーのみです。ファイルの現在のバージョンのIDを取得するには、`GET /file/:id` APIを使用します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "このファイルの過去のバージョンの配列を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersions" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/versions/{file_version_id}": { "get": { "operationId": "get_files_id_versions_id", "summary": "ファイルバージョンを取得", "tags": [ "ファイルバージョン" ], "x-box-tag": "file_versions", "description": "特定のファイルバージョンを取得します。\n\nバージョンが追跡されるのは、プレミアムアカウントを持つBoxユーザーのファイルに関してのみです。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "file_version_id", "description": "ファイルバージョンのID", "in": "path", "required": true, "example": "1234", "schema": { "type": "string" } } ], "responses": { "200": { "description": "特定のファイルバージョンを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersion--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id_versions_id", "summary": "ファイルバージョンを削除", "tags": [ "ファイルバージョン" ], "x-box-tag": "file_versions", "description": "特定のファイルバージョンをごみ箱に移動します。\n\nバージョンが追跡されるのは、プレミアムアカウントを持つBoxユーザーのファイルに関してのみです。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_version_id", "description": "ファイルバージョンのID", "in": "path", "required": true, "example": "1234", "schema": { "type": "string" } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } } ], "responses": { "204": { "description": "ファイルが正常に削除された場合は、空のレスポンスを返します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_id_versions_id", "summary": "ファイルバージョンを復元", "tags": [ "ファイルバージョン" ], "x-box-tag": "file_versions", "description": "削除された、ファイルの特定のバージョンを復元します。このエンドポイントは、PDF、DOC、PPTXなどのファイル形式で機能するため、Box Notesの復元には使用しないでください。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_version_id", "description": "ファイルバージョンのID", "in": "path", "required": true, "example": "1234", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "description": "復元するファイルバージョン", "properties": { "trashed_at": { "type": "string", "description": "これを`null`に設定すると、日付がクリアされ、ファイルが復元されます。", "example": "null" } } } } } }, "responses": { "200": { "description": "復元されたファイルバージョンオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersion--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/versions/current": { "post": { "operationId": "post_files_id_versions_current", "summary": "ファイルバージョンを昇格", "tags": [ "ファイルバージョン" ], "x-box-tag": "file_versions", "description": "特定のファイルバージョンを昇格させます。\n\n以前のバージョンが存在する場合は、この方法を使用して古いバージョンのいずれかをバージョン履歴の先頭に移動できます。\n\nこれにより、古いバージョンの新しいコピーが作成されて、バージョン履歴の先頭に配置されます。このファイルは古いバージョンとまったく同じ内容になり、ハッシュダイジェスト、`etag`、およびファイル名も同じになります。\n\nコメントなど、他のプロパティが以前の値に更新されることはありません。\n\nこのエンドポイントは、PDF、DOC、PPTXなどのファイル形式で機能するため、Box Notesの復元には使用しないでください。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "description": "昇格させるファイルバージョン", "properties": { "id": { "type": "string", "description": "ファイルバージョンID", "example": "11446498" }, "type": { "type": "string", "description": "昇格させるタイプ", "example": "file_version", "enum": [ "file_version" ] } } } } } }, "responses": { "201": { "description": "新しく作成されたファイルバージョンオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersion--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/metadata": { "get": { "operationId": "get_files_id_metadata", "summary": "ファイルのメタデータインスタンスのリストを取得", "tags": [ "メタデータインスタンス (ファイル)" ], "x-box-tag": "file_metadata", "x-box-sanitized": true, "description": "指定したファイルのすべてのメタデータを取得します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルに関連付けられたすべてのメタデータを返します。\n\nこのAPIはページ割りをサポートしていないため、常にファイルに関連付けられたすべてのメタデータを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadatas" } } } }, "403": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ユーザーがファイルにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/metadata/enterprise/securityClassification-6VMVochwUWo": { "get": { "operationId": "get_files_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "ファイルの分類を取得", "tags": [ "ファイルの分類" ], "x-box-tag": "file_classifications", "x-box-sanitized": true, "description": "ファイルに適用されている分類メタデータインスタンスを取得します。\n\nこのAPIは、`/files/:id//enterprise_12345/securityClassification-6VMVochwUWo`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "`securityClassification`メタデータテンプレートのインスタンスを返します。これには、この会社が使用できるすべての分類のリストを取得する`Box__Security__Classification__Key`フィールドが含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Classification" } } } }, "403": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定したメタデータテンプレートがこのファイルに適用されていない場合、またはユーザーがこのファイルにアクセスできない場合に返されます。\n\n* `instance_not_found` - メタデータテンプレートがファイルに適用されていなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_files_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "ファイルに分類を追加", "tags": [ "ファイルの分類" ], "x-box-tag": "file_classifications", "x-box-sanitized": true, "description": "追加する分類のラベルを指定することで、ファイルに分類を追加します。\n\nこのAPIは、`/files/:id//enterprise_12345/securityClassification-6VMVochwUWo`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "Box__Security__Classification__Key": { "type": "string", "description": "このファイルに適用する分類の名前。\n\n会社で使用できる分類のリストを取得するには、分類APIを使用して、使用可能なすべての分類キーが表示される[分類テンプレート](e://get_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema)を取得します。", "example": "Sensitive" } } } } } }, "responses": { "201": { "description": "ファイルに適用された分類テンプレートインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Classification" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。\n\n* `not_found` - ファイルが見つからないか、ユーザーがファイルにアクセスできない場合に返されます。\n* `instance_tuple_not_found` - メタデータテンプレートが見つかりませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "このメタデータテンプレートのインスタンスがすでにファイルに存在する場合はエラーを返します。\n\n* `tuple_already_exists` - メタデータテンプレートのインスタンスがすでにファイルに存在する場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "ファイルの分類を更新", "tags": [ "ファイルの分類" ], "x-box-tag": "file_classifications", "x-box-sanitized": true, "description": "ファイルの分類を更新します。\n\n分類を更新できるのは、分類がすでにファイルに適用されている場合のみです。分類を編集する際は、会社に対して定義されている値のみを使用できます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json-patch+json": { "schema": { "required": [ "items" ], "description": "分類ラベルを更新するために加える1つの変更を含むリスト。", "type": "array", "items": { "type": "object", "description": "分類メタデータテンプレートのインスタンスに対して実行する操作。この場合、`Box__Security__Classification__Key`フィールドに格納された値を新しい値で置き換えるために使用されます。", "required": [ "op", "path", "value" ], "properties": { "op": { "type": "string", "example": "replace", "description": "`replace`", "enum": [ "replace" ] }, "path": { "type": "string", "example": "/Box__Security__Classification__Key", "description": "企業で使用できる分類を定義します。", "enum": [ "/Box__Security__Classification__Key" ] }, "value": { "type": "string", "description": "このファイルに適用する分類の名前。\n\n会社で使用できる分類のリストを取得するには、分類APIを使用して、使用可能なすべての分類キーが表示される[分類テンプレート](e://get_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema)を取得します。", "example": "Sensitive" } } } } } } }, "responses": { "200": { "description": "更新された分類メタデータテンプレートインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Classification" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `bad_request` - リクエスト本文の形式が有効なJSON Patch操作の配列ではありません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "リクエスト本文が有効なJSON Patch項目の配列でない場合、一部のエッジケースでエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "ファイルから分類を削除", "tags": [ "ファイルの分類" ], "x-box-tag": "file_classifications", "x-box-sanitized": true, "description": "ファイルからすべての分類を削除します。\n\nこのAPIは、`/files/:id//enterprise_12345/securityClassification-6VMVochwUWo`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "分類が正常に削除された場合は空のレスポンスを返します。" }, "400": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルに分類が適用されていない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - 分類メタデータテンプレートのインスタンスがこのファイルに見つかりませんでした。\n* `not_found` - ファイルが見つからなかったか、ユーザーがファイルにアクセスできません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/metadata/{scope}/{template_key}": { "get": { "operationId": "get_files_id_metadata_id_id", "summary": "ファイルのメタデータインスタンスを取得", "tags": [ "メタデータインスタンス (ファイル)" ], "x-box-tag": "file_metadata", "x-box-sanitized": true, "description": "ファイルに適用されたメタデータテンプレートのインスタンスを取得します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "ユーザーまたはアプリケーションによって定義された追加の「キー/値」ペアを含むメタデータテンプレートのインスタンス。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadata--Full" } } } }, "403": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定したメタデータテンプレートがこのファイルに適用されていない場合、またはユーザーがこのファイルにアクセスできない場合に返されます。\n\n* `instance_not_found` - メタデータテンプレートがファイルに適用されていなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_files_id_metadata_id_id", "summary": "ファイルにメタデータインスタンスを作成", "tags": [ "メタデータインスタンス (ファイル)" ], "x-box-tag": "file_metadata", "x-box-sanitized": true, "description": "メタデータテンプレートのインスタンスをファイルに適用します。\n\nほとんどの場合、メタデータテンプレートに存在する値のみを使用できます。ただし、任意のキー/値ペアを使用できる`global.properties`テンプレートは除きます。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "example": { "name": "Aaron Levie" }, "additionalProperties": { "allOf": [ {}, { "example": "Aaron Levie" }, { "description": "メタデータテンプレートに存在する各フィールドの値。`global.properties`テンプレートの場合、汎用的なキー/値ペアをテンプレートに保存できるため、0個以上のフィールドのリストにすることができます。" } ] }, "x-box-example-key": "name" } } } }, "responses": { "201": { "description": "テンプレートに適用されたデータを含む、ファイルに適用されたテンプレートのインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadata--Full" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。\n\n* `not_found` - ファイルが見つからないか、ユーザーがファイルにアクセスできない場合に返されます。\n* `instance_tuple_not_found` - メタデータテンプレートが見つかりませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "このメタデータテンプレートのインスタンスがすでにファイルに存在する場合はエラーを返します。\n\n* `tuple_already_exists` - メタデータテンプレートのインスタンスがすでにファイルに存在する場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_id_metadata_id_id", "summary": "ファイルのメタデータインスタンスを更新", "tags": [ "メタデータインスタンス (ファイル)" ], "x-box-tag": "file_metadata", "x-box-sanitized": true, "description": "ファイルのメタデータを更新します。\n\nメタデータインスタンスを更新できるのは、テンプレートがすでにファイルに適用されている場合のみです。メタデータを編集する際には、メタデータテンプレートのスキーマに一致した値のみを使用できます。\n\n更新はアトミックに適用されます。操作の適用中にエラーが発生した場合、メタデータインスタンスは変更されません。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json-patch+json": { "schema": { "description": "メタデータインスタンスに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)の指定。\n\n変更は操作オブジェクトのJSON配列として表されます。", "type": "array", "items": { "title": "メタデータインスタンスの更新操作", "description": "メタデータインスタンスに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)操作。", "type": "object", "properties": { "op": { "type": "string", "example": "add", "enum": [ "add", "replace", "remove", "test", "move", "copy" ], "description": "テンプレートに対して実行する変更のタイプ。その中には、既存のテンプレートを変更する際に危険を伴うものもあります。" }, "path": { "type": "string", "example": "/currentState", "description": "変更を適用するメタデータJSONオブジェクト内の場所を、[JSON-Pointer](https://tools.ietf.org/html/rfc6901)の形式で指定します。\n\nパスの先頭にはテンプレートのルートを表す`/`を必ず付ける必要があります。文字`~`と`/`は予約文字であるため、キー内ではエスケープする必要があります。" }, "value": { "type": "string", "example": "reviewed", "description": "設定またはテストする値。\n\n`add`、`replace`、`test`操作では必須です。`add`の場合、値がすでに存在するときは、古い値が新しい値で上書きされます。`replace`の場合、置換の前に値がすでに存在している必要があります。\n\n`test`の場合、`path`の位置にある既存の値が指定した値と一致している必要があります。" }, "from": { "type": "string", "example": "/nextState", "description": "値の移動元またはコピー元であるメタデータJSONオブジェクト内の場所。`move`または`copy`操作には必須であり、[JSON-Pointer](https://tools.ietf.org/html/rfc6901)の形式である必要があります。" } } } } } } }, "responses": { "200": { "description": "カスタムテンプレートデータを含め、更新されたメタデータテンプレートインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadata--Full" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `bad_request` - リクエスト本文の形式が有効なJSON Patchオブジェクトの配列ではありません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "リクエスト本文が有効なJSON Patch項目の配列でない場合、一部のエッジケースでエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id_metadata_id_id", "summary": "ファイルからメタデータインスタンスを削除", "tags": [ "メタデータインスタンス (ファイル)" ], "x-box-tag": "file_metadata", "x-box-sanitized": true, "description": "ファイルメタデータを削除します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "メタデータが正常に削除された場合は空のレスポンスを返します。" }, "400": { "description": "リクエストのパラメータが無効な場合に返されます。これは、`scope`が無効な場合に発生する可能性があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルにメタデータテンプレートのインスタンスが適用されていない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - 指定された`scope`および`templateKey`を持つメタデータテンプレートのインスタンスがこのファイルに見つかりませんでした。\n* `not_found` - ファイルが見つからなかったか、ユーザーがファイルにアクセスできません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/metadata/global/boxSkillsCards": { "get": { "operationId": "get_files_id_metadata_global_boxSkillsCards", "summary": "ファイルのBox Skillカードのリストを取得", "tags": [ "Skills" ], "x-box-tag": "skills", "description": "ファイルに添付されているBox Skillsメタデータカードのリストを取得します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルに関連付けられたすべてのメタデータを返します。\n\nこのAPIはページ割りをサポートしていないため、常にファイルに関連付けられたすべてのメタデータを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkillCardsMetadata" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_files_id_metadata_global_boxSkillsCards", "summary": "ファイルにBox Skillカードを作成", "tags": [ "Skills" ], "x-box-tag": "skills", "description": "ファイルに1つ以上のBox Skillsメタデータカードを適用します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "cards" ], "properties": { "cards": { "type": "array", "description": "このファイルに適用するBox Skillカードのリスト。", "items": { "oneOf": [ { "$ref": "#/components/schemas/KeywordSkillCard" }, { "$ref": "#/components/schemas/TimelineSkillCard" }, { "$ref": "#/components/schemas/TranscriptSkillCard" }, { "$ref": "#/components/schemas/StatusSkillCard" } ] } } } } } } }, "responses": { "201": { "description": "テンプレートに適用されたデータを含む、ファイルに適用されたテンプレートのインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkillCardsMetadata" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。\n\n* `not_found` - ファイルが見つからないか、ユーザーがファイルにアクセスできない場合に返されます。\n* `instance_tuple_not_found` - メタデータテンプレートが見つかりませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "このメタデータテンプレートのインスタンスがすでにファイルに存在する場合はエラーを返します。\n\n* `tuple_already_exists` - メタデータテンプレートのインスタンスがすでにファイルに存在する場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_id_metadata_global_boxSkillsCards", "summary": "ファイルのBox Skillカードを更新", "tags": [ "Skills" ], "x-box-tag": "skills", "description": "ファイルの1つ以上のBox Skillsメタデータカードを更新します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json-patch+json": { "schema": { "description": "メタデータテンプレートに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)の指定。\n\n変更は操作オブジェクトのJSON配列として表されます。", "type": "array", "items": { "type": "object", "description": "既存のカードを置き換える操作。", "properties": { "op": { "type": "string", "description": "`replace`", "example": "replace", "enum": [ "replace" ] }, "path": { "type": "string", "description": "置き換えるカードを表すJSONパス。ほとんどの場合、これは`/cards/{index}`形式になります (`index`は、カードのリストにおいてそのカードの位置を示すゼロから始まるインデックスです)。", "example": "/cards/0" }, "value": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/KeywordSkillCard" }, { "$ref": "#/components/schemas/TimelineSkillCard" }, { "$ref": "#/components/schemas/TranscriptSkillCard" }, { "$ref": "#/components/schemas/StatusSkillCard" } ] }, { "description": "カードのリスト内の`path`で定義された位置に挿入されるカード。" } ] } } } } } } }, "responses": { "200": { "description": "カスタムテンプレートデータを含め、更新されたメタデータテンプレートを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkillCardsMetadata" } } } }, "404": { "description": "リクエストしたファイルが見つかりませんでした", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id_metadata_global_boxSkillsCards", "summary": "ファイルからBox Skillカードを削除", "tags": [ "Skills" ], "x-box-tag": "skills", "x-box-sanitized": true, "description": "ファイルからBox Skillsカードのメタデータを削除します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "カードが正常に削除された場合は空のレスポンスを返します。" }, "404": { "description": "ファイルにBox Skillカードのインスタンスが適用されていない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - Box Skillカードのメタデータテンプレートのインスタンスがこのファイルに見つかりませんでした。\n* `not_found` - ファイルが見つからなかったか、ユーザーがファイルにアクセスできません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}/watermark": { "get": { "operationId": "get_files_id_watermark", "summary": "ファイルの電子すかしを取得", "tags": [ "電子すかし (ファイル)" ], "x-box-tag": "file_watermarks", "description": "ファイルの電子すかしを取得します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "このファイルに関連付けられている電子すかしに関する情報を含むオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watermark" } } } }, "404": { "description": "ファイルに電子すかしが適用されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_files_id_watermark", "summary": "ファイルに電子すかしを適用", "tags": [ "電子すかし (ファイル)" ], "x-box-tag": "file_watermarks", "description": "ファイルの電子すかしを適用または更新します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "watermark" ], "properties": { "watermark": { "type": "object", "description": "ファイルに適用する電子すかし", "required": [ "imprint" ], "properties": { "imprint": { "type": "string", "example": "default", "description": "適用する電子すかしのタイプ。\n\n現在サポートされているオプションは1つのみです。", "enum": [ "default" ] } } } } } } } }, "responses": { "200": { "description": "このファイルに電子すかしがすでに適用されている場合は、更新された電子すかしを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watermark" } } } }, "201": { "description": "このファイルにまだ電子すかしが適用されていない場合は、新しい電子すかしを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watermark" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_files_id_watermark", "summary": "ファイルから電子すかしを削除", "tags": [ "電子すかし (ファイル)" ], "x-box-tag": "file_watermarks", "description": "ファイルから電子すかしを削除します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "電子すかしを削除して空のレスポンスを返します。" }, "404": { "description": "ファイルに電子すかしが適用されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/file_requests/{file_request_id}": { "get": { "operationId": "get_file_requests_id", "summary": "ファイルリクエストを取得", "tags": [ "ファイルリクエスト" ], "x-box-tag": "file_requests", "x-box-enable-explorer": true, "description": "ファイルリクエストに関する情報を取得します。", "parameters": [ { "name": "file_request_id", "description": "ファイルリクエストを表す一意の識別子。\n\nファイルリクエストのIDを確認するには、ウェブアプリケーションでファイルリクエストの作成画面にアクセスして、そのURLからIDをコピーします。たとえば、URLが`https://*.app.box.com/filerequest/123`の場合、`file_request_id`は`123`です。", "example": "123", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルリクエストオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileRequest" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルリクエストが見つからない場合、または関連付けられたフォルダへのアクセス権限がユーザーに与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_request_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_file_requests_id", "summary": "ファイルリクエストを更新", "tags": [ "ファイルリクエスト" ], "x-box-tag": "file_requests", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ファイルリクエストを更新します。これは使用すると、ファイルリクエストを有効化または無効化できます。", "parameters": [ { "name": "file_request_id", "description": "ファイルリクエストを表す一意の識別子。\n\nファイルリクエストのIDを確認するには、ウェブアプリケーションでファイルリクエストの作成画面にアクセスして、そのURLからIDをコピーします。たとえば、URLが`https://*.app.box.com/filerequest/123`の場合、`file_request_id`は`123`です。", "example": "123", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileRequestUpdateRequest" } } } }, "responses": { "200": { "description": "更新されたファイルリクエストオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileRequest" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。\n\n* `access_denied_insufficient_permissions` - 認証済みユーザーにファイルリクエストを更新するためのアクセス権限がない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルリクエストが見つからない場合、または関連付けられたフォルダへのアクセス権限がユーザーに与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_request_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルリクエストの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルリクエストが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_file_requests_id", "summary": "ファイルリクエストを削除", "tags": [ "ファイルリクエスト" ], "x-box-tag": "file_requests", "x-box-sanitized": true, "description": "ファイルリクエストを完全に削除します。", "parameters": [ { "name": "file_request_id", "description": "ファイルリクエストを表す一意の識別子。\n\nファイルリクエストのIDを確認するには、ウェブアプリケーションでファイルリクエストの作成画面にアクセスして、そのURLからIDをコピーします。たとえば、URLが`https://*.app.box.com/filerequest/123`の場合、`file_request_id`は`123`です。", "example": "123", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ファイルリクエストが正常に削除された場合は、空のレスポンスを返します。" }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルリクエストが見つからないかすでに削除されている場合、またはユーザーに関連付けられたフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_request_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/file_requests/{file_request_id}/copy": { "post": { "operationId": "post_file_requests_id_copy", "summary": "ファイルリクエストをコピー", "tags": [ "ファイルリクエスト" ], "x-box-tag": "file_requests", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "あるフォルダにすでに存在する既存のファイルリクエストをコピーし、別のフォルダに適用します。", "parameters": [ { "name": "file_request_id", "description": "ファイルリクエストを表す一意の識別子。\n\nファイルリクエストのIDを確認するには、ウェブアプリケーションでファイルリクエストの作成画面にアクセスして、そのURLからIDをコピーします。たとえば、URLが`https://*.app.box.com/filerequest/123`の場合、`file_request_id`は`123`です。", "example": "123", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileRequestCopyRequest" } } } }, "responses": { "200": { "description": "更新されたファイルリクエストオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileRequest" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。\n\n* `access_denied_insufficient_permissions` - 認証済みユーザーにファイルリクエストを更新するためのアクセス権限がない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルリクエストが見つからない場合、または関連付けられたフォルダへのアクセス権限がユーザーに与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_request_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}": { "get": { "operationId": "get_folders_id", "summary": "フォルダ情報を取得", "tags": [ "Folders" ], "x-box-tag": "folders", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "フォルダ内の最初の100エントリを含むフォルダの詳細を取得します。\n\nクエリで`sort`、`direction`、`offset`、および`limit`パラメータを渡すと、返される[フォルダ項目](r://folder--full#param-item-collection)のリストを管理できます。\n\nフォルダ内の項目をさらに取得するには、[フォルダ内の項目を取得](e://get-folders-id-items)エンドポイントを使用します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。\n\nまた、このフィールドを使用すると、ファイルに適用されている任意のメタデータに対してクエリを実行できます。その際、`metadata`フィールドのほか、取得するテンプレートのスコープとキー (例: `?fields=metadata.enterprise_12345.contractTemplate`) も指定します。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "if-none-match", "description": "項目が変更されている場合にのみ、その項目を返します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは`304 Not Modified`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "boxapi", "description": "この項目の共有リンクのURLと省略可能なパスワード。\n\nこのヘッダーを使用すると、ユーザーと明示的に共有されていない項目にアクセスできます。\n\n`shared_link=[link]`形式を使用するか、パスワードが必要な場合は`shared_link=[link]&shared_link_password=[password]`を使用します。\n\nこのヘッダーは、共有されているファイルまたはフォルダのほか、その項目内にネストされているすべてのファイルやフォルダで使用できます。", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "sort", "description": "項目並べ替えの**2番目**の基準として使用される属性を定義します。\n\nフォルダの種類は、項目の並べ替え方法に影響します。\n\n* **標準フォルダ**: 項目は必ず最初に`type`を基準にして並べ替えられ、フォルダはファイルよりも前に、ファイルはウェブリンクよりも前にリストされます。\n\n* **ルートフォルダ**: ルートフォルダ \n\n (`id`が`0`のフォルダ) の場合、マーカーベースのページ割りでこのパラメータはサポートされません。\n\n* **関連付けられたフォルダの親パスがコラボレータに表示される共有フォルダ**: 項目は必ず最初に`type`を基準にして並べ替えられ、フォルダはファイルよりも前に、ファイルはウェブリンクよりも前にリストされます。", "in": "query", "required": false, "example": "id", "schema": { "type": "string", "enum": [ "id", "name", "date", "size" ] } }, { "name": "direction", "description": "結果を並べ替える方向。アルファベットの昇順 (`ASC`) または降順 (`DESC`) のいずれかを指定できます。", "in": "query", "required": false, "example": "ASC", "schema": { "type": "string", "enum": [ "ASC", "DESC" ] } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "フォルダ内の最初の100エントリを含め、フォルダを返します。`sort`、`direction`、`offset`、`limit`のようなクエリパラメータを使用した場合、_フォルダ項目のリスト_は状況に応じて影響を受けます。\n\nフォルダ内の項目をさらに取得するには、[フォルダ内の項目を取得](e://get-folders-id-items)エンドポイントを使用します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" } } } }, "304": { "description": "`If-None-Match`ヘッダーがフォルダの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、フォルダが前回リクエストされたときから変更されていないことを示します。" }, "403": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_folders_id", "summary": "フォルダを復元", "tags": [ "ごみ箱内のフォルダ" ], "x-box-tag": "trashed_folders", "description": "ごみ箱に移動されたフォルダを復元します。\n\n元のフォルダが削除されている場合にフォルダの復元先となる新しい親ID (省略可) を指定することができます。\n\n# フォルダのロック\n\nこの操作の進行中は、ファイルツリーの一部がロックされます。ロックされるのは主に元のフォルダとその子孫フォルダ、および宛先フォルダです。\n\n操作の進行中は、ロックされたどのフォルダに対しても、その他の移動、コピー、削除または復元操作を実行できません。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "description": "フォルダの新しい名前 (省略可)。", "example": "Restored Photos", "type": "string" }, "parent": { "allOf": [ { "type": "object", "description": "この項目の親", "properties": { "id": { "type": "string", "description": "親項目のID", "example": "123" } } }, { "description": "元のフォルダがすでに存在しない場合にフォルダの復元先となるフォルダのID (省略可) を指定します。\n\nこのIDは、元のフォルダがすでに存在しない場合にのみ使用されることに注意してください。このIDは、元の場所が削除されている場合にフォルダの復元先となるフォールバックの場所を指定します。" } ] } } } } } }, "responses": { "201": { "description": "フォルダが復元されたときにフォルダオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrashFolderRestored" } } } }, "403": { "description": "フォルダの復元先フォルダに対してユーザーがアクセス権限を持っていない場合、またはごみ箱からフォルダを復元する権限を持っていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "* 宛先フォルダに同じ名前のフォルダがある場合はエラーを返します。\n\n* `operation_blocked_temporary`: 別の移動、コピー、削除、または復元操作が進行中であるために宛先フォルダまたは元のフォルダがロックされている場合に返されます。\n\n 操作は後で再試行することができます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_folders_id", "summary": "フォルダを更新", "description": "フォルダを更新します。フォルダの移動、共有リンクの作成、コラボレーションの更新といった目的にも使用できます。", "tags": [ "Folders" ], "x-box-tag": "folders", "x-box-sanitized": true, "x-box-enable-explorer": true, "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "このフォルダの新しい名前 (省略可)。", "example": "New Folder" }, "description": { "type": "string", "description": "このフォルダの説明 (省略可)", "maxLength": 256, "example": "Legal contracts for the new ACME deal", "nullable": false }, "sync_state": { "type": "string", "example": "synced", "nullable": false, "description": "フォルダをユーザーのデバイスに同期する必要があるかどうかを指定します。これはBox Sync (廃止済み) で使用され、Box Driveでは 使用されません。", "enum": [ "synced", "not_synced", "partially_synced" ] }, "can_non_owners_invite": { "type": "boolean", "example": true, "description": "フォルダの所有者ではないユーザーがそのフォルダに新しいコラボレータを招待できるかどうかを指定します。" }, "parent": { "type": "object", "description": "このフォルダの親フォルダ。フォルダを移動したり、ごみ箱からフォルダを復元したりするときに使用します。", "properties": { "id": { "type": "string", "description": "新しい親フォルダのID", "example": "0" } } }, "shared_link": { "allOf": [ { "description": "項目の共有リンクを定義します。これを`null`に設定すると、共有リンクが削除されます。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" } } } } }, { "description": "フォルダの共有リンクの作成を有効にします。" } ] }, "folder_upload_email": { "allOf": [ { "title": "フォルダアップロードメール", "type": "object", "description": "書き込みフォルダアップロードメールオブジェクト", "properties": { "access": { "type": "string", "example": "open", "nullable": false, "enum": [ "open", "collaborators" ], "description": "このパラメータが設定されている場合、ユーザーは、このフォルダに対して自動的に作成されたメールアドレスに メールでファイルを送信できます。\n\nメールアドレスを作成するには、フォルダを作成するとき、または更新するときにこのプロパティを設定します。\n\n`collaborators`に設定すると、コラボレータの登録済み メールアドレスからのメールのみが受け入れられます。これには、ユーザーが登録しているすべてのメールエイリアスも含まれます。\n\n`open`に設定すると、どのメールアドレスからのメールでも受け入れられます。" } } }, { "description": "このオブジェクトを設定するとアップロードメールアドレスが有効になります。\n\nユーザーはこのメールアドレスを使用することにより、メールを介してフォルダにファイルを直接アップロードできます。\n\n値を`null`に設定するとアップロードメールアドレスは無効になります。" } ] }, "tags": { "type": "array", "example": [ "approved" ], "items": { "type": "string" }, "minItems": 1, "maxItems": 100, "description": "この項目のタグ。これらのタグはBoxウェブアプリおよびモバイルアプリで項目の横に表示されます。\n\nタグを追加または削除するには、項目の現在のタグを取得して変更してから、このフィールドを更新します。\n\nタグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに制限されます。" }, "is_collaboration_restricted_to_enterprise": { "type": "boolean", "example": true, "description": "このフォルダへの招待を社内のユーザーのみに限定するかどうかを指定します。既存のコラボレーションには影響しません。" }, "collections": { "type": "array", "description": "このフォルダをメンバーとして追加するコレクションの配列。現時点では、`favorites`コレクションのみがサポートされています。\n\nコレクションのIDを取得するには、[すべてのコレクションのリストを取得][1]エンドポイントを使用します。\n\n空の配列`[]`または`null`を渡すと、すべてのコレクションからこのフォルダが削除されます。\n\n[1]: e://get-collections", "items": { "title": "Reference", "description": "オブジェクトの最も基本的な参照", "type": "object", "properties": { "id": { "type": "string", "description": "このオブジェクトの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "このオブジェクトのタイプ", "example": "file" } } } }, "can_non_owners_view_collaborators": { "type": "boolean", "example": true, "description": "このフォルダの所有者ではないコラボレータがこのフォルダのその他のコラボレータを表示できないように制限します。\n\nこの制限を有効にした場合は、所有者ではないユーザーが新しいコラボレータを招待することも制限されます。\n\nこのフィールドを`false`に設定する場合は、`can_non_owners_invite_collaborators`も`false`に設定する必要があります (まだ設定されていない場合)。" } } } } } }, "responses": { "200": { "description": "更新されたフォルダのフォルダオブジェクトを返します\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。\n\nこの呼び出しは同期的に復帰します。これは、すべての子孫に大量の項目が含まれているフォルダを移動する場合にも当てはまります。つまり、非常に大きいフォルダの場合は、この呼び出しが復帰するまでに数分または数時間かかる場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" } } } }, "400": { "description": "一部のパラメータが指定されていないか無効な場合、またはフォルダロックにより移動操作ができなくなっている場合はエラーを返します。\n\n* `bad_request` - パラメータが指定されていないか誤っている場合に返されます。このエラーは、アクセスタイプが`open`の共有リンクにパスワードが設定されている場合にも発生します。\n* `item_name_too_long` - フォルダ名が長すぎる場合に返されます。\n* `item_name_invalid` - フォルダ名に無効な文字が含まれている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーにこのアクションを実行するためのアクセス権限がない場合はエラーを返します。\n\n* `access_denied_insufficient_permissions`: ユーザーにフォルダまたは親フォルダへのアクセス権限がない場合か、移動できないようにフォルダロックが適用されているのにフォルダが移動されている場合に返されます。\n\n* `insufficient_scope`: アプリケーションにフォルダを更新するための適切なスコープがない場合に返されます。Boxに格納されているすべてのファイルとフォルダに対して読み取りと書き込みを行えるようにアプリケーションが設定されていることを確認してください。\n\n* `forbidden`: ユーザーが他のユーザーに対してこのアクションを実行することが許可されていない場合に返されます。これには、アクセスレベルが`company`に設定されている共有リンクを無料アカウントで作成するアクションも含まれます。\n\n* `forbidden_by_policy`: 情報バリアの制限によりフォルダのコピーが禁止されている場合に返されます。\n\nリクエスト本文に含まれる操作が多すぎる場合にエラーを返します。\n\n* `operation_limit_exceeded`: ユーザーがリクエスト本文で`parent.id`に加えてパラメータを渡したときに返されます。このエンドポイントに対する呼び出しは分割する必要があります。最初の呼び出しには`parent.id`だけを含める必要があります。次の呼び出しには他のパラメータを含めることができます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダまたは親フォルダが見つからないか、認証済みユーザーがどちらのフォルダにもアクセスできない場合はエラーを返します。\n\n* `not_found` - 認証済みユーザーがフォルダまたは親フォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "* `operation_blocked_temporary`: 別の移動、コピー、削除、または復元操作が進行中であるために宛先フォルダまたは元のフォルダがロックされている場合に返されます。\n\n 操作は後で再試行することができます。\n\n* `item_name_in_use`: この名前のフォルダがすでに親フォルダ内に存在している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがフォルダの現在の`etag`値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "503": { "description": "操作の処理時間が60秒を超えるとエラーを返します。このレスポンスが返された後も操作は続行されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_folders_id", "summary": "フォルダを削除", "description": "フォルダを完全に削除するか、ごみ箱に移動して削除します。", "tags": [ "Folders" ], "x-box-tag": "folders", "x-box-sanitized": true, "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "if-match", "description": "変更を加える前にこの項目が最近変更されていないことを確認します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは`412 Precondition Failed`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "recursive", "description": "フォルダとその中にあるすべてのコンテンツを再帰的に削除することにより、空でないフォルダを削除します。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean" } } ], "responses": { "204": { "description": "フォルダが正常に削除された場合、またはごみ箱に移動された場合は、空のレスポンスを返します。" }, "400": { "description": "ユーザーが不適切なリクエストを行った場合にエラーを返します。\n\n* `folder_not_empty`: フォルダが空でない場合に返されます。フォルダとそのコンテンツを再帰的に削除するには、`recursive`クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーにこのアクションを実行するためのアクセス権限がない場合はエラーを返します。\n\n* `access_denied_insufficient_permissions`: ユーザーにフォルダへのアクセス権限がない場合、または削除されないようにフォルダにフォルダロックが適用されている場合に返されます。\n\n* `insufficient_scope`: アプリケーションにフォルダを削除するための適切なスコープがない場合にエラーが返されます。Boxに格納されているすべてのファイルとフォルダに対して読み取りと書き込みを行えるようにアプリケーションが設定されていることを確認してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからないか、認証済みユーザーが親フォルダにアクセスできない場合は、エラーを返します。\n\n* `not_found` - 認証済みユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "* `operation_blocked_temporary`: 別の移動、コピー、削除、または復元操作が進行中であることによりフォルダがロックされている場合に返されます。\n\n 操作は後で再試行することができます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがフォルダの現在の`etag`値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "503": { "description": "操作の処理時間が60秒を超えるとエラーを返します。このレスポンスが返された後も操作は続行されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/items": { "get": { "operationId": "get_folders_id_items", "summary": "フォルダ内の項目のリストを取得", "tags": [ "Folders" ], "x-box-tag": "folders", "x-box-sanitized": true, "x-box-enable-explorer": true, "description": "フォルダ内の項目のページを取得します。これらの項目はファイル、 フォルダ、ウェブリンクのいずれかになります。\n\nフォルダ自体の詳細情報 (サイズなど) をリクエストするには、代わりに[フォルダを取得](#get-folders-id)エンドポイントを使用します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。\n\nまた、このフィールドを使用すると、ファイルに適用されている任意のメタデータに対してクエリを実行できます。その際、`metadata`フィールドのほか、取得するテンプレートのスコープとキー (例: `?fields=metadata.enterprise_12345.contractTemplate`) も指定します。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "usemarker", "description": "オフセットベースのページ割り方式ではなくマーカーベースのページ割り方式を使用するかどうかを指定します。同時に使用できるページ割りの方式は1つのみです。\n\nこの値をtrueに設定すると、APIは、レスポンスの次のページを取得するために、このエンドポイントにパラメータとして渡すことができる`marker`フィールドを返します。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "boxapi", "description": "この項目の共有リンクのURLと省略可能なパスワード。\n\nこのヘッダーを使用すると、ユーザーと明示的に共有されていない項目にアクセスできます。\n\n`shared_link=[link]`形式を使用するか、パスワードが必要な場合は`shared_link=[link]&shared_link_password=[password]`を使用します。\n\nこのヘッダーは、共有されているファイルまたはフォルダのほか、その項目内にネストされているすべてのファイルやフォルダで使用できます。", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "sort", "description": "項目並べ替えの**2番目**の基準として使用される属性を定義します。\n\nフォルダの種類は、項目の並べ替え方法に影響します。\n\n* **標準フォルダ**: 項目は必ず最初に`type`を基準にして並べ替えられ、フォルダはファイルよりも前に、ファイルはウェブリンクよりも前にリストされます。\n\n* **ルートフォルダ**: ルートフォルダ \n\n (`id`が`0`のフォルダ) の場合、マーカーベースのページ割りでこのパラメータはサポートされません。\n\n* **関連付けられたフォルダの親パスがコラボレータに表示される共有フォルダ**: 項目は必ず最初に`type`を基準にして並べ替えられ、フォルダはファイルよりも前に、ファイルはウェブリンクよりも前にリストされます。", "in": "query", "required": false, "example": "id", "schema": { "type": "string", "enum": [ "id", "name", "date", "size" ] } }, { "name": "direction", "description": "結果を並べ替える方向。アルファベットの昇順 (`ASC`) または降順 (`DESC`) のいずれかを指定できます。", "in": "query", "required": false, "example": "ASC", "schema": { "type": "string", "enum": [ "ASC", "DESC" ] } } ], "responses": { "200": { "description": "フォルダに含まれるファイル、フォルダ、およびウェブリンクのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Items" } } } }, "403": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders": { "post": { "operationId": "post_folders", "summary": "フォルダを作成", "tags": [ "Folders" ], "x-box-tag": "folders", "x-box-enable-explorer": true, "description": "指定した親フォルダ内に空のフォルダを新規に作成します。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "parent" ], "properties": { "name": { "type": "string", "description": "新しいフォルダの名前。\n\nファイル名にはいくつかの制約があります。印刷不可能なASCII文字、スラッシュ、およびバックスラッシュ (`/`、`\\`) を含む名前、または末尾にスペースを含む名前は禁止されています。\n\nまた、`.`および`..`という名前も使用できません。", "example": "New Folder", "maxLength": 255, "minLength": 1 }, "parent": { "type": "object", "description": "新しいフォルダの作成先となる親フォルダ。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "親フォルダのID", "example": "0" } } }, "folder_upload_email": { "allOf": [ { "title": "フォルダアップロードメール", "type": "object", "description": "書き込みフォルダアップロードメールオブジェクト", "properties": { "access": { "type": "string", "example": "open", "nullable": false, "enum": [ "open", "collaborators" ], "description": "このパラメータが設定されている場合、ユーザーは、このフォルダに対して自動的に作成されたメールアドレスに メールでファイルを送信できます。\n\nメールアドレスを作成するには、フォルダを作成するとき、または更新するときにこのプロパティを設定します。\n\n`collaborators`に設定すると、コラボレータの登録済み メールアドレスからのメールのみが受け入れられます。これには、ユーザーが登録しているすべてのメールエイリアスも含まれます。\n\n`open`に設定すると、どのメールアドレスからのメールでも受け入れられます。" } } }, { "description": "このオブジェクトを設定するとアップロードメールアドレスが有効になります。\n\nユーザーはこのメールアドレスを使用することにより、メールを介してフォルダにファイルを直接アップロードできます。" } ] }, "sync_state": { "type": "string", "example": "synced", "nullable": false, "description": "フォルダをユーザーのデバイスに同期する必要があるかどうかを指定します。これはBox Sync (廃止済み) で使用され、Box Driveでは 使用されません。", "enum": [ "synced", "not_synced", "partially_synced" ] } } } } } }, "responses": { "201": { "description": "フォルダオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `bad_request` - パラメータが指定されていないか誤っている場合に返されます。\n* `item_name_too_long` - フォルダ名が長すぎる場合に返されます。\n* `item_name_invalid` - フォルダ名に無効な文字が含まれている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーにこのアクションを実行するためのアクセス権限がない場合にエラーは返します。これは、ユーザーにフォルダまたは親フォルダへのアクセス権限がないか、アプリケーションにファイルおよびフォルダへの書き込み権限がないことが原因となっている可能性があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "親フォルダが見つからないか、認証済みユーザーが親フォルダにアクセスできない場合はエラーを返します。\n\n* `not_found` - 認証済みユーザーが親フォルダにアクセスできない場合に返されます", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "* `operation_blocked_temporary`: 別の移動、コピー、削除、または復元操作が進行中であるために宛先フォルダまたは元のフォルダがロックされている場合に返されます。\n\n 操作は後で再試行することができます。\n\n* `item_name_in_use`: この名前のフォルダがすでに親フォルダ内に存在している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/copy": { "post": { "operationId": "post_folders_id_copy", "summary": "フォルダをコピー", "x-box-enable-explorer": true, "x-box-tag": "folders", "description": "フォルダのコピーを宛先フォルダ内に作成します。\n\n元のフォルダは変更されません。", "tags": [ "Folders" ], "parameters": [ { "name": "folder_id", "description": "コピーするフォルダの一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nIDが`0`のルートフォルダはコピーできません。", "example": "0", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "parent" ], "nullable": false, "properties": { "name": { "type": "string", "description": "コピーされたフォルダの新しい名前 (省略可)。\n\nファイル名にはいくつかの制約があります。印刷不可能なASCII文字、スラッシュ、およびバックスラッシュ (`/`、`\\`) を含む名前、または末尾にスペースを含む名前は禁止されています。\n\nまた、`.`および`..`という名前も使用できません。", "example": "New Folder", "maxLength": 255, "minLength": 1 }, "parent": { "type": "object", "description": "フォルダのコピー先となる宛先フォルダ。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "親フォルダのID", "example": "0" } } } } } } } }, "responses": { "201": { "description": "コピーされたフォルダを表す新しいフォルダオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" } } } }, "304": { "description": "`If-None-Match`ヘッダーがフォルダの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、フォルダが前回リクエストされたときから変更されていないことを示します。" }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `bad_request` - パラメータが指定されていない場合に返されます。\n* `item_name_too_long` - 新しいフォルダ名が長すぎる場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーにフォルダをコピーするための適切な権限がない場合にエラーを返します。\n\n* `forbidden_by_policy`: 情報バリアの制限によりフォルダのコピーが禁止されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "元のフォルダまたは宛先フォルダのどちらも見つからないか、認証済みユーザーがどちらのフォルダにもアクセスできない場合はエラーを返します。\n\n* `not_found` - 認証済みユーザーが親フォルダにアクセスできない場合に返されます", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "宛先フォルダにこの名前のフォルダがすでに存在している場合、または宛先フォルダがロックされている場合はエラーを返します\n\n* `item_name_in_use` - 同じ名前のフォルダがすでに存在している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "ルートフォルダをコピーしようとした場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/collaborations": { "get": { "operationId": "get_folders_id_collaborations", "summary": "フォルダコラボレーションのリストを取得", "description": "フォルダでの保留中のコラボレーションとアクティブなコラボレーションのリストを取得します。そのフォルダに対するアクセス権限を持つか、そのフォルダに招待されているすべてのユーザーを返します。", "tags": [ "コラボレーション (リスト)" ], "x-box-tag": "list_collaborations", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "コラボレーションオブジェクトのコレクションを返します。このフォルダでのコラボレーションが存在しない場合は、空のコレクションが返されます。\n\nこのリストには、`status`が`pending`に設定されている保留中のコラボレーションが含まれます。これは、招待が送信されたもののまだ承認されていないことを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaborations" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/trash": { "get": { "operationId": "get_folders_id_trash", "summary": "ごみ箱内のフォルダを取得", "tags": [ "ごみ箱内のフォルダ" ], "x-box-tag": "trashed_folders", "description": "ごみ箱に移動されたフォルダを取得します。\n\nそのフォルダ自体がごみ箱に移動されている場合のみ、このAPIコールを使用して取得できることに注意してください。そうではなく、その親フォルダのいずれかがごみ箱に移動された場合、[`GET /folders/:id/trash`](e://get_folders_id_trash) APIを使用して調べることができるのは、そのフォルダのみです。\n\nごみ箱に移動されたすべての項目のリストを取得するには、[`GET /folders/trash/items`](e://get-folders-trash-items/) APIを使用します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "ごみ箱に移動された日時の情報を含め、ごみ箱内にあるフォルダを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrashFolder" } } } }, "404": { "description": "フォルダがごみ箱で直接見つからない場合にエラーを返します。\n\nそのフォルダの親フォルダのいずれかがごみ箱に移動されている場合も、`HTTP 404`が返されることに注意してください。\n\nその場合、[`GET /folders/:id/trash`](e://get_folders_id_trash) APIを使用して調べることができるのは、その親フォルダのみです。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_folders_id_trash", "summary": "フォルダを完全に削除", "tags": [ "ごみ箱内のフォルダ" ], "x-box-tag": "trashed_folders", "description": "ごみ箱内にあるフォルダを完全に削除します。この操作は元に戻すことができません。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "204": { "description": "フォルダが完全に削除された場合は、空のレスポンスを返します。" }, "404": { "description": "フォルダがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/metadata": { "get": { "operationId": "get_folders_id_metadata", "summary": "フォルダのメタデータインスタンスのリストを取得", "tags": [ "メタデータインスタンス (フォルダ)" ], "x-box-tag": "folder_metadata", "x-box-sanitized": true, "description": "指定したフォルダのすべてのメタデータを取得します。これは、IDが`0`のルートフォルダでは使用できません。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "200": { "description": "フォルダに関連付けられたすべてのメタデータを返します。\n\nこのAPIはページ割りをサポートしていないため、常にフォルダに関連付けられたすべてのメタデータを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadatas" } } } }, "403": { "description": "リクエストパラメータが無効な場合に返されます。\n\n* `forbidden` - この操作はルートフォルダで許可されていません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/metadata/enterprise/securityClassification-6VMVochwUWo": { "get": { "operationId": "get_folders_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "フォルダの分類を取得", "tags": [ "フォルダの分類" ], "x-box-tag": "folder_classifications", "x-box-sanitized": true, "description": "フォルダに適用されている分類メタデータインスタンスを取得します。\n\nこのAPIは、`/folders/:id//enterprise_12345/securityClassification-6VMVochwUWo`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "201": { "description": "`securityClassification`メタデータテンプレートのインスタンスを返します。これには、この会社が使用できるすべての分類のリストを取得する`Box__Security__Classification__Key`フィールドが含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Classification" } } } }, "403": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定したメタデータテンプレートがこのフォルダに適用されていない場合、またはユーザーがこのフォルダにアクセスできない場合に返されます。\n\n* `instance_not_found` - メタデータテンプレートがフォルダに適用されていなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_folders_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "フォルダに分類を追加", "tags": [ "フォルダの分類" ], "x-box-tag": "folder_classifications", "x-box-sanitized": true, "description": "追加する分類のラベルを指定することで、フォルダに分類を追加します。\n\nこのAPIは、`/folders/:id//enterprise_12345/securityClassification-6VMVochwUWo`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "Box__Security__Classification__Key": { "type": "string", "description": "このフォルダに適用する分類の名前。\n\n会社で使用できる分類のリストを取得するには、分類APIを使用して、使用可能なすべての分類キーが表示される[分類テンプレート](e://get_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema)を取得します。", "example": "Sensitive" } } } } } }, "responses": { "201": { "description": "フォルダに適用された分類テンプレートインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Classification" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。\n\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできません。\n* `instance_tuple_not_found` - メタデータテンプレートが見つかりませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "このメタデータテンプレートのインスタンスがすでにフォルダに存在する場合はエラーを返します。\n\n* `tuple_already_exists` - メタデータテンプレートのインスタンスがすでにフォルダに存在する場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_folders_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "フォルダの分類を更新", "tags": [ "フォルダの分類" ], "x-box-tag": "folder_classifications", "x-box-sanitized": true, "description": "フォルダの分類を更新します。\n\n分類を更新できるのは、分類がすでにフォルダに適用されている場合のみです。分類を編集する際は、会社に対して定義されている値のみを使用できます。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "requestBody": { "content": { "application/json-patch+json": { "schema": { "required": [ "items" ], "description": "分類ラベルを更新するために加える1つの変更を含むリスト。", "type": "array", "items": { "type": "object", "description": "分類メタデータテンプレートのインスタンスに対して実行する操作。この場合、`Box__Security__Classification__Key`フィールドに格納された値を新しい値で置き換えるために使用されます。", "required": [ "op", "path", "value" ], "properties": { "op": { "type": "string", "example": "replace", "description": "`replace`", "enum": [ "replace" ] }, "path": { "type": "string", "example": "/Box__Security__Classification__Key", "description": "企業で使用できる分類を定義します。", "enum": [ "/Box__Security__Classification__Key" ] }, "value": { "type": "string", "description": "このフォルダに適用する分類の名前。\n\n会社で使用できる分類のリストを取得するには、分類APIを使用して、使用可能なすべての分類キーが表示される[分類テンプレート](e://get_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema)を取得します。", "example": "Sensitive" } } } } } } }, "responses": { "200": { "description": "更新された分類メタデータテンプレートインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Classification" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `bad_request` - リクエスト本文の形式が有効なJSON Patch操作の配列ではありません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "リクエスト本文が有効なJSON Patch項目の配列でない場合、一部のエッジケースでエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_folders_id_metadata_enterprise_securityClassification-6VMVochwUWo", "summary": "フォルダから分類を削除", "tags": [ "フォルダの分類" ], "x-box-tag": "folder_classifications", "x-box-sanitized": true, "description": "フォルダからすべての分類を削除します。\n\nこのAPIは、`/folders/:id//enterprise_12345/securityClassification-6VMVochwUWo`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "204": { "description": "分類が正常に削除された場合は空のレスポンスを返します。" }, "400": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダに分類が適用されていない場合、またはユーザーがフォルダにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - 分類メタデータテンプレートのインスタンスがこのフォルダに見つかりませんでした。\n* `not_found` - フォルダが見つからなかったか、ユーザーがフォルダにアクセスできません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/metadata/{scope}/{template_key}": { "get": { "operationId": "get_folders_id_metadata_id_id", "summary": "フォルダのメタデータインスタンスを取得", "tags": [ "メタデータインスタンス (フォルダ)" ], "x-box-tag": "folder_metadata", "x-box-sanitized": true, "description": "フォルダに適用されているメタデータテンプレートのインスタンスを取得します。これは、IDが`0`のルートフォルダでは使用できません。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "ユーザーまたはアプリケーションによって定義された追加の「キー/値」ペアを含むメタデータテンプレートのインスタンス。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadata--Full" } } } }, "403": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定したメタデータテンプレートがこのフォルダに適用されていない場合、またはユーザーがこのフォルダにアクセスできない場合に返されます。\n\n* `instance_not_found` - メタデータテンプレートがフォルダに適用されていなかった場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。これは、フォルダIDが無効であるか、IDが`0`のルートフォルダである場合によく発生します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_folders_id_metadata_id_id", "summary": "フォルダにメタデータインスタンスを作成", "tags": [ "メタデータインスタンス (フォルダ)" ], "x-box-tag": "folder_metadata", "x-box-sanitized": true, "x-box-enable-explorer": false, "description": "メタデータテンプレートのインスタンスをフォルダに適用します。\n\nほとんどの場合、メタデータテンプレートに存在する値のみを使用できます。ただし、任意のキー/値ペアを使用できる`global.properties`テンプレートは除きます。\n\nBoxウェブアプリでメタデータテンプレートを表示するために、企業では、管理コンソールでユーザーの \\[**フォルダレベルメタデータのカスケード**] を有効にするよう設定する必要があります。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "example": { "name": "Aaron Levie" }, "additionalProperties": { "allOf": [ {}, { "example": "Aaron Levie" }, { "description": "メタデータテンプレートに存在する各フィールドの値。`global.properties`テンプレートの場合、汎用的なキー/値ペアをテンプレートに保存できるため、0個以上のフィールドのリストにすることができます。" } ] }, "x-box-example-key": "name" } } } }, "responses": { "201": { "description": "テンプレートに適用されたデータを含む、フォルダに適用されたテンプレートのインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadata--Full" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。\n\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできません。\n* `instance_tuple_not_found` - メタデータテンプレートが見つかりませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "このメタデータテンプレートのインスタンスがすでにフォルダに存在する場合はエラーを返します。\n\n* `tuple_already_exists` - メタデータテンプレートのインスタンスがすでにファイルに存在する場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_folders_id_metadata_id_id", "summary": "フォルダのメタデータインスタンスを更新", "tags": [ "メタデータインスタンス (フォルダ)" ], "x-box-tag": "folder_metadata", "x-box-sanitized": true, "description": "フォルダのメタデータを更新します。\n\nメタデータインスタンスを更新できるのは、テンプレートがすでにフォルダに適用されている場合のみです。メタデータを編集する際には、メタデータテンプレートのスキーマに一致した値のみを使用できます。\n\n更新はアトミックに適用されます。操作の適用中にエラーが発生した場合、メタデータインスタンスは変更されません。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json-patch+json": { "schema": { "description": "メタデータインスタンスに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)の指定。\n\n変更は操作オブジェクトのJSON配列として表されます。", "type": "array", "items": { "title": "メタデータインスタンスの更新操作", "description": "メタデータインスタンスに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)操作。", "type": "object", "properties": { "op": { "type": "string", "example": "add", "enum": [ "add", "replace", "remove", "test", "move", "copy" ], "description": "テンプレートに対して実行する変更のタイプ。その中には、既存のテンプレートを変更する際に危険を伴うものもあります。" }, "path": { "type": "string", "example": "/currentState", "description": "変更を適用するメタデータJSONオブジェクト内の場所を、[JSON-Pointer](https://tools.ietf.org/html/rfc6901)の形式で指定します。\n\nパスの先頭にはテンプレートのルートを表す`/`を必ず付ける必要があります。文字`~`と`/`は予約文字であるため、キー内ではエスケープする必要があります。" }, "value": { "type": "string", "example": "reviewed", "description": "設定またはテストする値。\n\n`add`、`replace`、`test`操作では必須です。`add`の場合、値がすでに存在するときは、古い値が新しい値で上書きされます。`replace`の場合、置換の前に値がすでに存在している必要があります。\n\n`test`の場合、`path`の位置にある既存の値が指定した値と一致している必要があります。" }, "from": { "type": "string", "example": "/nextState", "description": "値の移動元またはコピー元であるメタデータJSONオブジェクト内の場所。`move`または`copy`操作には必須であり、[JSON-Pointer](https://tools.ietf.org/html/rfc6901)の形式である必要があります。" } } } } } } }, "responses": { "200": { "description": "カスタムテンプレートデータを含め、更新されたメタデータテンプレートインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Metadata--Full" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `bad_request` - リクエスト本文の形式が有効なJSON Patchオブジェクトの配列ではありません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "リクエスト本文が有効なJSON Patch項目の配列でない場合、一部のエッジケースでエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_folders_id_metadata_id_id", "summary": "フォルダからメタデータインスタンスを削除", "tags": [ "メタデータインスタンス (フォルダ)" ], "x-box-tag": "folder_metadata", "x-box-sanitized": true, "description": "フォルダのメタデータを削除します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "メタデータが正常に削除された場合は空のレスポンスを返します。" }, "400": { "description": "リクエストのパラメータが無効な場合に返されます。これは、`scope`が無効な場合に発生する可能性があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダにメタデータテンプレートのインスタンスが適用されていない場合、またはユーザーがフォルダにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - 指定された`scope`および`templateKey`を持つメタデータテンプレートのインスタンスがこのフォルダに見つかりませんでした。\n* `not_found` - フォルダが見つからなかったか、ユーザーがフォルダにアクセスできません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "メソッドが許可されなかった場合に返されます。これは、フォルダIDが無効であるか、IDが`0`のルートフォルダである場合によく発生します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/trash/items": { "get": { "operationId": "get_folders_trash_items", "summary": "ごみ箱内の項目のリストを取得", "tags": [ "ごみ箱内の項目" ], "x-box-tag": "trashed_items", "description": "ごみ箱に移動されたファイルとフォルダを取得します。\n\n`fields`パラメータを使用して完全版のファイルオブジェクトまたはフォルダオブジェクト内の任意の属性を渡すと、デフォルトでは返されない特定の属性を取得できます。\n\nこのエンドポイントはデフォルトでオフセットベースのページ割りを使用しますが、`marker`パラメータを使用したマーカーベースのページ割りもサポートしています。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "usemarker", "description": "オフセットベースのページ割り方式ではなくマーカーベースのページ割り方式を使用するかどうかを指定します。同時に使用できるページ割りの方式は1つのみです。\n\nこの値をtrueに設定すると、APIは、レスポンスの次のページを取得するために、このエンドポイントにパラメータとして渡すことができる`marker`フィールドを返します。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "direction", "description": "結果を並べ替える方向。アルファベットの昇順 (`ASC`) または降順 (`DESC`) のいずれかを指定できます。", "in": "query", "required": false, "example": "ASC", "schema": { "type": "string", "enum": [ "ASC", "DESC" ] } }, { "name": "sort", "description": "項目並べ替えの**2番目**の基準として使用される属性を定義します。\n\n項目は必ず最初に`type`を基準にして並べ替えられ、フォルダはファイルよりも前に、ファイルはウェブリンクよりも前にリストされます。\n\nマーカーベースのページ割りを使用している場合、このパラメータはサポートされません。", "in": "query", "required": false, "example": "name", "schema": { "type": "string", "enum": [ "name", "date", "size" ] } } ], "responses": { "200": { "description": "削除された項目のリストを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Items" } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `invalid_parameter`は、マーカーベースのページ割りの使用時に`sort`、`direction`、または`offset`パラメータを指定した場合か、`marker`パラメータが指定されているのに`usemarker`が`false`または`null`に設定されている場合に返されることがあります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}/watermark": { "get": { "operationId": "get_folders_id_watermark", "summary": "フォルダの電子すかしを取得", "tags": [ "電子すかし (フォルダ)" ], "x-box-tag": "folder_watermarks", "description": "フォルダの電子すかしを取得します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "200": { "description": "このフォルダに関連付けられている電子すかしに関する情報を含むオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watermark" } } } }, "404": { "description": "フォルダに電子すかしが適用されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_folders_id_watermark", "summary": "フォルダに電子すかしを適用", "tags": [ "電子すかし (フォルダ)" ], "x-box-tag": "folder_watermarks", "description": "フォルダの電子すかしを適用または更新します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "watermark" ], "properties": { "watermark": { "type": "object", "description": "フォルダに適用する電子すかし", "required": [ "imprint" ], "properties": { "imprint": { "type": "string", "example": "default", "description": "適用する電子すかしのタイプ。\n\n現在サポートされているオプションは1つのみです。", "enum": [ "default" ] } } } } } } } }, "responses": { "200": { "description": "このフォルダに電子すかしがすでに適用されている場合は、更新された電子すかしを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watermark" } } } }, "201": { "description": "このフォルダにまだ電子すかしが適用されていない場合は、新しい電子すかしを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watermark" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_folders_id_watermark", "summary": "フォルダから電子すかしを削除", "tags": [ "電子すかし (フォルダ)" ], "x-box-tag": "folder_watermarks", "description": "フォルダから電子すかしを削除します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "204": { "description": "電子すかしが正常に削除された場合は、空のレスポンスが返されます。" }, "404": { "description": "フォルダに電子すかしが適用されていない場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folder_locks": { "get": { "operationId": "get_folder_locks", "summary": "フォルダロックのリストを取得", "tags": [ "フォルダロック" ], "x-box-tag": "folder_locks", "x-box-sanitized": true, "x-box-enable-explorer": true, "description": "指定したフォルダのフォルダロックの詳細を取得します。\n\nこのエンドポイントを使用するには、フォルダの所有者または共同所有者として認証されている必要があります。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "query", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "200": { "description": "フォルダに適用されたすべてのフォルダロックの詳細 (ロックの種類やロックを適用したユーザーを含む) を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FolderLocks" } } } }, "403": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_folder_locks", "summary": "フォルダロックを作成", "tags": [ "フォルダロック" ], "x-box-tag": "folder_locks", "x-box-sanitized": true, "x-box-enable-explorer": false, "description": "フォルダにフォルダロックを作成し、フォルダが移動または削除されないようにします。\n\nこのエンドポイントを使用するには、フォルダの所有者または共同所有者として認証されている必要があります。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "folder" ], "properties": { "locked_operations": { "type": "object", "description": "フォルダをロックする操作。`locked_operations`がリクエストに含まれている場合は、`move`と`delete`の両方も含めたうえで、どちらも`true`に設定する必要があります。", "required": [ "move", "delete" ], "properties": { "move": { "type": "boolean", "description": "フォルダの移動をロックするかどうか。", "example": true }, "delete": { "type": "boolean", "description": "フォルダの削除をロックするかどうか。", "example": true } } }, "folder": { "type": "object", "description": "ロックの適用先となるフォルダ。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "description": "ロックが適用されているコンテンツタイプ。`folder`のみがサポートされています。", "example": "folder" }, "id": { "type": "string", "description": "フォルダのID。", "example": "1234567890" } } } } } } } }, "responses": { "200": { "description": "ロックを適用したユーザーや設定された操作など、フォルダに適用されたフォルダロックのインスタンスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FolderLock" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからなかった場合にエラーを返します。\n\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできないか、または呼び出しを行うユーザーがフォルダの所有者または共同所有者ではない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folder_locks/{folder_lock_id}": { "delete": { "operationId": "delete_folder_locks_id", "summary": "フォルダロックを削除", "description": "指定したフォルダに適用されているフォルダロックを削除します。\n\nこのエンドポイントを使用するには、フォルダの所有者または共同所有者として認証されている必要があります。", "tags": [ "フォルダロック" ], "x-box-tag": "folder_locks", "x-box-sanitized": true, "parameters": [ { "name": "folder_lock_id", "description": "フォルダロックのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } } ], "responses": { "204": { "description": "フォルダロックが正常に削除された場合は、空のレスポンスを返します。" }, "403": { "description": "ユーザーにこのアクションを実行するためのアクセス権限がない場合はエラーを返します。\n\n* `access_denied_insufficient_permissions`: ユーザーにフォルダへのアクセス権限がない場合に返されます。\n\n* `insufficient_scope`: アプリケーションにフォルダを削除するための適切なスコープがない場合にエラーが返されます。Boxに格納されているすべてのファイルとフォルダに対して読み取りと書き込みを行えるようにアプリケーションが設定されていることを確認してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからないか、認証済みユーザーが親フォルダにアクセスできない場合は、エラーを返します。\n\n* `not_found` - 認証済みユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates": { "get": { "operationId": "get_metadata_templates", "summary": "インスタンスIDでメタデータテンプレートを検索", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "description": "テンプレートのインスタンスのIDを検索することにより、メタデータテンプレートを見つけます。", "parameters": [ { "name": "metadata_instance_id", "description": "検索するメタデータテンプレートのインスタンスのID。", "example": "01234500-12f1-1234-aa12-b1d234cb567e", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "インスタンスIDと一致する1つのメタデータテンプレートを含むリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplates" } } } }, "400": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/enterprise/securityClassification-6VMVochwUWo/schema": { "get": { "operationId": "get_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema", "summary": "すべての分類のリストを取得", "tags": [ "Classifications" ], "x-box-tag": "classifications", "x-box-sanitized": true, "description": "分類メタデータテンプレートを取得し、この会社が使用できるすべての分類のリストを取得します。\n\nこのAPIは、`/metadata_templates/enterprise_12345/securityClassification-6VMVochwUWo/schema`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "responses": { "200": { "description": "`securityClassification`メタデータテンプレートを返します。これには、この会社が使用できるすべての分類のリストを取得する`Box__Security__Classification__Key`フィールドが含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassificationTemplate" } } } }, "400": { "description": "リクエストパラメータのいずれかが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "テンプレート名が正しくないときに返されます。リクエストのURLが正しいことを確認してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/enterprise/securityClassification-6VMVochwUWo/schema#add": { "put": { "operationId": "put_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema#add", "summary": "分類を追加", "tags": [ "Classifications" ], "x-box-tag": "classifications", "description": "会社が使用できる分類のリストに1つ以上の新しい分類を追加します。\n\nこのAPIは、`/metadata_templates/enterprise_12345/securityClassification-6VMVochwUWo/schema`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "requestBody": { "content": { "application/json": { "schema": { "required": [ "items" ], "description": "会社の分類のリストに追加する1つ以上の分類を含む配列。", "type": "array", "items": { "type": "object", "description": "会社に追加する1つの分類。", "required": [ "op", "fieldKey", "data" ], "properties": { "op": { "type": "string", "example": "addEnumOption", "description": "分類オブジェクトに対して実行する変更の種類。", "enum": [ "addEnumOption" ] }, "fieldKey": { "type": "string", "example": "Box__Security__Classification__Key", "description": "企業で使用できる分類を定義します。", "enum": [ "Box__Security__Classification__Key" ] }, "data": { "type": "object", "required": [ "key" ], "description": "追加する分類の詳細。", "properties": { "key": { "type": "string", "example": "Sensitive", "description": "ウェブインターフェースおよびモバイルインターフェースに表示される分類のラベル。これは、分類を追加するために必要な唯一のフィールドです。" }, "staticConfig": { "type": "object", "description": "分類の静的な構成。", "properties": { "classification": { "type": "object", "description": "分類の追加情報。", "properties": { "classificationDefinition": { "type": "string", "example": "Sensitive information that must not be shared.", "description": "分類の詳しい説明。" }, "colorID": { "type": "integer", "format": "int64", "example": 4, "description": "分類ラベルに色を割り当てる際に使用される内部のBox識別子。\n\n`colorID`と色の間のマッピングは予告なしに変更される場合があります。現在、色のマッピングは以下のとおりです。\n\n* `0`: 黄\n* `1`: オレンジ\n* `2`: 赤\n* `3`: 紫\n* `4`: ライトブルー\n* `5`: ダークブルー\n* `6`: ライトグリーン\n* `7`: グレー" } } } } } } } } } } } } }, "responses": { "200": { "description": "更新された`securityClassification`メタデータテンプレートを返します。これには、この会社が使用できるすべての分類のリストを取得する`Box__Security__Classification__Key`フィールドが含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassificationTemplate" } } } }, "400": { "description": "リクエストパラメータのいずれかが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "テンプレート名が正しくないときに返されます。リクエストのURLが正しいことを確認してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/enterprise/securityClassification-6VMVochwUWo/schema#update": { "put": { "operationId": "put_metadata_templates_enterprise_securityClassification-6VMVochwUWo_schema#update", "summary": "分類を更新", "tags": [ "Classifications" ], "x-box-tag": "classifications", "x-box-sanitized": true, "description": "会社が使用できる1つ以上の分類のラベルと説明を更新します。\n\nこのAPIは、`/metadata_templates/enterprise_12345/securityClassification-6VMVochwUWo/schema`のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。", "requestBody": { "content": { "application/json-patch+json": { "schema": { "description": "更新する1つ以上の分類を含む配列。", "type": "array", "required": [ "items" ], "items": { "type": "object", "description": "更新する1つの分類。", "required": [ "op", "fieldKey", "enumOptionKey", "data" ], "properties": { "op": { "type": "string", "example": "editEnumOption", "description": "分類オブジェクトに対して実行する変更の種類。", "enum": [ "editEnumOption" ] }, "fieldKey": { "type": "string", "example": "Box__Security__Classification__Key", "description": "企業で使用できる分類を定義します。", "enum": [ "Box__Security__Classification__Key" ] }, "enumOptionKey": { "type": "string", "example": "Sensitive", "description": "変更する分類の元のラベル。" }, "data": { "type": "object", "required": [ "key" ], "description": "更新された分類の詳細。", "properties": { "key": { "type": "string", "example": "Very Sensitive", "description": "ウェブインターフェースおよびモバイルインターフェースに表示される、分類の新しいラベル。" }, "staticConfig": { "type": "object", "description": "分類の静的な構成。", "properties": { "classification": { "type": "object", "description": "分類の追加情報。", "properties": { "classificationDefinition": { "type": "string", "example": "Sensitive information that must not be shared.", "description": "分類の詳しい説明。" }, "colorID": { "type": "integer", "format": "int64", "example": 4, "description": "分類ラベルに色を割り当てる際に使用される内部のBox識別子。\n\n`colorID`と色の間のマッピングは予告なしに変更される場合があります。現在、色のマッピングは以下のとおりです。\n\n* `0`: 黄\n* `1`: オレンジ\n* `2`: 赤\n* `3`: 紫\n* `4`: ライトブルー\n* `5`: ダークブルー\n* `6`: ライトグリーン\n* `7`: グレー" } } } } } } } } } } } } }, "responses": { "200": { "description": "更新された`securityClassification`メタデータテンプレートを返します。これには、この会社が使用できるすべての分類のリストを取得する`Box__Security__Classification__Key`フィールドが含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassificationTemplate" } } } }, "400": { "description": "リクエストパラメータのいずれかが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "テンプレート名が正しくないときに返されます。リクエストのURLが正しいことを確認してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/{scope}/{template_key}/schema": { "get": { "operationId": "get_metadata_templates_id_id_schema", "summary": "名前を指定してメタデータテンプレートを取得", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "description": "`scope`と`templateKey`の値でメタデータテンプレートを取得します。\n\nテンプレートの`scope`と`templateKey`を調べるには、会社のすべてのテンプレートまたはグローバルテンプレートのリストを取得するか、ファイルまたはフォルダに適用されているすべてのテンプレートのリストを取得します。", "parameters": [ { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "`scope`および`template`の名前と一致するメタデータテンプレートを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplate" } } } }, "400": { "description": "リクエストパラメータのいずれかが無効な場合に返されます。\n\n* `bad_request`: テンプレートのスコープが認識されていない場合によく返されます。`scope`の値として必ず`enterprise`または`global`を使用してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定された`scope`および`template_key`を持つテンプレートが見つからない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_metadata_templates_id_id_schema", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "summary": "メタデータテンプレートを更新", "description": "メタデータテンプレートを更新します。\n\nメタデータテンプレートを更新できるのは、テンプレートがすでに存在する場合のみです。\n\n更新はアトミックに適用されます。操作の適用中にエラー場が発生した場合、メタデータテンプレートは変更されません。", "parameters": [ { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json-patch+json": { "schema": { "description": "メタデータテンプレートに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)の指定。\n\n変更は操作オブジェクトのJSON配列として表されます。", "type": "array", "items": { "title": "メタデータテンプレートの更新操作", "description": "メタデータインスタンスに変更を加えるための[JSON-Patch](https://tools.ietf.org/html/rfc6902)操作。", "type": "object", "required": [ "op" ], "properties": { "op": { "type": "string", "example": "addEnumOption", "enum": [ "editTemplate", "addField", "reorderFields", "addEnumOption", "reorderEnumOptions", "reorderMultiSelectOptions", "addMultiSelectOption", "editField", "removeField", "editEnumOption", "removeEnumOption", "editMultiSelectOption", "removeMultiSelectOption" ], "description": "テンプレートに対して実行する変更のタイプ。その中には、既存のテンプレートを変更する際に危険を伴うものもあります。" }, "data": { "type": "object", "description": "操作するデータ。これは、実行される操作によって異なります。", "example": { "name": "Aaron Levie" }, "additionalProperties": { "allOf": [ {}, { "example": "Aaron Levie" }, { "description": "メタデータテンプレートに存在する各フィールドの値。`global.properties`テンプレートの場合、汎用的なキー/値ペアをテンプレートに保存できるため、0個以上のフィールドのリストにすることができます。" } ], "x-box-example-key": "name" } }, "fieldKey": { "type": "string", "example": "category", "description": "1つのフィールドに影響する操作の場合は、影響を受けるフィールドのキーを定義します。" }, "fieldKeys": { "type": "array", "items": { "type": "string" }, "example": [ "category", "name" ], "description": "複数のフィールドに影響する操作の場合は、影響を受けるフィールドのキーを定義します。" }, "enumOptionKey": { "description": "1つの`enum`オプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。", "type": "string", "example": "option1" }, "enumOptionKeys": { "description": "複数の`enum`オプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。", "type": "array", "items": { "type": "string" }, "example": [ "option1", "option2", "option3" ] }, "multiSelectOptionKey": { "description": "1つの複数選択オプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。", "type": "string", "example": "option1" }, "multiSelectOptionKeys": { "description": "複数の複数選択オプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。", "type": "array", "items": { "type": "string" }, "example": [ "option1", "option2", "option3" ] } } } } } } }, "responses": { "200": { "description": "カスタムテンプレートデータを含め、更新されたメタデータテンプレートを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplate" } } } }, "400": { "description": "リクエスト本文に有効なメタデータスキーマが含まれていません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーがテンプレートを作成できないスコープがリクエスト本文に含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "リクエストしたテンプレートが見つかりませんでした", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_metadata_templates_id_id_schema", "summary": "メタデータテンプレートを削除", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "description": "メタデータテンプレートとそのインスタンスを削除します。これは完全削除であり、元に戻すことはできません。", "parameters": [ { "name": "scope", "description": "メタデータテンプレートのスコープ", "example": "global", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "global", "enterprise" ] } }, { "name": "template_key", "description": "メタデータテンプレートの名前", "example": "properties", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "メタデータテンプレートが正常に削除された場合は、空のレスポンスを返します。" }, "400": { "description": "リクエスト本文に有効なメタデータスキーマが含まれていません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーがテンプレートを作成できないスコープがリクエスト本文に含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/{template_id}": { "get": { "operationId": "get_metadata_templates_id", "summary": "IDを指定してメタデータテンプレートを取得", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "description": "IDを指定してメタデータテンプレートを取得します。", "parameters": [ { "name": "template_id", "schema": { "type": "string" }, "required": true, "in": "path", "example": "f7a9891f", "description": "テンプレートのID" } ], "responses": { "200": { "description": "IDと一致するメタデータテンプレートを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplate" } } } }, "400": { "description": "リクエストパラメータのいずれかが無効な場合に返されます。\n\n* `bad_request`: テンプレートのIDが認識されていない場合によくメッセージとともに返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplate" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/global": { "get": { "operationId": "get_metadata_templates_global", "summary": "すべてのグローバルメタデータテンプレートのリストを取得", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "description": "Boxを使用するすべての会社が利用できる、すべての汎用グローバルメタデータテンプレートを取得する場合に使用します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "すべての会社とそれに対応するスキーマで使用できるすべてのメタデータテンプレートを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplates" } } } }, "400": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/enterprise": { "get": { "operationId": "get_metadata_templates_enterprise", "summary": "企業のすべてのメタデータテンプレートのリストを取得", "tags": [ "メタデータテンプレート" ], "x-box-tag": "metadata_templates", "x-box-sanitized": true, "description": "特にユーザーの企業内で使用するために作成されたメタデータテンプレートをすべて取得する場合に使用します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "企業内のすべてのメタデータテンプレートと、各テンプレートに対応するスキーマを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplates" } } } }, "400": { "description": "リクエストパラメータが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/schema": { "post": { "operationId": "post_metadata_templates_schema", "summary": "メタデータテンプレートを作成", "tags": [ "メタデータテンプレート" ], "description": "ファイルやフォルダに適用可能な新しいメタデータテンプレートを作成します。", "x-box-tag": "metadata_templates", "x-box-requires-admin": true, "x-box-sanitized": true, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "scope", "displayName" ], "properties": { "scope": { "type": "string", "description": "作成するメタデータテンプレートのスコープ。アプリケーションで作成できるのは、認証済みユーザーの会社内で使用するテンプレートのみです。\n\nこの値は`enterprise`に設定する必要があります。`global`スコープはアプリケーションで作成できないからです。", "example": "enterprise" }, "templateKey": { "type": "string", "example": "productInfo", "description": "テンプレートの一意の識別子。この識別子は、メタデータテンプレート作成の対象となる会社全体で一意である必要があります。\n\n指定しなかった場合、APIにより`displayName`の値に基づいて一意の`templateKey`が作成されます。", "maxLength": 64, "pattern": "^[a-zA-Z_][-a-zA-Z0-9_]*$" }, "displayName": { "type": "string", "description": "テンプレートの表示名。", "maxLength": 4096, "example": "Product Info" }, "hidden": { "type": "boolean", "example": true, "description": "このテンプレートをBoxウェブアプリのUIに表示するか、APIを介した使用のみを目的とするかを定義します。", "default": false }, "fields": { "type": "array", "description": "テンプレートに含まれるテンプレートフィールドの並べ替えられたリスト。各フィールドは、通常のテキストフィールド、日付フィールド、数値フィールド、単一または複数選択リストのいずれかになります。", "items": { "title": "メタデータフィールド (書き込み)", "description": "メタデータテンプレート内のフィールド。フィールドは、基本のテキスト、日付、または数値フィールドか、オプションのリストのいずれかになります。", "required": [ "type", "key", "displayName" ], "type": "object", "properties": { "type": { "type": "string", "example": "string", "description": "フィールドのタイプ。基本のフィールドは、テキストを表す`string`フィールド、数値を表す`float`フィールド、およびユーザーに日時選択機能を表示するための`date`フィールドです。\n\nさらに、メタデータテンプレートは、基本の項目リストを表す`enum`フィールドのほか、ユーザーが複数の値を選択できる同様の項目リストを表す` multiSelect`フィールドをサポートしています。", "enum": [ "string", "float", "date", "enum", "multiSelect" ] }, "key": { "type": "string", "example": "category", "description": "フィールドの一意の識別子。この識別子は、そのフィールドが属するテンプレート内で一意である必要があります。", "maxLength": 256 }, "displayName": { "type": "string", "example": "Category", "description": "ウェブアプリおよびモバイルアプリでユーザーに表示されるフィールドの表示名。", "maxLength": 4096 }, "description": { "type": "string", "example": "The category", "description": "フィールドの説明。ユーザーには表示されません。", "maxLength": 4096 }, "hidden": { "type": "boolean", "example": true, "description": "このフィールドをUI上でユーザーに対して非表示にし、代わりにAPIを介してのみ設定できるようにするかどうか。" }, "options": { "description": "このフィールドのオプションのリスト。`enum`および`multiSelect`フィールドタイプと組み合わせて使用します。", "type": "array", "items": { "title": "メタデータオプション (書き込み)", "type": "object", "description": "メタデータテンプレートフィールドのオプション。\n\nオプションは、`enum`タイプおよび`multiSelect`タイプのフィールドのみに指定する必要があります。 オプションは、ユーザーがUIまたはAPIを介してそのフィールドに選択できる値を表します。", "required": [ "key" ], "properties": { "key": { "description": "オプションのテキスト値。オプションの表示名と、テンプレートの更新時に使用される内部キーの両方を表します。", "example": "Category 1", "type": "string" } } } } } } }, "copyInstanceOnItemCopy": { "type": "boolean", "description": "ファイルまたはフォルダをコピーするときに、追加されているメタデータをコピーするかどうか。デフォルトでは、ファイルまたはフォルダのコピー時に、メタデータは一緒にコピーされません。", "default": false, "example": true } } } } } }, "responses": { "201": { "description": "作成されたメタデータテンプレートを表すスキーマ。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataTemplate" } } } }, "400": { "description": "リクエストのパラメータまたは本文が無効な場合に返されます。\n\n* `bad_request` - 本文に有効なリクエストが含まれていない場合に返されます。多くの場合、このレスポンスには、不足しているフィールドに関する追加の詳細が含まれます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーにメタデータテンプレートを作成する権限がない場合に返されます。その理由はいくつかありますが、最も一般的なのは、ユーザーが (共同) 管理者権限を持っていないこと、またはアプリケーションが`global`スコープのテンプレートを作成しようとしていることです。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_templates/schema#classifications": { "post": { "operationId": "post_metadata_templates_schema#classifications", "summary": "最初の分類を追加", "tags": [ "Classifications" ], "x-box-tag": "classifications", "x-box-sanitized": true, "description": "会社にまだ分類がない場合は、このAPIコールによって、分類テンプレートが最初の一連の分類で初期化されます。\n\n会社にすでに分類がある場合は、テンプレートがすでに存在するため、さらに分類を追加するためにAPIコールが行われます。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "scope", "displayName", "fields", "templateKey" ], "properties": { "scope": { "type": "string", "description": "分類を作成するスコープ。これには、`enterprise`または`enterprise_{id}` (`id`は会社の一意のID) を指定する必要があります。", "example": "enterprise", "enum": [ "enterprise" ] }, "templateKey": { "type": "string", "example": "securityClassification-6VMVochwUWo", "description": "メタデータテンプレートのリストを定義します。", "enum": [ "securityClassification-6VMVochwUWo" ] }, "displayName": { "type": "string", "description": "ウェブインターフェースおよびモバイルインターフェースに表示されるテンプレートの名前。", "example": "Classification", "enum": [ "Classification" ] }, "hidden": { "type": "boolean", "example": false, "description": "分類テンプレートをウェブおよびモバイルデバイスで非表示にするか使用可能にするかを決定します。" }, "copyInstanceOnItemCopy": { "type": "boolean", "example": false, "description": "ファイルまたはフォルダをコピーするときに分類もコピーするかどうかを決定します。" }, "fields": { "type": "array", "description": "分類テンプレートにはフィールドが1つだけ必要で、このフィールドでは、有効な分類の値がすべて保持されます。", "items": { "required": [ "type", "key", "displayName", "options" ], "type": "object", "description": "有効な分類の値をすべて保持する`enum`フィールド。", "properties": { "type": { "type": "string", "example": "enum", "description": "常に列挙型となるフィールドのタイプ。", "enum": [ "enum" ] }, "key": { "type": "string", "example": "Box__Security__Classification__Key", "description": "企業で使用できる分類を定義します。", "enum": [ "Box__Security__Classification__Key" ] }, "displayName": { "type": "string", "example": "Classification", "description": "分類の表示名。", "enum": [ "Classification" ] }, "hidden": { "type": "boolean", "example": false, "description": "分類テンプレートをウェブおよびモバイルデバイスで非表示にするか使用可能にするかを決定します。" }, "options": { "type": "array", "description": "このテンプレートに存在する実際の分類のリスト。", "items": { "required": [ "key" ], "type": "object", "description": "個々の分類。", "properties": { "key": { "type": "string", "description": "この分類の表示名とキー。これはBox UIに表示されます。", "example": "Sensitive" }, "staticConfig": { "type": "object", "description": "分類に関する追加情報。", "properties": { "classification": { "type": "object", "description": "分類に関する追加情報。", "properties": { "classificationDefinition": { "type": "string", "example": "Sensitive information", "description": "分類の詳しい説明。" }, "colorID": { "type": "integer", "format": "int64", "example": 4, "description": "分類ラベルに色を割り当てる際に使用される識別子。\n\n`colorID`と色の間のマッピングは予告なしに変更される場合があります。現在、色のマッピングは以下のとおりです。\n\n* `0`: 黄\n* `1`: オレンジ\n* `2`: 赤\n* `3`: 紫\n* `4`: ライトブルー\n* `5`: ダークブルー\n* `6`: ライトグリーン\n* `7`: グレー" } } } } } } } } } } } } } } } }, "responses": { "200": { "description": "新しい`securityClassification`メタデータテンプレートを返します。これには、この会社が使用できるすべての分類のリストを取得する`Box__Security__Classification__Key`フィールドが含まれています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassificationTemplate" } } } }, "400": { "description": "リクエストパラメータのいずれかが無効な場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "テンプレート名が正しくないときに返されます。リクエストのURLが正しいことを確認してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_cascade_policies": { "get": { "operationId": "get_metadata_cascade_policies", "summary": "メタデータカスケードポリシーのリストを取得", "tags": [ "メタデータカスケードポリシー" ], "x-box-tag": "metadata_cascade_policies", "x-box-sanitized": true, "description": "指定したフォルダに適用されているすべてのメタデータカスケードポリシーのリストを取得します。これは、IDが`0`のルートフォルダでは使用できません。", "parameters": [ { "name": "folder_id", "in": "query", "required": true, "schema": { "type": "string" }, "example": "31232", "description": "どのフォルダのポリシーを返すかを指定します。これは、IDが`0`のルートフォルダでは使用できません。" }, { "name": "owner_enterprise_id", "in": "query", "schema": { "type": "string" }, "example": "31232", "description": "メタデータカスケードポリシーを検索するEnterprise ID。指定されていない場合は、デフォルトで現在のEnterpriseに設定されます。" }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "メタデータカスケードポリシーのリストを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataCascadePolicies" } } } }, "400": { "description": "パラメータのいずれかが有効な形式でない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "フォルダにアクセスできない場合にエラーを返します。このエラーは、IDが`0`のルートフォルダにアクセスした場合によく発生します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合はエラーを返します。\n\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_metadata_cascade_policies", "summary": "メタデータカスケードポリシーを作成", "tags": [ "メタデータカスケードポリシー" ], "x-box-tag": "metadata_cascade_policies", "x-box-sanitized": true, "description": "指定したメタデータテンプレートを指定したフォルダに適用し、そのフォルダ内のすべてのファイルに自動的にカスケードする新しいメタデータカスケードポリシーを作成します。\n\nポリシーを適用するには、まず、ポリシーの適用先となるフォルダにメタデータインスタンスを適用する必要があります。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "folder_id", "scope", "templateKey" ], "properties": { "folder_id": { "type": "string", "description": "ポリシーを適用するフォルダのID。このフォルダには、ターゲットメタデータテンプレートのインスタンスがすでに適用されている必要があります。", "example": "1234567" }, "scope": { "description": "ターゲットメタデータテンプレートのスコープ。このテンプレートでは、ターゲットフォルダにすでにインスタンスが適用されている必要があります。", "example": "enterprise", "type": "string", "enum": [ "global", "enterprise" ] }, "templateKey": { "type": "string", "example": "productInfo", "description": "ターゲットメタデータテンプレートのキー。このテンプレートでは、ターゲットフォルダにすでにインスタンスが適用されている必要があります。\n\n多くの場合、テンプレートキーはその表示名から自動的に派生します。たとえば、`Contract Template`の場合は`contractTemplate`となります。場合によっては、テンプレートの作成者が独自のテンプレートキーを指定することもあります。\n\nテンプレートのキーを調べるには、[会社のテンプレートのリストを取得する][list]か、[ファイル][file]または[フォルダ][folder]上のすべてのインスタンスを取得してください。\n\n[list]: e://get-metadata-templates-enterprise\n\n[file]: e://get-files-id-metadata\n\n[folder]: e://get-folders-id-metadata" } } } } } }, "responses": { "201": { "description": "新しいメタデータカスケードポリシーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataCascadePolicy" } } } }, "400": { "description": "パラメータのいずれかが有効な形式でない場合はエラーを返します。\n\n* `bad_request` - `scope`、`templateKey`、または`folder_id`が有効な形式ではありません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "制限されたフォルダ (IDが`0`のルートフォルダなど) にポリシーを適用しようとした場合にエラーを返します。\n\n* `forbidden` - フォルダIDが有効で、ユーザーはこのフォルダにアクセスできますが、ポリシーをこのフォルダに割り当てられませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "テンプレートまたはフォルダが見つからないか、ユーザーがフォルダまたはテンプレートにアクセスできない場合はエラーを返します。\n\n* `instance_tuple_not_found` - テンプレートが見つからないか、ユーザーがテンプレートにアクセスできません。\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "このフォルダとテンプレートのポリシーがすでに設定されている場合はエラーを返します。\n\n* `tuple_already_exists` - この`folder_id`、`scope`、および`templateKey`の組み合わせのカスケードポリシーがすでに存在する場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_cascade_policies/{metadata_cascade_policy_id}": { "get": { "operationId": "get_metadata_cascade_policies_id", "summary": "メタデータカスケードポリシーを取得", "tags": [ "メタデータカスケードポリシー" ], "x-box-tag": "metadata_cascade_policies", "x-box-sanitized": true, "description": "フォルダに割り当てられた特定のメタデータカスケードポリシーを取得します。", "parameters": [ { "name": "metadata_cascade_policy_id", "description": "メタデータカスケードポリシーのID。", "example": "6fd4ff89-8fc1-42cf-8b29-1890dedd26d7", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "メタデータカスケードポリシーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataCascadePolicy" } } } }, "404": { "description": "ポリシーが見つからないか、ユーザーがフォルダにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - ポリシーが見つかりませんでした。\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_metadata_cascade_policies_id", "summary": "メタデータカスケードポリシーを削除", "tags": [ "メタデータカスケードポリシー" ], "x-box-tag": "metadata_cascade_policies", "x-box-sanitized": true, "description": "メタデータカスケードポリシーを削除します。", "parameters": [ { "name": "metadata_cascade_policy_id", "description": "メタデータカスケードポリシーのID。", "example": "6fd4ff89-8fc1-42cf-8b29-1890dedd26d7", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ポリシーが正常に削除された場合は、空のレスポンスを返します。" }, "404": { "description": "ポリシーが見つからないか、ユーザーがフォルダにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - ポリシーが見つかりませんでした。\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_cascade_policies/{metadata_cascade_policy_id}/apply": { "post": { "operationId": "post_metadata_cascade_policies_id_apply", "summary": "フォルダにメタデータカスケードポリシーを強制適用", "tags": [ "メタデータカスケードポリシー" ], "x-box-tag": "metadata_cascade_policies", "x-box-sanitized": true, "description": "メタデータカスケードポリシーを持つフォルダのメタデータをそのすべての子に強制的に適用します。これは、新しいカスケードポリシーの作成後、そのフォルダ内にある既存のすべてのファイルにカスケードされるメタデータを適用するのに使用できます。", "parameters": [ { "name": "metadata_cascade_policy_id", "required": true, "in": "path", "schema": { "type": "string" }, "description": "強制的に適用するカスケードポリシーのID。", "example": "6fd4ff89-8fc1-42cf-8b29-1890dedd26d7" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "conflict_resolution" ], "properties": { "conflict_resolution": { "type": "string", "enum": [ "none", "overwrite" ], "description": "メタデータテンプレートですでにインスタンスが子に適用されているという競合に対処する際の最適な動作を説明します。\n\n* `none`を指定すると、ファイルの既存の値が保持されます。\n* `overwrite`を指定すると、既存の値を無視してテンプレートの値が強制的に適用されます。", "example": "none" } } } } } }, "responses": { "202": { "description": "APIコールが成功した場合は空のレスポンスを返します。メタデータのカスケード操作は非同期的に実行されます。\n\nAPIコールは、カスケード操作が完了していなくても直ちに復帰します。現時点では、この操作のステータスを確認するためのAPIはありません。" }, "404": { "description": "ポリシーが見つからないか、ユーザーがフォルダにアクセスできない場合はエラーを返します。\n\n* `instance_not_found` - ポリシーが見つかりませんでした。\n* `not_found` - フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/metadata_queries/execute_read": { "post": { "operationId": "post_metadata_queries_execute_read", "summary": "メタデータによるファイル/フォルダに対するクエリ", "tags": [ "検索" ], "x-box-tag": "search", "x-box-sanitized": true, "x-box-enable-explorer": true, "description": "SQLに似た構文で特定のメタデータと一致する項目を返す検索を作成します。\n\nデフォルトでは、このエンドポイントによって、クエリに一致する項目に関する最も基本的な情報のみが返されます。各項目のその他のフィールド (メタデータのいずれかを含む) を取得するには、クエリで`fields`属性を使用します。", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataQuery" } } } }, "responses": { "200": { "description": "このメタデータクエリと一致するファイルおよびフォルダのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataQueryResults" } } } }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `invalid_query` - 指定した本文パラメータのいずれかが正しくない可能性があります。これは、`query`に誤りがあることと、`from`値が有効なテンプレートを表していない場合があることを意味します。\n* `unexpected_json_type` - `query`文字列からの引数が`query_param`に存在しません。たとえば、`name = :name`の`query`では、`{ \"name\": \"Box, Inc\" }`のように、`query_param`に`name`引数の値を含める必要があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定された`scope`と`templateKey`のメタデータテンプレートが見つからない場合にエラーを返します。エラーレスポンスには追加の詳細が含まれます。\n\n* `instance_not_found` - テンプレートが見つからなかった場合に返されます。Enterprise ID (`enterprise_12345`など) を含むテンプレート全体のスコープを必ず使用してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/comments/{comment_id}": { "get": { "operationId": "get_comments_id", "summary": "コメントを取得", "tags": [ "Comments" ], "x-box-tag": "comments", "description": "特定のコメントのメッセージとメタデータに加え、コメントを作成したユーザーに関する情報を取得します。", "parameters": [ { "name": "comment_id", "description": "コメントのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "Full版のコメントオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Comment--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_comments_id", "summary": "コメントを更新", "tags": [ "Comments" ], "x-box-tag": "comments", "description": "コメントのメッセージを更新します。", "parameters": [ { "name": "comment_id", "description": "コメントのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "更新するコメントのテキスト", "example": "Review completed!" } } } } } }, "responses": { "200": { "description": "更新されたコメントオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Comment--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_comments_id", "summary": "コメントを削除", "tags": [ "Comments" ], "x-box-tag": "comments", "description": "コメントを完全に削除します。", "parameters": [ { "name": "comment_id", "description": "コメントのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "コメントが削除された場合は、空のレスポンスを返します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/comments": { "post": { "operationId": "post_comments", "tags": [ "Comments" ], "x-box-tag": "comments", "summary": "コメントを作成", "description": "ユーザーによるコメントを特定のファイルに追加するか、他のコメントへの返信として追加します。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "message", "item" ], "properties": { "message": { "type": "string", "description": "コメントのテキスト。\n\n特定のユーザーをメンションするには、 代わりに`tagged_message`パラメータを使用します。", "example": "Review completed!" }, "tagged_message": { "type": "string", "description": "メッセージ内のどこかで`@[user_id:name]`を使用して他のユーザーをメンションしているコメントのテキスト。メンションされたユーザーには、メンションされたことを知らせるメール通知が送信されます。\n\n`user_id`はターゲットユーザーのIDで、`name`には任意のカスタムフレーズを使用できます。Box UIでは、この名前がユーザーのプロフィールにリンクされます。\n\n他のユーザーをメンションしていない場合は、代わりに`message`を使用します。", "example": "@[1234:John] Review completed!" }, "item": { "type": "object", "description": "コメントを追加する項目。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "項目のID", "example": "11446498" }, "type": { "type": "string", "description": "このコメントが追加される項目の種類。", "example": "file", "enum": [ "file", "comment" ] } } } } } } } }, "responses": { "201": { "description": "新しく作成されたコメントオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、[fields](#param-fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Comment--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collaborations/{collaboration_id}": { "get": { "operationId": "get_collaborations_id", "summary": "コラボレーションを取得", "x-box-tag": "user_collaborations", "tags": [ "Collaborations" ], "description": "1つのコラボレーションを取得します。", "parameters": [ { "name": "collaboration_id", "description": "コラボレーションのID", "in": "path", "required": true, "example": "1234", "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "コラボレーションオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaboration" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_collaborations_id", "tags": [ "Collaborations" ], "x-box-tag": "user_collaborations", "summary": "コラボレーションを更新", "description": "コラボレーションを更新します。項目の所有者を変更したり、コラボレーションへの招待を承認したりする場合に使用します。", "parameters": [ { "name": "collaboration_id", "description": "コラボレーションのID", "in": "path", "required": true, "example": "1234", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "role" ], "properties": { "role": { "type": "string", "description": "付与されるアクセスレベル。", "example": "editor", "enum": [ "editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner", "owner" ] }, "status": { "type": "string", "description": "\n\nコラボレーション招待のステータスとして、保留中 (`pending`)、承認、拒否のいずれかを設定します。", "example": "accepted", "enum": [ "pending", "accepted", "rejected" ] }, "expires_at": { "type": "string", "format": "date-time", "description": "コラボレーションの有効期限を更新します。この日付になると、項目から自動的にコラボレーションが削除されます。\n\nこの機能が動作するのは、**管理コンソール**の \\[**Enterprise設定**] で **\\[招待したコラボレータを自動的に削除する] の \\[フォルダの所有者に有効期限の延長を許可する]** の設定が有効になっている場合のみです。この設定が有効になっていない場合、コラボレーションに有効期限を設定できず、このフィールドの値によってエラーが返されます。\n\nさらに、コラボレーションに有効期限を指定できるのは、**\\[招待したコラボレータを自動的に削除する]** の設定を有効にした後に作成した場合のみです。", "example": "2019-08-29T23:59:00-07:00" }, "can_view_path": { "type": "boolean", "description": "招待されたユーザーが招待に関連付けられているフォルダへの親パス全体を見ることができるかどうかを示します。招待されたユーザーには親フォルダ内の権限が付与されないため、自身が参加しているコラボレーションに関係しないコンテンツを閲覧することはできません。\n\nこれにより、招待されたユーザーの \\[**すべてのファイル**] ページの読み込みに必要な時間が有意に増加することに注意してください。`can_view_path`が有効になっているコラボレーションの数を1ユーザーあたり1,000に制限することをお勧めします。\n\n`can_view_path`が`true`に設定されているコラボレータを招待できるのは、所有者と共同所有者のみです。\n\n`can_view_path`は、フォルダのコラボレーションのみに使用できます。", "example": true } } } } } }, "responses": { "200": { "description": "所有者が変わっていない限り、更新されたコラボレーションオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaboration" } } } }, "204": { "description": "ロールが`owner`に変更されるとコラボレーションが削除されて、新しいコラボレーションが作成されます。古いコラボレーションの`owner`は、新しいコラボレーションの`co-owner`になります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaboration" } } } }, "403": { "description": "認証済みユーザーにコラボレーションを更新するための適切な権限がない場合にエラーを返します。\n\nさらに、このエラーは、企業の管理ダッシュボードで **\\[招待したコラボレータを自動的に削除する] の \\[フォルダの所有者に有効期限の延長を許可する]** の設定が有効になっていないコラボレーションの`expires_at`フィールドを更新しようとすると発生する可能性があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_collaborations_id", "summary": "コラボレーションを削除", "tags": [ "Collaborations" ], "x-box-tag": "user_collaborations", "description": "1つのコラボレーションを削除します。", "parameters": [ { "name": "collaboration_id", "description": "コラボレーションのID", "in": "path", "required": true, "example": "1234", "schema": { "type": "string" } } ], "responses": { "204": { "description": "コラボレーションが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collaborations": { "get": { "operationId": "get_collaborations", "summary": "保留中のコラボレーションのリストを取得", "tags": [ "コラボレーション (リスト)" ], "x-box-tag": "list_collaborations", "description": "このユーザーに関連する保留中のコラボレーション招待をすべて取得します。", "parameters": [ { "name": "status", "description": "取得するコラボレーションのステータス", "in": "query", "required": true, "example": "pending", "schema": { "type": "string", "enum": [ "pending" ] } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "保留中のコラボレーションオブジェクトのコレクションを返します。\n\nユーザーに保留中のコラボレーションがない場合、このコレクションは空になります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaborations" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_collaborations", "tags": [ "Collaborations" ], "x-box-tag": "user_collaborations", "summary": "コラボレーションを作成", "description": "ファイルまたはフォルダに個々のユーザーまたはグループのコラボレーションを追加します。\n\nコラボレーションは、メールアドレス、ユーザーID、またはグループIDを使用して作成できます。\n\nグループを使用してコラボレーションを作成する場合、このエンドポイントにアクセスできるかどうかは、そのグループを招待できるかどうかによって決まります。\n\nコラボレーションが`pending`ステータスの場合、以下のフィールドが編集されます。\n\n* `user_id`を使用してコラボレーションが作成された場合、`login`と`name`は非表示になります。\n* `login`を使用してコラボレーションが作成された場合、`name`は非表示になります。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "notify", "description": "実行されたアクションについてのメール通知をユーザーに送信するかどうかを決定します。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "item", "accessible_by", "role" ], "properties": { "item": { "type": "object", "description": "コメントを追加する項目。", "properties": { "type": { "type": "string", "description": "このコラボレーションでアクセス権限が付与される項目の種類", "example": "file", "enum": [ "file", "folder" ] }, "id": { "type": "string", "description": "アクセス権限が付与される項目のID", "example": "11446498" } } }, "accessible_by": { "type": "object", "description": "その項目に対するアクセス権限を付与するユーザーまたはグループ。", "required": [ "type" ], "properties": { "type": { "type": "string", "description": "招待するコラボレータのタイプ。", "example": "user", "enum": [ "user", "group" ] }, "id": { "type": "string", "description": "ユーザーまたはグループのID。\n\n`login`を使用してメールアドレスでユーザーを指定することもできます。", "example": "23522323" }, "login": { "type": "string", "description": "項目に対するアクセス権限を付与するユーザーのメールアドレス。\n\n`id`を使用してユーザーIDでユーザーを指定することもできます。", "example": "john@example.com" } } }, "role": { "type": "string", "description": "付与されるアクセスレベル。", "example": "editor", "enum": [ "editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner" ] }, "is_access_only": { "type": "boolean", "example": true, "description": "`true`に設定した場合、コラボレータは共有項目にアクセスできますが、これらの項目は \\[すべてのファイル] リストに表示されません。また、コラボレータには共有項目のルートフォルダのパスも表示されません。" }, "can_view_path": { "type": "boolean", "description": "招待されたユーザーが招待に関連付けられているフォルダへの親パス全体を見ることができるかどうかを示します。招待されたユーザーには親フォルダ内の権限が付与されないため、自身が参加しているコラボレーションに関係しないコンテンツを閲覧することはできません。\n\nこれにより、招待されたユーザーの \\[**すべてのファイル**] ページの読み込みに必要な時間が有意に増加することに注意してください。`can_view_path`が有効になっているコラボレーションの数を1ユーザーあたり1,000に制限することをお勧めします。\n\n`can_view_path`が`true`に設定されているコラボレータを招待できるのは、所有者と共同所有者のみです。\n\n`can_view_path`は、フォルダのコラボレーションのみに使用できます。", "example": true }, "expires_at": { "type": "string", "format": "date-time", "description": "コラボレーションの有効期限を設定します。この日付になると、項目から自動的にコラボレーションが削除されます。\n\nこの機能が動作するのは、**管理コンソール**の \\[**Enterprise設定**] で **\\[招待したコラボレータを自動的に削除する] の \\[フォルダの所有者に有効期限の延長を許可する]** の設定が有効になっている場合のみです。この設定が有効になっていない場合、コラボレーションに有効期限を設定できず、このフィールドの値によってエラーが返されます。", "example": "2019-08-29T23:59:00-07:00" } } } } } }, "responses": { "201": { "description": "新しいコラボレーションオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaboration" } } } }, "403": { "description": "ユーザーにコラボレーションを作成するための適切な権限がない場合にエラーを返します。\n\n* `forbidden_by_policy`: 情報バリアの制限によりコラボレーションの作成が禁止されています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/search": { "get": { "operationId": "get_search", "summary": "コンテンツを検索", "tags": [ "検索" ], "x-box-tag": "search", "x-box-enable-explorer": true, "description": "ユーザーのコンテンツまたは会社全体でファイル、フォルダ、ウェブリンク、および共有ファイルを検索します。", "parameters": [ { "name": "query", "description": "検索する文字列。このクエリは、項目名、説明、ファイルのテキストコンテンツなど、さまざまな項目タイプのフィールドと照合されます。\n\nこのパラメータでは、返された結果をさらに絞り込むためのさまざまな演算子がサポートされます。\n\n* `\"\"` - クエリを二重引用符で囲むと、APIによって完全一致のみが返されます。完全一致検索では、特定の文字の並びに基づいた検索結果は返されません。代わりに、フレーズ (つまり、単語の並び) に基づいた一致が返されます。たとえば、`\"Blue-Box\"`を検索すると、`\"blue.box\"`、`\"Blue Box\"`、`\"Blue-Box\"`などの並びを含む、検索結果が返されます。つまり、`Blue`および`Box`という単語が指定した順序で連続して含まれている項目です。\n* `AND` - 両方の検索語を含む項目が返されます。たとえば、`marketing AND BoxWorks`を検索すると、`marketing`と`BoxWorks`の両方が任意の順番でテキストに含まれている項目が返されます。テキストに`BoxWorks`のみが含まれる結果は返されません。\n* `OR` - 検索語のいずれかを含む項目が返されます。たとえば、`marketing OR BoxWorks`を検索すると、`marketing`と`BoxWorks`のいずれかがテキストに含まれている結果が返されます。サポートされている別のブール条件が使用されている場合を除き、複数語のクエリは暗黙的に`OR`として解釈されるため、この演算子の使用は必須ではありません。\n* `NOT` - 指定された検索語が含まれていない項目が返されます。たとえば、`marketing AND NOT BoxWorks`を検索すると、テキストに`marketing`のみが含まれている結果が返され、`BoxWorks`が含まれる結果は省略されます。\n\n小文字の演算子 (`and`、`or`および`not`) および大文字と小文字を組み合わせた演算子 (`And`、`Or`および`Not`) はサポートされていません。\n\nこのフィールドは、`mdfilters`パラメータが定義されていない場合に必須です。", "in": "query", "required": false, "example": "sales", "schema": { "type": "string" } }, { "name": "scope", "description": "ユーザーがアクセスできるファイルまたは会社全体で利用可能なファイルに検索結果を絞り込みます。\n\nスコープは、デフォルトで`user_content`に設定されます。これにより、検索結果は、現在認証されているユーザーが使用できるコンテンツに絞り込まれます。\n\n`enterprise_content`は、管理者がサポートチャネルを通じてリクエストできます。このスコープがユーザーに対して有効になっていると、そのユーザーは、アクセスできるコンテンツだけでなく、会社全体のコンテンツに対してクエリを実行できます。", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "user_content", "enterprise_content" ], "default": "user_content" }, "example": "user_content" }, { "name": "file_extensions", "description": "指定したファイル拡張子のいずれかと一致するファイルのみに検索結果を絞り込みます。このリストは、ドットなしのファイル拡張子のコンマ区切りリストです。", "example": [ "pdf", "png", "gif" ], "in": "query", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "created_at_range", "description": "指定した日付範囲内に作成されたすべての項目に検索結果を絞り込みます。\n\n日付範囲はコンマ区切りのRFC3339タイムスタンプとして定義されます。\n\n開始日が省略されている場合 (`,2014-05-17T13:35:01-07:00`)、終了日より前に作成された項目がすべて返されます。\n\n終了日が省略されている場合 (`2014-05-15T13:35:01-07:00,`)、代わりに現在の日付が終了日として使用されます。", "example": [ "2014-05-15T13:35:01-07:00", "2014-05-17T13:35:01-07:00" ], "in": "query", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "updated_at_range", "description": "指定した日付範囲内に更新された項目に検索結果を絞り込みます。\n\n日付範囲はコンマ区切りのRFC3339タイムスタンプとして定義されます。\n\n開始日が省略されている場合 (`,2014-05-17T13:35:01-07:00`)、終了日より前に更新された項目が返されます。\n\n終了日が省略されている場合 (`2014-05-15T13:35:01-07:00,`)、代わりに現在の日付が終了日として使用されます。", "example": [ "2014-05-15T13:35:01-07:00", "2014-05-17T13:35:01-07:00" ], "in": "query", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "size_range", "description": "特定のファイルサイズ範囲内のサイズの項目に検索結果を絞り込みます。これはファイルとフォルダに適用されます。\n\nサイズ範囲は、バイトサイズの下限と上限 (下限と上限も含む) のコンマ区切りリストとして定義します。\n\n上限または下限を省略すると、上限または下限のないサイズ範囲を指定できます。", "example": [ 1000000, 5000000 ], "in": "query", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "owner_user_ids", "description": "指定した所有者リスト (ユーザーIDのコンマ区切りリストとして定義) によって所有される項目のみに検索結果を絞り込みます。\n\n検索結果に項目が表示されるように、項目は現在認証されているユーザーによって所有または共有されている必要もあります。いずれかのユーザーが所有するファイルにユーザーがアクセスできない場合は、空の結果セットが返されます。\n\n会社全体で検索するには、サポートチームにリクエスト可能な`enterprise_content`スコープパラメータを使用することをお勧めします。", "example": [ "123422", "23532", "3241212" ], "in": "query", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "recent_updater_user_ids", "description": "指定したユーザーリスト (ユーザーIDのコンマ区切りリストとして定義) によって更新された項目のみに検索結果を絞り込みます。\n\n検索結果に項目が表示されるように、項目は現在認証されているユーザーによって所有または共有されている必要もあります。いずれかのユーザーが所有するファイルにユーザーがアクセスできない場合は、空の結果セットが返されます。\n\nこの機能では、項目の過去10バージョンのみを検索します。", "example": [ "123422", "23532", "3241212" ], "in": "query", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "ancestor_folder_ids", "description": "フォルダIDのコンマ区切りリストとして定義された、指定したフォルダリスト内の項目のみに検索結果を絞り込みます。\n\n検索結果には、これらの先祖フォルダのサブフォルダ内の項目も含まれます。\n\nフォルダは現在認証されているユーザーによって所有または共有されている必要もあります。このユーザーがフォルダにアクセスできない場合、またはフォルダがない場合は、代わりに`HTTP 404`エラーコードが返されます。\n\n会社全体で検索するには、サポートチームにリクエスト可能な`enterprise_content`スコープパラメータを使用することをお勧めします。", "explode": false, "example": [ "4535234", "234123235", "2654345" ], "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "content_types", "description": "ファイルの説明など、ファイルの特定の部分に対する検索クエリと一致する項目のみに検索結果を絞り込みます。\n\nコンテンツタイプの定義には、Boxで認識されるコンテンツタイプのコンマ区切りリストを使用します。許可されるコンテンツタイプは以下のとおりです。\n\n* `name` - `name`フィールドで定義されている、項目の名前。\n* `description` - `description`フィールドで定義されている、項目の説明。\n* `file_content` - ファイルの実際のコンテンツ。\n* `comments` - ファイルまたはフォルダに対するコメントのコンテンツ。\n* `tags` - `tags`フィールドで定義されている、項目に適用されるタグ。", "in": "query", "example": [ "name", "description" ], "explode": false, "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "name", "description", "file_content", "comments", "tag" ] } } }, { "name": "type", "description": "このタイプの項目に検索結果を絞り込みます。このパラメータが受け取る値は1つだけです。デフォルトでは、このAPIによって、以下のいずれかのタイプと一致する項目が返されます。\n\n* `file` - 検索結果をファイルに絞り込みます。\n* `folder` - 検索結果をフォルダに絞り込みます。\n* `web_link` - 検索結果をウェブリンク (ブックマークとも呼ばれます) に絞り込みます。", "example": "file", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "file", "folder", "web_link" ] } }, { "name": "trash_content", "description": "検索時にごみ箱で項目を探すかどうかを決定します。\n\nデフォルトでは、このAPIで返されるのは、現在ごみ箱にない項目の検索結果のみです (`non_trashed_only`)。\n\n* `trashed_only` - 現在ごみ箱にある項目のみを検索します。\n* `non_trashed_only` - 現在ごみ箱にない項目のみを検索します。\n* `all_items` - ごみ箱内の項目とごみ箱にない項目の両方を検索します。", "in": "query", "required": false, "example": "non_trashed_only", "schema": { "type": "string", "default": "non_trashed_only", "enum": [ "non_trashed_only", "trashed_only", "all_items" ] } }, { "name": "mdfilters", "description": "指定したフィルタとメタデータが一致する項目のみに検索結果を絞り込みます。\n\nこのパラメータには、検索結果のフィルタに使用される1つのメタデータテンプレートのリストが含まれます。現在、このリストには現在1つのエントリしかを含めることができませんが、今後拡張される可能性があります。\n\nこのパラメータは、`query`パラメータが指定されていない場合に必須です。", "in": "query", "example": [ { "scope": "enterprise", "templateKey": "contract", "filters": { "category": "online" } } ], "x-example": [ { "scope": "enterprise", "templateKey": "contract", "filters": { "category": "online", "contractValue": 1000000 } } ], "required": false, "schema": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "検索結果のフィルタに使用するメタデータテンプレートのリスト。\n\n`query`パラメータが定義されていない場合は必須です。" } }, { "name": "sort", "description": "結果が返される順序を定義します。このパラメータが明示的に指定されていない限り、このAPIはデフォルトで、関連度を基準として項目を返します。\n\n* `relevance` (デフォルト) を指定すると、クエリの検索語との関連度を基準として並べ替えられた結果が返されます。関連度は、項目の名前、説明、コンテンツ、およびその他のプロパティでの検索語の出現回数に基づきます。\n* `modified_at`を指定すると、項目が最後に変更された日付を基準にして降順で並べ替えられた結果が返されます。", "in": "query", "required": false, "schema": { "type": "string", "default": "relevance", "enum": [ "modified_at", "relevance" ] }, "example": "modified_at" }, { "name": "direction", "description": "検索結果の並べ替えの方向を定義します。このパラメータが明示的に指定されていない限り、このAPIはデフォルトで、降順 (`DESC`) で項目を返します。\n\n結果が`relevance`を基準にして並べ替えられると、関連度の降順で項目が返されるよう並べ替えはロックされ、このパラメータは無視されます。", "in": "query", "required": false, "schema": { "type": "string", "default": "DESC", "enum": [ "DESC", "ASC" ] }, "example": "ASC" }, { "name": "limit", "description": "結果ページの一部として返す項目の最大数を定義します。", "in": "query", "required": false, "example": 100, "schema": { "type": "integer", "format": "int64", "default": 30, "maximum": 200 } }, { "name": "include_recent_shared_links", "description": "ユーザーが最近共有リンクを介してアクセスした項目を検索結果に含めるかどうかを定義します。\n\nこのパラメータがtrueに設定されている場合は、[共有リンクを含む検索結果](r://search_results_with_shared_links)のリストを返すよう、このAPIのレスポンス形式が変更されます。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean", "default": false } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "deleted_user_ids", "description": "指定したユーザーリスト (ユーザーIDのコンマ区切りリストとして定義) によって削除された項目に検索結果を絞り込みます。\n\n`trash_content`パラメータは`trashed_only`に設定する必要があります。\n\nごみ箱内検索が実行されていない場合は、空の結果セットが返されます。検索結果に項目が表示されるように、項目は現在認証されているユーザーによって所有または共有されている必要があります。\n\nいずれかのユーザーが所有するファイルにユーザーがアクセスできない場合は、空の結果セットが返されます。\n\n2023年2月1日以降利用できるデータです。", "example": [ "123422", "23532", "3241212" ], "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "deleted_at_range", "description": "指定した日付範囲内に削除されたすべての項目に検索結果を絞り込みます。\n\n日付範囲はコンマ区切りのRFC3339タイムスタンプとして定義されます。\n\n開始日が省略されている場合 (`2014-05-17T13:35:01-07:00`)、終了日より前に削除された項目がすべて返されます。\n\n終了日が省略されている場合 (`2014-05-15T13:35:01-07:00`)、代わりに現在の日付が終了日として使用されます。\n\n`trash_content`パラメータは`trashed_only`に設定する必要があります。\n\nごみ箱内検索が実行されていない場合は、空の結果が返されます。\n\n2023年2月1日以降利用できるデータです。", "example": [ "2014-05-15T13:35:01-07:00", "2014-05-17T13:35:01-07:00" ], "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "検索結果のコレクションを返します。一致する検索結果がない場合、`entries`配列は空になります。", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SearchResults" }, { "$ref": "#/components/schemas/SearchResultsWithSharedLinks" } ] } } } }, "400": { "description": "リクエストが無効だった場合にエラーを返します。これには、複数の理由があり、`context_info`オブジェクトによって詳細が示されます。\n\n* `missing_parameter` - 検索で少なくとも`query`または`mdfilters`クエリパラメータを指定してください。\n* `invalid_parameter` - いずれかのフィールドの形式に誤りがある可能性があります。たとえば、RFC3339日付のいずれかが正しくないか、整数が想定されている場所に文字列が指定されることを意味します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "このAPIコールを行う権限がユーザーにない場合にエラーを返します。\n\n* 開発者は、`scope`として`enterprise_content`を指定しましたが、Boxのサポートチャネルを通じて、このスコープをユーザーに対して有効にするようリクエストしませんでした。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ユーザーが、リクエストで取り上げられた項目にアクセスできない場合にエラーを返します。\n\n* 開発者は、存在しないフォルダIDまたはユーザーがアクセスできないフォルダIDを`ancestor_folder_ids`で指定しました。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/tasks": { "post": { "operationId": "post_tasks", "tags": [ "Tasks" ], "summary": "タスクを作成", "x-box-tag": "tasks", "x-box-sanitized": true, "description": "ファイルに対する1個のタスクを作成します。このタスクはいずれのユーザーにも割り当てられていないため、個別に割り当てる必要があります。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "item" ], "properties": { "item": { "type": "object", "description": "タスクを添付するファイル。", "properties": { "id": { "type": "string", "description": "ファイルのID", "example": "11446498" }, "type": { "type": "string", "description": "`file`", "example": "file", "enum": [ "file" ] } } }, "action": { "type": "string", "description": "タスク担当者が実行を求められるアクション。次のいずれかを指定する必要があります。\n\n* `review` - 承認または拒否できる承認タスクを定義します\n* `complete` - 完了できる一般タスクを定義します", "example": "review", "default": "review", "enum": [ "review", "complete" ] }, "message": { "type": "string", "default": "", "description": "タスクに含めるメッセージ (省略可)。", "example": "Please review" }, "due_at": { "type": "string", "format": "date-time", "description": "タスクの期限を定義します。指定しない場合は、デフォルトで`null`に設定されます。", "example": "2012-12-12T10:53:43-08:00" }, "completion_rule": { "type": "string", "description": "タスクが完了と見なされる前にそのタスクを完了する必要がある担当者を定義します。\n\n* `all_assignees` (デフォルト) - タスクが完了と見なされるには、すべての担当者がそのタスクをレビューまたは承認する必要があります。\n* `any_assignee` - いずれか1人の担当者がタスクをレビューまたは承認すれば、タスクが完了と見なされます。", "example": "all_assignees", "default": "all_assignees", "enum": [ "all_assignees", "any_assignee" ] } } } } } }, "responses": { "201": { "description": "新しく作成されたタスクを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } } }, "400": { "description": "リクエストのパラメータまたは本文が無効な場合に返されます。\n\n* `bad_request` - 本文に有効なリクエストが含まれていない場合に返されます。これは、`action`または`completion_rule`が許可された値のいずれでもないことが原因である可能性があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ファイルに対するタスクを作成する権限がユーザーにない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/tasks/{task_id}": { "get": { "operationId": "get_tasks_id", "summary": "タスクを取得", "tags": [ "Tasks" ], "x-box-tag": "tasks", "x-box-sanitized": true, "description": "特定のタスクに関する情報を取得します。", "parameters": [ { "name": "task_id", "description": "タスクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "タスクオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } } }, "404": { "description": "タスクが見つからなかった場合、またはタスクが割り当てられているファイルにユーザーがアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_tasks_id", "tags": [ "Tasks" ], "summary": "タスクを更新", "x-box-tag": "tasks", "x-box-sanitized": true, "description": "タスクを更新します。これは、タスクの構成を更新するため、またはその完了状態を更新するために使用できます。", "parameters": [ { "name": "task_id", "description": "タスクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "description": "タスク担当者が実行を求められるアクション。次のいずれかを指定する必要があります。\n\n* `review` - 承認または拒否できる承認タスクを定義します\n* `complete` - 完了できる一般タスクを定義します", "example": "review", "enum": [ "review", "complete" ] }, "message": { "type": "string", "description": "タスクに含まれるメッセージ。", "example": "Please review" }, "due_at": { "type": "string", "format": "date-time", "description": "タスクの期限。", "example": "2012-12-12T10:53:43-08:00" }, "completion_rule": { "type": "string", "description": "タスクが完了と見なされる前にそのタスクを完了する必要がある担当者を定義します。\n\n* `all_assignees` (デフォルト) - タスクが完了と見なされるには、すべての担当者がそのタスクをレビューまたは承認する必要があります。\n* `any_assignee` - いずれか1人の担当者がタスクをレビューまたは承認すれば、タスクが完了と見なされます。", "example": "all_assignees", "enum": [ "all_assignees", "any_assignee" ] } } } } } }, "responses": { "200": { "description": "更新されたタスクオブジェクトを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } } }, "400": { "description": "リクエストのパラメータまたは本文が無効な場合に返されます。\n\n* `bad_request` - 本文に有効なリクエストが含まれていない場合に返されます。これは、`action`または`completion_rule`が許可された値のいずれでもないことが原因である可能性があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ファイルに関するタスクを更新する権限がユーザーにない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_tasks_id", "tags": [ "Tasks" ], "summary": "タスクを削除", "x-box-tag": "tasks", "x-box-sanitized": true, "description": "ファイルからタスクを削除します。", "parameters": [ { "name": "task_id", "description": "タスクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "タスクが正常に削除された場合は、空のレスポンスを返します。" }, "404": { "description": "タスクが見つからなかった場合、またはタスクが割り当てられているファイルにユーザーがアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/tasks/{task_id}/assignments": { "get": { "operationId": "get_tasks_id_assignments", "summary": "タスク割り当てのリストを取得", "tags": [ "タスク割り当て" ], "x-box-tag": "task_assignments", "x-box-sanitized": true, "description": "指定したタスクのすべての割り当てのリストを取得します。", "parameters": [ { "name": "task_id", "description": "タスクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルに対するどのようなタスクを誰が誰に割り当てているかを定義するタスク割り当てのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAssignments" } } } }, "404": { "description": "タスクが見つからなかった場合、またはタスクが割り当てられているファイルにユーザーがアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "リクエストでタスク割り当てIDが省略されている場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/task_assignments": { "post": { "operationId": "post_task_assignments", "summary": "タスクを割り当て", "tags": [ "タスク割り当て" ], "x-box-tag": "task_assignments", "x-box-sanitized": true, "description": "ユーザーにタスクを割り当てます。\n\n複数の割り当てを作成することで、1つのタスクを複数のユーザーに割り当てることができます。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "task", "assign_to" ], "properties": { "task": { "type": "object", "description": "ユーザーに割り当てるタスク。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "タスクのID", "example": "11446498" }, "type": { "type": "string", "description": "割り当てる項目の種類。", "example": "task", "enum": [ "task" ] } } }, "assign_to": { "type": "object", "description": "タスクを割り当てるユーザー。", "properties": { "id": { "type": "string", "description": "タスクに割り当てるユーザーのID。\n\nメールアドレスでユーザーを指定するには、`login`パラメータを使用します。", "example": "3242343" }, "login": { "type": "string", "description": "タスクに割り当てるユーザーのメールアドレス。ユーザーIDを使用してユーザーを指定するには、`id`パラメータを使用します。", "example": "john@example.com" } } } } } } } }, "responses": { "201": { "description": "新しいタスク割り当てオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAssignment" } } } }, "403": { "description": "完了したタスクに対して変更が試行された場合、または指定されたタスク割り当てのタスクにリンクされた項目にユーザーがアクセスできない場合に、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "タスクが見つからない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "このリクエストのIDのいずれかが無効である場合、またはターゲットユーザーがファイルにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/task_assignments/{task_assignment_id}": { "get": { "operationId": "get_task_assignments_id", "summary": "タスク割り当てを取得", "tags": [ "タスク割り当て" ], "x-box-tag": "task_assignments", "x-box-sanitized": true, "description": "タスク割り当てに関する情報を取得します。", "parameters": [ { "name": "task_assignment_id", "description": "タスク割り当てのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "タスクが割り当てられているユーザーとタスクを割り当てたユーザーを示す、タスク割り当てを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAssignment" } } } }, "404": { "description": "タスク割り当てが見つからない場合、またはタスクが割り当てられているファイルにユーザーがアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_task_assignments_id", "summary": "タスク割り当てを更新", "tags": [ "タスク割り当て" ], "x-box-tag": "task_assignments", "x-box-sanitized": true, "description": "タスク割り当てを更新します。このエンドポイントは、ユーザーに割り当てられたタスクの状態を更新する場合に使用できます。", "parameters": [ { "name": "task_assignment_id", "description": "タスク割り当てのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "タスクに追加できる担当者によるメッセージ (省略可)。", "example": "Looks good to me" }, "resolution_state": { "type": "string", "description": "ユーザーに割り当てられたタスクの状態。\n\n* `action`値が`complete`のタスクの場合は`incomplete`または`completed`になります。\n* `action`が`review`のタスクの場合は`incomplete`、`approved`、または`rejected`になります。", "example": "completed", "enum": [ "completed", "incomplete", "approved", "rejected" ] } } } } } }, "responses": { "200": { "description": "更新されたタスク割り当てオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAssignment" } } } }, "400": { "description": "解決状態がタスクのアクションタイプと互換性がない場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "タスク割り当てが見つからない場合、またはタスクが割り当てられているファイルにユーザーがアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_task_assignments_id", "summary": "タスク割り当てを解除", "tags": [ "タスク割り当て" ], "x-box-tag": "task_assignments", "x-box-sanitized": true, "description": "特定のタスク割り当てを削除します。", "parameters": [ { "name": "task_assignment_id", "description": "タスク割り当てのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "タスク割り当てが正常に削除された場合は、空のレスポンスを返します。" }, "404": { "description": "指定したIDのタスク割り当てが存在しないかアカウントにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shared_items": { "get": { "operationId": "get_shared_items", "summary": "共有リンクのファイルを検索", "tags": [ "共有リンク (ファイル)" ], "x-box-tag": "shared_links_files", "x-box-enable-explorer": true, "description": "共有リンクで表されるファイルを返します。\n\n共有ファイルは、共有リンクで表すことが可能で、現在の会社内に存在する項目である場合も、別の会社内に存在する項目である場合もあります。\n\nアプリケーションからこのエンドポイントを呼び出すと、共有ファイルについての情報を取得できます (共有リンクが存在する場合のみ)。\n\n`shared_link_permission_options`の配列フィールドは、`fields`クエリパラメータでリクエストすると、返されます。", "parameters": [ { "name": "if-none-match", "description": "項目が変更されている場合にのみ、その項目を返します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは`304 Not Modified`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "boxapi", "description": "共有リンクとその共有リンクの省略可能なパスワードを含むヘッダー。\n\nこのヘッダーの形式は次のようになります。\n\n`shared_link=[link]&shared_link_password=[password]`", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "共有リンクが有効で、ユーザーがそのリンクに対するアクセス権限を持っている場合は、Full版のファイルリソースを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" } } } }, "304": { "description": "`If-None-Match`ヘッダーがフォルダの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、フォルダが前回リクエストされたときから変更されていないことを示します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}#get_shared_link": { "get": { "operationId": "get_files_id#get_shared_link", "summary": "ファイルの共有リンクを取得", "tags": [ "共有リンク (ファイル)" ], "x-box-tag": "shared_links_files", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ファイルの共有リンクの情報を取得します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "追加の共有リンク情報を含むファイルのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "file", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": true } } } } } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}#add_shared_link": { "put": { "operationId": "put_files_id#add_shared_link", "summary": "ファイルに共有リンクを追加", "tags": [ "共有リンク (ファイル)" ], "x-box-tag": "shared_links_files", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ファイルに共有リンクを追加します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "ファイルに作成する共有リンクの設定。共有リンクにデフォルト設定を使用するには、空のオブジェクト (`{}`) を使用します。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、ファイルに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" }, "can_preview": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのプレビューが許可されているかどうか。この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": true, "description": "共有リンクからのファイルの編集が許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。`can_download`が`true`の場合、この値も`true`にしか設定できません。" } } } } } } } } } }, "responses": { "200": { "description": "新しい共有リンクが追加されているファイルのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "file", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": true } } } } } } } }, "400": { "description": "権限の組み合わせが正しくない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}#update_shared_link": { "put": { "operationId": "put_files_id#update_shared_link", "summary": "ファイルの共有リンクを更新", "tags": [ "共有リンク (ファイル)" ], "x-box-tag": "shared_links_files", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ファイルの共有リンクを更新します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "更新する共有リンクの設定。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" }, "can_preview": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのプレビューが許可されているかどうか。この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": true, "description": "共有リンクからのファイルの編集が許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。`can_download`が`true`の場合、この値も`true`にしか設定できません。" } } } } } } } } } }, "responses": { "200": { "description": "更新された共有リンクが追加されているファイルのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "file", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": true } } } } } } } }, "400": { "description": "権限の組み合わせが正しくない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/files/{file_id}#remove_shared_link": { "put": { "operationId": "put_files_id#remove_shared_link", "summary": "ファイルから共有リンクを削除", "tags": [ "共有リンク (ファイル)" ], "x-box-tag": "shared_links_files", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ファイルから共有リンクを削除します。", "parameters": [ { "name": "file_id", "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "この値を`null`に設定することで、共有リンクがファイルから削除されます。", "type": "object", "example": null, "nullable": true } } } } } }, "responses": { "200": { "description": "共有リンクが削除されているファイルのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "file", "etag": "1", "shared_link": null } } } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shared_items#folders": { "get": { "operationId": "get_shared_items#folders", "summary": "共有リンクのフォルダを検索", "tags": [ "共有リンク (フォルダ)" ], "x-box-tag": "shared_links_folders", "x-box-enable-explorer": true, "description": "共有リンクで表されるフォルダを返します。\n\n共有フォルダは、共有リンクで表すことが可能で、現在の会社内に存在する項目である場合も、別の会社内に存在する項目である場合もあります。\n\nアプリケーションからこのエンドポイントを呼び出すと、共有フォルダについての情報を取得できます (共有リンクが存在する場合のみ)。", "parameters": [ { "name": "if-none-match", "description": "項目が変更されている場合にのみ、その項目を返します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは`304 Not Modified`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "boxapi", "description": "共有リンクとその共有リンクの省略可能なパスワードを含むヘッダー。\n\nこのヘッダーの形式は次のようになります。\n\n`shared_link=[link]&shared_link_password=[password]`", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "共有リンクが有効で、ユーザーがそのリンクに対するアクセス権限を持っている場合は、Full版のフォルダリソースを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" } } } }, "304": { "description": "`If-None-Match`ヘッダーがフォルダの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、フォルダが前回リクエストされたときから変更されていないことを示します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}#get_shared_link": { "get": { "operationId": "get_folders_id#get_shared_link", "summary": "フォルダの共有リンクを取得", "tags": [ "共有リンク (フォルダ)" ], "x-box-tag": "shared_links_folders", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "フォルダの共有リンクの情報を取得します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "追加の共有リンク情報を含むフォルダのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "folder", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": false } } } } } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}#add_shared_link": { "put": { "operationId": "put_folders_id#add_shared_link", "summary": "フォルダに共有リンクを追加", "tags": [ "共有リンク (フォルダ)" ], "x-box-tag": "shared_links_folders", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "フォルダに共有リンクを追加します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "フォルダに作成する共有リンクの設定。\n\n共有リンクにデフォルト設定を使用するには、空のオブジェクト (`{}`) を使用します。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" }, "can_preview": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのプレビューが許可されているかどうか。この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": false, "description": "`type`が`folder`の項目の場合、この値は`false`にしか設定できません。" } } } } } } } } } }, "responses": { "200": { "description": "新しい共有リンクが追加されているフォルダのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "folder", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": false } } } } } } } }, "400": { "description": "権限の組み合わせが正しくない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがフォルダの現在の`etag`値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}#update_shared_link": { "put": { "operationId": "put_folders_id#update_shared_link", "summary": "フォルダの共有リンクを更新", "tags": [ "共有リンク (フォルダ)" ], "x-box-tag": "shared_links_folders", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "フォルダの共有リンクを更新します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "更新する共有リンクの設定。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" }, "can_preview": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのプレビューが許可されているかどうか。この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": false, "description": "`type`が`folder`の項目の場合、この値は`false`にしか設定できません。" } } } } } } } } } }, "responses": { "200": { "description": "更新された共有リンクが追加されているフォルダのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "folder", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": false } } } } } } } }, "400": { "description": "権限の組み合わせが正しくない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがフォルダの現在の`etag`値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/folders/{folder_id}#remove_shared_link": { "put": { "operationId": "put_folders_id#remove_shared_link", "summary": "フォルダから共有リンクを削除", "tags": [ "共有リンク (フォルダ)" ], "x-box-tag": "shared_links_folders", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "フォルダから共有リンクを削除します。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "この値を`null`に設定することで、共有リンクがフォルダから削除されます。", "type": "object", "example": null, "nullable": true } } } } } }, "responses": { "200": { "description": "共有リンクが削除されているフォルダのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" }, "examples": { "default": { "value": { "id": "12345", "type": "folder", "etag": "1", "shared_link": null } } } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`folder_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがフォルダの現在の`etag`値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links": { "post": { "operationId": "post_web_links", "summary": "ウェブリンクを作成", "tags": [ "ウェブリンク" ], "x-box-tag": "web_links", "description": "フォルダ内にウェブリンクオブジェクトを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "parent", "url" ], "properties": { "url": { "type": "string", "example": "https://box.com", "description": "このウェブリンクのリンク先となるURL。`\"http://\"`または`\"https://\"`で始まっている必要があります。" }, "parent": { "type": "object", "description": "ウェブリンクの作成先となる親フォルダ。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "親フォルダのID", "example": "0" } } }, "name": { "type": "string", "example": "Box Website", "description": "ウェブリンクの名前。設定されてない場合は、デフォルトでURLに設定されます。" }, "description": { "type": "string", "example": "Cloud Content Management", "description": "ウェブリンクの説明。" } } } } } }, "responses": { "200": { "description": "新しく作成されたウェブリンクオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links/{web_link_id}": { "get": { "operationId": "get_web_links_id", "summary": "ウェブリンクを取得", "tags": [ "ウェブリンク" ], "x-box-tag": "web_links", "description": "ウェブリンクに関する情報を取得します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "boxapi", "description": "この項目の共有リンクのURLと省略可能なパスワード。\n\nこのヘッダーを使用すると、ユーザーと明示的に共有されていない項目にアクセスできます。\n\n`shared_link=[link]`形式を使用するか、パスワードが必要な場合は`shared_link=[link]&shared_link_password=[password]`を使用します。\n\nこのヘッダーは、共有されているファイルまたはフォルダのほか、その項目内にネストされているすべてのファイルやフォルダで使用できます。", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ウェブリンクオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_web_links_id", "summary": "ウェブリンクを復元", "tags": [ "ごみ箱内のウェブリンク" ], "x-box-tag": "trashed_web_links", "description": "ごみ箱に移動されたウェブリンクを復元します。\n\n元のフォルダが削除されている場合にウェブリンクの復元先となる新しい親ID (省略可) を指定することができます。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "description": "ウェブリンクの新しい名前 (省略可)。", "example": "Restored.docx", "type": "string" }, "parent": { "allOf": [ { "type": "object", "description": "この項目の親", "properties": { "id": { "type": "string", "description": "親項目のID", "example": "123" } } }, { "description": "元のフォルダがすでに存在しない場合にウェブリンクの復元先となるフォルダのID (省略可) を指定します。\n\nこのIDは、元のフォルダがすでに存在しない場合にのみ使用されることに注意してください。このIDは、元の場所が削除されている場合にウェブリンクの復元先となるフォールバックの場所を指定します。" } ] } } } } } }, "responses": { "201": { "description": "ウェブリンクオブジェクトが復元された場合は、そのオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrashWebLinkRestored" } } } }, "403": { "description": "ウェブリンクの復元先フォルダに対してユーザーがアクセス権限を持っていない場合、またはごみ箱からウェブリンクを復元する権限を持っていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ウェブリンクがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "ウェブリンクの復元先フォルダに同じ名前のウェブリンクが存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_web_links_id", "summary": "ウェブリンクを更新", "tags": [ "ウェブリンク" ], "x-box-tag": "web_links", "description": "ウェブリンクオブジェクトを更新します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "example": "https://box.com", "description": "ウェブリンクのリンク先となる新しいURL。`\"http://\"`または`\"https://\"`で始まっている必要があります。" }, "parent": { "allOf": [ { "type": "object", "description": "この項目の親", "properties": { "id": { "type": "string", "description": "親項目のID", "example": "123" } } }, { "description": "ウェブリンクが配置される新しい親フォルダ。これを利用してウェブリンクを別のフォルダに移動します。" } ] }, "name": { "type": "string", "example": "Box Website", "description": "ウェブリンクの新しい名前。設定されていない場合は、デフォルトでURLに設定されます。" }, "description": { "type": "string", "example": "Cloud Content Management", "description": "ウェブリンクの新しい説明。" }, "shared_link": { "description": "更新する共有リンクの設定。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-not-use-this-password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" } } } } } } } }, "responses": { "200": { "description": "更新されたウェブリンクオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_web_links_id", "summary": "ウェブリンクを削除", "tags": [ "ウェブリンク" ], "x-box-tag": "web_links", "description": "ウェブリンクを削除します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ウェブリンクが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links/{web_link_id}/trash": { "get": { "operationId": "get_web_links_id_trash", "summary": "ごみ箱に移動されたウェブリンクを取得", "tags": [ "ごみ箱内のウェブリンク" ], "x-box-tag": "trashed_web_links", "description": "ごみ箱に移動されたウェブリンクを取得します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "ごみ箱に移動された日時の情報を含め、ごみ箱内にあるウェブリンクを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrashWebLink" } } } }, "404": { "description": "ウェブリンクがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_web_links_id_trash", "summary": "ウェブリンクを完全に削除", "tags": [ "ごみ箱内のウェブリンク" ], "x-box-tag": "trashed_web_links", "description": "ごみ箱内にあるウェブリンクを完全に削除します。この操作は元に戻すことができません。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ウェブリンクが完全に削除された場合は、空のレスポンスを返します。" }, "404": { "description": "ウェブリンクがごみ箱内にない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shared_items#web_links": { "get": { "operationId": "get_shared_items#web_links", "summary": "共有リンクのウェブリンクを検索", "tags": [ "共有リンク (ウェブリンク)" ], "x-box-tag": "shared_links_web_links", "x-box-enable-explorer": true, "description": "共有リンクで表されるウェブリンクを返します。\n\n共有ウェブリンクは、共有リンクで表すことが可能で、現在の企業内に存在する項目である場合も、別の企業内に存在する項目である場合もあります。\n\nアプリケーションからこのエンドポイントを呼び出すと、共有ウェブリンクについての情報を取得できます (共有リンクが存在する場合のみ)。", "parameters": [ { "name": "if-none-match", "description": "項目が変更されている場合にのみ、その項目を返します。\n\nその項目の最後に認識された`etag`値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは`304 Not Modified`を返して失敗します。", "in": "header", "required": false, "example": "1", "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "boxapi", "description": "共有リンクとその共有リンクの省略可能なパスワードを含むヘッダー。\n\nこのヘッダーの形式は次のようになります。\n\n`shared_link=[link]&shared_link_password=[password]`", "example": "shared_link=[link]&shared_link_password=[password]", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "共有リンクが有効で、ユーザーがそのリンクに対するアクセス権限を持っている場合は、Full版のファイルリソースを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" } } } }, "304": { "description": "`If-None-Match`ヘッダーがフォルダの現在の`etag`値と一致する場合は、空のレスポンスを返します。これは、フォルダが前回リクエストされたときから変更されていないことを示します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links/{web_link_id}#get_shared_link": { "get": { "operationId": "get_web_links_id#get_shared_link", "summary": "ウェブリンクの共有リンクを取得", "tags": [ "共有リンク (ウェブリンク)" ], "x-box-tag": "shared_links_web_links", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ウェブリンクの共有リンクの情報を取得します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "追加の共有リンク情報を含むウェブリンクのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" }, "examples": { "default": { "value": { "id": "12345", "type": "web_link", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": false } } } } } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links/{web_link_id}#add_shared_link": { "put": { "operationId": "put_web_links_id#add_shared_link", "summary": "ウェブリンクに共有リンクを追加", "tags": [ "共有リンク (ウェブリンク)" ], "x-box-tag": "shared_links_web_links", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ウェブリンクに共有リンクを追加します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "ウェブリンクに作成する共有リンクの設定。\n\n共有リンクにデフォルト設定を使用するには、空のオブジェクト (`{}`) を使用します。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、ファイルに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" }, "can_preview": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのプレビューが許可されているかどうか。この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": false, "description": "`type`が`file`の場合のみ、この値を`true`に設定できます。" } } } } } } } } } }, "responses": { "200": { "description": "新しい共有リンクが追加されているウェブリンクのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" }, "examples": { "default": { "value": { "id": "12345", "type": "web_link", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": false } } } } } } } }, "400": { "description": "権限の組み合わせが正しくない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links/{web_link_id}#update_shared_link": { "put": { "operationId": "put_web_links_id#update_shared_link", "summary": "ウェブリンクの共有リンクを更新", "tags": [ "共有リンク (ウェブリンク)" ], "x-box-tag": "shared_links_web_links", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ウェブリンクの共有リンクを更新します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "更新する共有リンクの設定。", "type": "object", "properties": { "access": { "type": "string", "description": "共有リンクのアクセスレベル。これは、リンクを知っている全員 (`open`)、会社内のユーザーのみ (`company`)、フォルダに招待されたユーザーのみ (`collaborators`) のいずれかに制限できます。\n\n設定しなかった場合、このフィールドは、デフォルトで、企業の管理者が指定したアクセスレベルになります。このデフォルトの設定で共有リンクを作成するには、`{ \"shared_link\": {} }`のように、`access`フィールドを指定せずに`shared_link`オブジェクトを渡します。\n\n`company`アクセスレベルは、有料アカウントのみで使用できます。", "enum": [ "open", "company", "collaborators" ], "example": "open" }, "password": { "type": "string", "description": "共有リンクへのアクセスに必要なパスワード。パスワードを`null`に設定するとパスワードが削除されます。今後、パスワードは8文字以上にし、数字、大文字、または英数字以外の文字を含める必要があります。`access`が`open`に設定されている場合にのみ、パスワードを設定できます。", "example": "do-n8t-use-this-Password" }, "vanity_name": { "type": "string", "description": "共有リンクのURLで使用するカスタムバニティ名を定義します (例: `https://app.box.com/v/my-shared-link`)。\n\nバニティURLは通常の共有リンクよりもかなり推測しやすいため、機密性の高いコンテンツを共有する場合は、カスタムURLを使用しないでください。", "minLength": 12, "example": "my-shared-link" }, "unshared_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "この共有リンクの有効期限が切れる日時のタイムスタンプ。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。この値には、現在の日時より後の日時を指定する必要があります。" }, "permissions": { "type": "object", "properties": { "can_download": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのダウンロードが許可されているかどうか。`access`が`open`または`company`に設定されている場合にのみ設定できます。" }, "can_preview": { "type": "boolean", "example": true, "description": "共有リンクからのファイルのプレビューが許可されているかどうか。この値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": true, "description": "`type`が`file`の場合のみ、この値を`true`に設定できます。" } } } } } } } } } }, "responses": { "200": { "description": "更新された共有リンクが追加されているウェブリンクのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" }, "examples": { "default": { "value": { "id": "12345", "type": "web_link", "etag": "1", "shared_link": { "url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1", "download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf", "vanity_url": null, "vanity_name": null, "effective_access": "open", "effective_permission": "can_download", "is_password_enabled": false, "unshared_at": "2020-09-21T10:34:41-07:00", "download_count": 0, "preview_count": 0, "access": "open", "permissions": { "can_preview": true, "can_download": true, "can_edit": false } } } } } } } }, "400": { "description": "権限の組み合わせが正しくない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/web_links/{web_link_id}#remove_shared_link": { "put": { "operationId": "put_web_links_id#remove_shared_link", "summary": "ウェブリンクから共有リンクを削除", "tags": [ "共有リンク (ウェブリンク)" ], "x-box-tag": "shared_links_web_links", "x-box-enable-explorer": true, "x-box-sanitized": true, "description": "ウェブリンクから共有リンクを削除します。", "parameters": [ { "name": "web_link_id", "description": "ウェブリンクのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "この項目に返される`shared_link`フィールドを明示的にリクエストします。", "example": "shared_link", "in": "query", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "shared_link": { "description": "この値を`null`に設定することで、共有リンクがウェブリンクから削除されます。", "type": "object", "example": null, "nullable": true } } } } } }, "responses": { "200": { "description": "共有リンクが削除されているウェブリンクのBase版の表示を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebLink" }, "examples": { "default": { "value": { "id": "12345", "type": "web_link", "etag": "1", "shared_link": null } } } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "更新を完了するための権限がユーザーに不足している場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "405": { "description": "`file_id`が認識されていない形式で指定されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "412": { "description": "`If-Match`ヘッダーがファイルの現在の`etag`値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users": { "get": { "operationId": "get_users", "x-box-tag": "users", "summary": "会社ユーザーのリストを取得", "tags": [ "Users" ], "description": "会社の全ユーザーのリストを、各ユーザーの`user_id`、`public_name`、`login`とともに返します。\n\n会社全体のユーザーを参照するには、アプリケーションと認証済みユーザーに適切な権限が付与されている必要があります。", "parameters": [ { "name": "filter_term", "description": "`name`または`login`が検索語で始まるユーザーのみに結果を絞り込みます。\n\n外部で管理されているユーザーを検索するには、ユーザー名またはログインが検索語と完全に一致している必要があります。 同時に返されるユーザーは1人のみです。", "in": "query", "required": false, "example": "john", "schema": { "type": "string" } }, { "name": "user_type", "description": "指定したタイプのユーザーのみに結果を絞り込みます。\n\n* `all`を指定すると、`login`または`name`が`filter_term`と部分的に一致するすべての種類のユーザーが返されます。ログインが`filter_term`と完全に一致した場合は、外部ユーザーのみが返され、その場合に返されるユーザーは、完全に一致したユーザーのみです。\n* `managed`を指定すると、`login`または`name`が`filter_term`と部分的に一致するすべての管理対象ユーザーおよびApp Userが返されます。\n* `external`を指定すると、`login`が`filter_term`と完全に一致するすべての外部ユーザーが返されます。", "in": "query", "required": false, "example": "managed", "schema": { "type": "string", "enum": [ "all", "managed", "external" ] } }, { "name": "external_app_user_id", "in": "query", "required": false, "schema": { "type": "string" }, "example": "my-user-1234", "description": "指定した`external_app_user_id`値を持つApp Userに結果を絞り込みます。\n\nアプリユーザーの作成時に、`external_app_user_id`値を設定できます。その後、この値をこのエンドポイントで使用すると、その`external_app_user_id`値に一致するすべてのユーザーが見つかります。" }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "usemarker", "description": "オフセットベースのページ割り方式ではなくマーカーベースのページ割り方式を使用するかどうかを指定します。同時に使用できるページ割りの方式は1つのみです。\n\nこの値をtrueに設定すると、APIは、レスポンスの次のページを取得するために、このエンドポイントにパラメータとして渡すことができる`marker`フィールドを返します。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } } ], "responses": { "200": { "description": "企業内のすべてのユーザーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Users" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_users", "summary": "ユーザーを作成", "tags": [ "Users" ], "x-box-tag": "users", "description": "会社内の管理対象ユーザーを新規に作成します。このエンドポイントを使用できるのは、適切な管理者権限を持つユーザーとアプリケーションのみです。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "ユーザーの名前", "example": "Aaron Levie", "maxLength": 50 }, "login": { "type": "string", "description": "ユーザーがログインに使用するメールアドレス\n\n`is_platform_access_only`が`true`に設定されている場合を除いて必須です。", "example": "boss@box.com" }, "is_platform_access_only": { "type": "boolean", "example": true, "description": "ユーザーがアプリユーザーであることを示します。" }, "role": { "type": "string", "enum": [ "coadmin", "user" ], "description": "ユーザーの会社ロール", "example": "user" }, "language": { "type": "string", "description": "修正版の[ISO 639-1](/guides/api-calls/language-codes)形式で表されるユーザーの言語。", "example": "en" }, "is_sync_enabled": { "type": "boolean", "description": "ユーザーがBox Syncを使用できるかどうか", "example": true }, "job_title": { "type": "string", "description": "ユーザーの役職", "maxLength": 100, "example": "CEO" }, "phone": { "type": "string", "description": "ユーザーの電話番号", "maxLength": 100, "example": "6509241374" }, "address": { "type": "string", "description": "ユーザーの住所", "maxLength": 255, "example": "900 Jefferson Ave, Redwood City, CA 94063" }, "space_amount": { "type": "integer", "format": "int64", "description": "ユーザーが利用可能な容量の合計 (バイト数)。これを`-1`に設定するとストレージ容量が無制限になります。", "example": 11345156112 }, "tracking_codes": { "type": "array", "items": { "$ref": "#/components/schemas/TrackingCode" }, "description": "追跡コードを使用すると、管理者は管理コンソールからレポートを生成し、特定のグループのユーザーに属性を割り当てることができます。この設定を使用するには、会社に対して有効にしておく必要があります。" }, "can_see_managed_users": { "type": "boolean", "example": true, "description": "ユーザーが自身の連絡先リストで会社の他のユーザーを参照できるかどうか" }, "timezone": { "type": "string", "format": "timezone", "description": "ユーザーのタイムゾーン", "example": "Africa/Bujumbura" }, "is_external_collab_restricted": { "type": "boolean", "example": true, "description": "ユーザーが社外のユーザーとのコラボレーションを許可されているかどうか" }, "is_exempt_from_device_limits": { "type": "boolean", "example": true, "description": "会社のデバイス制限からユーザーを除外するかどうか" }, "is_exempt_from_login_verification": { "type": "boolean", "example": true, "description": "ユーザーが2要素認証を使用する必要があるかどうか" }, "status": { "type": "string", "enum": [ "active", "inactive", "cannot_delete_edit", "cannot_delete_edit_upload" ], "description": "ユーザーのアカウントのステータス", "example": "active" }, "external_app_user_id": { "type": "string", "example": "my-user-1234", "description": "ユーザーの検索に使用できる、アプリユーザーの外部識別子。これを使用して、外部IDプロバイダのユーザーIDをBoxユーザーに結び付けることができます。" } } } } } }, "responses": { "201": { "description": "新しく作成されたユーザーのユーザーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/User--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/me": { "get": { "operationId": "get_users_me", "x-box-tag": "users", "summary": "現在のユーザーを取得", "tags": [ "Users" ], "description": "現在認証されているユーザーに関する情報を取得します。\n\nクライアント側で認証されるOAuth 2.0アプリケーションの場合、これはアプリケーションを承認したユーザーになります。\n\nサーバー側でアプリケーションが認証されるJWTの場合、これはデフォルトでアプリケーションに属するサービスアカウントになります。\n\nこのAPIコールに使用するユーザーを変更するには、`As-User`ヘッダーを使用します。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "1つのユーザーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/User--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/terminate_sessions": { "post": { "operationId": "post_users_terminate_sessions", "summary": "ユーザーのセッションを終了させるジョブを作成", "tags": [ "セッション終了" ], "x-box-tag": "session_termination", "description": "ユーザーのロールと権限を検証し、ユーザーのセッションを終了させる非同期ジョブを作成します。POSTリクエストのステータスを返します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "user_ids", "user_logins" ], "properties": { "user_ids": { "example": [ "123456", "456789" ], "type": "array", "description": "ユーザーIDのリスト", "items": { "type": "string" } }, "user_logins": { "example": [ "user@sample.com", "user2@sample.com" ], "type": "array", "description": "ユーザーログインのリスト", "items": { "type": "string" } } } } } } }, "responses": { "202": { "description": "リクエストのステータスに関するメッセージを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionTerminationMessage" } } } }, "400": { "description": "一部のパラメータが無効な場合にエラーを返します。\n\n* `Users can not be NULL or EMPTY`: 値が指定されていない場合\n* `User id format is string`: 指定されたユーザーIDの形式が正しくない場合\n* `Supported payload format is JSON`: 指定されたペイロードの形式が正しくない場合", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "権限が不足している場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "リソースが見つからなかった場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "429": { "description": "レート制限を超えた場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "内部サーバーの問題が発生している場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "503": { "description": "リクエストがタイムアウトした場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/{user_id}": { "get": { "operationId": "get_users_id", "x-box-tag": "users", "summary": "ユーザーを取得", "tags": [ "Users" ], "description": "企業内のユーザーに関する情報を取得します。\n\n会社全体のユーザーを参照するには、アプリケーションと認証済みユーザーに適切な権限が付与されている必要があります。\n\nまた、このエンドポイントは、適切なスコープを持つ認証済みユーザー用として会社が所有するコンテンツでコラボレーションを行う外部ユーザーに対しては、一部の情報のみを返します。その場合、権限が与えられていないフィールドについては、nullが返されます。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "1つのユーザーオブジェクトを返します。\n\n使用可能なすべてのフィールドがデフォルトで返されるとは限りません。[fields](#param-fields)パラメータを使用して特定のフィールドを明示的にリクエストするには、[fields](#get-users-id--request--fields)クエリパラメータを使用します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/User--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_users_id", "summary": "ユーザーを更新", "tags": [ "Users" ], "x-box-tag": "users", "x-box-enable-explorer": true, "description": "企業内の管理対象ユーザーまたはApp Userを更新します。このエンドポイントを使用できるのは、適切な管理者権限を持つユーザーとアプリケーションのみです。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "enterprise": { "type": "string", "nullable": true, "example": null, "description": "これを`null`に設定すると、ユーザーが会社のメンバーではなくなり、無料ユーザーになります" }, "notify": { "type": "boolean", "example": true, "description": "ユーザーが会社のメンバーでなくなった後もメールを受信できるようにするかどうか" }, "name": { "type": "string", "description": "ユーザーの名前", "example": "Aaron Levie", "maxLength": 50 }, "login": { "type": "string", "description": "ユーザーがログインに使用するメールアドレス\n\n注: ターゲットユーザーのメールアドレスが確認されていない場合は、プライマリログインアドレスを変更できません。", "example": "somename@box.com" }, "role": { "type": "string", "enum": [ "coadmin", "user" ], "description": "ユーザーの会社ロール", "example": "user" }, "language": { "type": "string", "description": "修正版の[ISO 639-1](/guides/api-calls/language-codes)形式で表されるユーザーの言語。", "example": "en" }, "is_sync_enabled": { "type": "boolean", "description": "ユーザーがBox Syncを使用できるかどうか", "example": true }, "job_title": { "type": "string", "description": "ユーザーの役職", "maxLength": 100, "example": "CEO" }, "phone": { "type": "string", "description": "ユーザーの電話番号", "maxLength": 100, "example": "6509241374" }, "address": { "type": "string", "description": "ユーザーの住所", "maxLength": 255, "example": "900 Jefferson Ave, Redwood City, CA 94063" }, "tracking_codes": { "type": "array", "items": { "$ref": "#/components/schemas/TrackingCode" }, "description": "追跡コードを使用すると、管理者は管理コンソールからレポートを生成し、特定のグループのユーザーに属性を割り当てることができます。この設定を使用するには、会社に対して有効にしておく必要があります。" }, "can_see_managed_users": { "type": "boolean", "example": true, "description": "ユーザーが自身の連絡先リストで会社の他のユーザーを参照できるかどうか" }, "timezone": { "type": "string", "format": "timezone", "description": "ユーザーのタイムゾーン", "example": "Africa/Bujumbura" }, "is_external_collab_restricted": { "type": "boolean", "example": true, "description": "ユーザーが社外のユーザーとのコラボレーションを許可されているかどうか" }, "is_exempt_from_device_limits": { "type": "boolean", "example": true, "description": "会社のデバイス制限からユーザーを除外するかどうか" }, "is_exempt_from_login_verification": { "type": "boolean", "example": true, "description": "ユーザーが2要素認証を使用する必要があるかどうか" }, "is_password_reset_required": { "type": "boolean", "example": true, "description": "ユーザーにパスワードのリセットを義務付けるかどうか" }, "status": { "type": "string", "enum": [ "active", "inactive", "cannot_delete_edit", "cannot_delete_edit_upload" ], "description": "ユーザーのアカウントのステータス", "example": "active" }, "space_amount": { "type": "integer", "format": "int64", "description": "ユーザーが利用可能な容量の合計 (バイト数)。これを`-1`に設定するとストレージ容量が無制限になります。", "example": 11345156112 }, "notification_email": { "type": "object", "nullable": true, "description": "通知メールが送信される代替の通知用メールアドレス。確認されると、通知メールはプライマリメールアドレスではなくこのメールアドレスに送信されます。\n\nこれを`null`に設定すると、通知メールが削除されます。", "properties": { "email": { "type": "string", "example": "notifications@example.com", "description": "通知を送付するメールアドレス。" } } }, "external_app_user_id": { "type": "string", "example": "my-user-1234", "description": "ユーザーの検索に使用できる、アプリユーザーの外部識別子。これを使用して、外部IDプロバイダのユーザーIDをBoxユーザーに結び付けることができます。\n\n注: このフィールドを更新するには、App Userを作成したアプリケーションを使用してトークンをリクエストする必要があります。" } } } } } }, "responses": { "200": { "description": "更新されたユーザーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/User--Full" } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* `invalid_parameter`: パラメータの形式が正しくない場合です。たとえば、`notification_email`に正しくない形式のメールアドレスが含まれている場合です。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーに変更が許可されていない場合にエラーを返します。\n\n* `access_denied_insufficient_permissions`: ユーザーに適切な権限がない場合です。たとえば、企業の設定で通知メールのアップデートがオフになっている場合です。\n* `denied_by_policy`: 情報バリアの制限によりユーザーに適切な権限がない場合。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_users_id", "x-box-tag": "users", "summary": "ユーザーを削除", "tags": [ "Users" ], "description": "ユーザーを削除します。デフォルトでは、ユーザーがまだコンテンツを所有している状態では失敗します。削除を実行する前にユーザーが所有するコンテンツを移動するか、`force`フィールドを使用してユーザーとそのユーザーが所有するファイルを削除してください。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "notify", "schema": { "type": "boolean" }, "in": "query", "example": true, "description": "削除に関するメール通知がユーザーに送信されるかどうか" }, { "name": "force", "schema": { "type": "boolean" }, "in": "query", "example": true, "description": "まだファイルを所有していてもこのユーザーを削除するかどうか" } ], "responses": { "204": { "description": "ユーザーを削除して空のレスポンスを返します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/{user_id}/avatar": { "get": { "operationId": "get_users_id_avatar", "x-box-tag": "avatars", "summary": "ユーザーのアバターを取得", "tags": [ "ユーザーのアバター" ], "description": "ユーザーのアバターの画像を取得します。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ユーザーのアバターが見つかった場合は、レスポンスの本文内で画像データが返されます。", "content": { "image/jpg": { "schema": { "type": "string", "format": "binary", "description": "アバター" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_users_id_avatar", "x-box-tag": "avatars", "summary": "ユーザーのアバターを追加または更新", "tags": [ "ユーザーのアバター" ], "description": "ユーザーのアバターを追加または更新します。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "pic" ], "properties": { "pic": { "type": "string", "format": "binary", "description": "Boxにアップロードする画像ファイル。使用可能なファイル拡張子は`.jpg`または`.png`です。ファイルサイズの上限は1 MBです。" } } } } } }, "responses": { "200": { "description": "* `ok`: 更新された既存のユーザーのアバターへのURLを示す`pic_urls`オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserAvatar" } } } }, "201": { "description": "* `created`: リクエストによってBoxにアップロードされたユーザーのアバターへのURLを示す`pic_urls`オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserAvatar" } } } }, "400": { "description": "* `bad_request`: 次の場合にエラーを返します。\n * リクエストに画像が含まれていない\n * アップロードされたファイルが空である\n * 画像のサイズが1024 \\* 1024ピクセルまたは1 MBを超えている\n * ファイル拡張子が`.jpg`または`.png`以外である", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "* `forbidden`: アバターをアップロードするために必要な権限がユーザーにない場合、またはユーザーがアクティブになっていない場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "* `not_found`: ユーザーが存在しないか見つからない場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_users_id_avatar", "x-box-tag": "avatars", "summary": "ユーザーのアバターを削除", "tags": [ "ユーザーのアバター" ], "description": "既存のユーザーのアバターを削除します。この操作を元に戻すことはできません。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "* `no_content`: アバターを削除して空のレスポンスを返します。" }, "403": { "description": "* `forbidden`: ユーザーが必要な権限を持っていないかアクティブになっていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "* `not_found`: ユーザーまたはユーザーのアバターが存在しないか見つからない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/{user_id}/folders/0": { "put": { "operationId": "put_users_id_folders_0", "x-box-tag": "transfer", "summary": "所有フォルダを移行", "tags": [ "フォルダを移行" ], "description": "ユーザーが所有するすべての項目 (ファイル、フォルダ、およびワークフロー) を別のユーザーのアカウントに移動します。\n\n転送できるのは、ルートフォルダ (`0`) のみです。\n\nユーザー間でフォルダを移動できるのは、管理者権限を持つユーザーのみです。\n\n既存の共有リンクとフォルダレベルのコラボレーションはすべて、操作中に転送されます。個々のファイルレベルでのコラボレーションは操作中に転送されますが、元のユーザーが削除されるとこれらのコラボレーションは削除されることに注意してください。\n\nこの呼び出しは同期的に実行されるため、移動元のユーザーのすべてのフォルダに多数の項目がある場合は、レスポンスが遅くなる可能性があります。\n\n宛先パスのいずれかの親フォルダにメタデータカスケードポリシーが適用されている場合は、メタデータカスケード操作が非同期的に開始されます。\n\n現時点では、この操作がいつ終了したのかを確認する方法はありません。\n\n宛先フォルダの名前は、`{User}'s Files and\nFolders`形式になります。この場合、`{User}`はユーザーの表示名です。\n\nこのAPIコールを行うには、アプリケーションで \\[Boxに格納されているすべてのファイルとフォルダの読み取りと書き込み] スコープを有効にしておく必要があります。\n\n転送先ユーザーが`Relay`または`Relay Lite`にアクセスできることと転送中のワークフローに関与するファイルやフォルダにアクセスできることを確認してください。\n\n操作が完了すると、管理者にメールが届きます。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "notify", "description": "実行されたアクションについてのメール通知をユーザーに送信するかどうかを決定します。", "in": "query", "required": false, "example": true, "schema": { "type": "boolean" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "owned_by" ], "properties": { "owned_by": { "type": "object", "description": "フォルダの移行先になるユーザー", "required": [ "id" ], "properties": { "id": { "type": "string", "example": "1232234", "description": "フォルダの移行先になるユーザーのID" } } } } } } } }, "responses": { "200": { "description": "新しく作成された宛先フォルダの情報を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder--Full" } } } }, "403": { "description": "フォルダの所有権を別のユーザーに移管できない場合にエラーを返します。\n\n* `forbidden_by_policy`: 情報バリアの制限により所有権の移管が禁止されている場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/{user_id}/email_aliases": { "get": { "operationId": "get_users_id_email_aliases", "summary": "ユーザーのメールエイリアスのリストを取得", "tags": [ "メールエイリアス" ], "x-box-tag": "email_aliases", "description": "ユーザーのすべてのメールエイリアスを取得します。コレクションにユーザーのプライマリログインは含まれません。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "メールエイリアスのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailAliases" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_users_id_email_aliases", "x-box-tag": "email_aliases", "summary": "メールエイリアスを作成", "tags": [ "メールエイリアス" ], "description": "新しいメールエイリアスをユーザーアカウントに追加します。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "example": "alias@example.com", "description": "アカウントにエイリアスとして追加するメールアドレス。\n\n注: メールエイリアスのドメインは企業に登録されている必要があります。新しいドメインを追加する手順については、[ドメイン検証のガイド](https://support.box.com/hc/en-us/articles/4408619650579-Domain-Verification)を参照してください。" } } } } } }, "responses": { "201": { "description": "新しく作成されたメールエイリアスオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailAlias" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/{user_id}/email_aliases/{email_alias_id}": { "delete": { "operationId": "delete_users_id_email_aliases_id", "x-box-tag": "email_aliases", "summary": "メールエイリアスを削除", "tags": [ "メールエイリアス" ], "description": "ユーザーからメールエイリアスを削除します。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_alias_id", "description": "メールエイリアスのID。", "example": "23432", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "エイリアスを削除して空のレスポンスを返します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/users/{user_id}/memberships": { "get": { "operationId": "get_users_id_memberships", "summary": "ユーザーのグループのリストを取得", "x-box-tag": "memberships", "tags": [ "グループメンバーシップ" ], "description": "ユーザーのすべてのグループを取得します。このグループのメンバー、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "user_id", "description": "ユーザーのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "メンバーシップオブジェクトのコレクションを返します。メンバーシップが存在しない場合は、空のコレクションが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupMemberships" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/invites": { "post": { "operationId": "post_invites", "summary": "ユーザー招待を作成", "tags": [ "Invites" ], "x-box-tag": "invites", "description": "既存の外部ユーザーを会社に招待します。\n\nすでに他の会社に所属しているユーザーや、Boxアカウントを持たないユーザーを招待することはできません。招待されたユーザーには、Boxウェブアプリケーションで招待を承認するように促すメールが届きます。\n\nこの方法を使用する場合は、対象アプリケーションに対して「Enterpriseの管理」スコープを有効にする必要があります。これは、開発者コンソールから有効にできます。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "enterprise", "actionable_by" ], "properties": { "enterprise": { "type": "object", "description": "ユーザーの招待先となる会社", "required": [ "id" ], "properties": { "id": { "type": "string", "example": "1232234", "description": "会社のID" } } }, "actionable_by": { "type": "object", "description": "招待するユーザー", "required": [ "id" ], "properties": { "login": { "type": "string", "example": "john@example.com", "description": "招待されたユーザーのログイン" } } } } } } } }, "responses": { "200": { "description": "新しい招待オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invite" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/invites/{invite_id}": { "get": { "operationId": "get_invites_id", "summary": "ユーザー招待ステータスを取得", "tags": [ "Invites" ], "description": "ユーザー招待のステータスを返します。", "x-box-tag": "invites", "parameters": [ { "name": "invite_id", "description": "招待のID。", "example": "213723", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "招待オブジェクトを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invite" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/groups": { "get": { "operationId": "get_groups", "summary": "会社のグループのリストを取得", "x-box-tag": "groups", "tags": [ "Groups" ], "description": "指定した会社のすべてのグループを取得します。会社のグループを調べるには、管理者権限が必要です。", "parameters": [ { "name": "filter_term", "description": "`name`が検索語で始まるグループのみに結果を絞り込みます。", "in": "query", "required": false, "example": "Engineering", "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "グループオブジェクトのコレクションを返します。グループが存在しない場合は、空のコレクションが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Groups" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_groups", "summary": "グループを作成", "tags": [ "Groups" ], "x-box-tag": "groups", "description": "会社内に新しいユーザーグループを作成します。新しいグループを作成できるのは、管理者権限を持つユーザーのみです。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "example": "Customer Support", "description": "作成する新しいグループの名前。この名前は、企業内で一意である必要があります。" }, "provenance": { "type": "string", "description": "`Active Directory`や`Okta`など、このグループの元になっている外部ソースを追跡します。\n\nまた、これを設定すると、Box管理者がBoxウェブアプリケーションからグループ名やメンバーを直接編集できなくなります。\n\nこれはグループを一方向にのみ同期する場合に適しています。", "maxLength": 255, "example": "Active Directory" }, "external_sync_identifier": { "type": "string", "description": "このBoxグループを外部グループにリンクするために外部のグループ同期ツールで使用できる任意の識別子。\n\nこのフィールドの値には、**Active DirectoryオブジェクトID**や**GoogleグループID**などを使用できます。\n\nBoxまたは外部システム内でグループ名が更新されたときの問題を回避するために、このフィールドを使用することをお勧めします。", "example": "AD:123456" }, "description": { "type": "string", "description": "グループについての人間が判読できる説明。", "maxLength": 255, "example": "\"Customer Support Group - as imported from Active Directory\"" }, "invitability_level": { "type": "string", "example": "admins_only", "description": "フォルダでのコラボレーションにグループを招待できるユーザーを指定します。\n\n`admins_only`に設定すると、会社の管理者、共同管理者、およびグループ管理者がグループを招待できるようになります。\n\n`admins_and_members`に設定すると、上記すべての管理者に加えて、グループのメンバーもグループを招待できるようになります。\n\n`all_managed_users`に設定すると、社内のすべての管理対象ユーザーがグループを招待できるようになります。", "enum": [ "admins_only", "admins_and_members", "all_managed_users" ] }, "member_viewability_level": { "type": "string", "example": "admins_only", "description": "グループのメンバーを表示できるユーザーを指定します。\n\n* `admins_only` - 企業の管理者、共同管理者、グループのグループ管理者\n* `admins_and_members` - すべての管理者とグループメンバー\n* `all_managed_users` - 企業のすべての管理対象ユーザー", "enum": [ "admins_only", "admins_and_members", "all_managed_users" ] } } } } } }, "responses": { "201": { "description": "新しいグループオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Group--Full" } } } }, "409": { "description": "競合が原因でグループを作成できないことを示すエラーを返します。\n\n* `invalid_parameter`: グループ名が企業内で一意でない場合によく返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/groups/terminate_sessions": { "post": { "operationId": "post_groups_terminate_sessions", "summary": "ユーザーグループのセッションを終了させるジョブを作成", "tags": [ "セッション終了" ], "x-box-tag": "session_termination", "description": "グループのロールと権限を検証し、グループのセッションを終了させる非同期ジョブを作成します。POSTリクエストのステータスを返します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "group_ids" ], "properties": { "group_ids": { "example": [ "123456", "456789" ], "type": "array", "description": "グループIDのリスト", "items": { "type": "string" } } } } } } }, "responses": { "202": { "description": "リクエストのステータスに関するメッセージを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionTerminationMessage" } } } }, "400": { "description": "一部のパラメータが無効な場合にエラーを返します。\n\n* `Groups can not be NULL or EMPTY`: 値が指定されていない場合\n* `group id format is string`: 指定されたグループIDの形式が正しくない場合\n* `Supported payload format is JSON`: 指定されたペイロードの形式が正しくない場合", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "権限が不足している場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "リソースが見つからなかった場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "429": { "description": "リクエスト制限を超えた場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "500": { "description": "内部サーバーの問題が発生している場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "503": { "description": "リクエストがタイムアウトした場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/groups/{group_id}": { "get": { "operationId": "get_groups_id", "summary": "グループを取得", "tags": [ "Groups" ], "x-box-tag": "groups", "description": "グループに関する情報を取得します。このグループのメンバー、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_id", "description": "グループのID。", "example": "57645", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "グループオブジェクトを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Group--Full" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_groups_id", "summary": "グループを更新", "tags": [ "Groups" ], "x-box-tag": "groups", "description": "特定のグループを更新します。このグループの管理者、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_id", "description": "グループのID。", "example": "57645", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "Customer Support", "description": "作成する新しいグループの名前。企業内で一意である必要があります。" }, "provenance": { "type": "string", "description": "`Active Directory`や`Okta`など、このグループの元になっている外部ソースを追跡します。\n\nまた、これを設定すると、Box管理者がBoxウェブアプリケーションからグループ名やメンバーを直接編集できなくなります。\n\nこれはグループを一方向にのみ同期する場合に適しています。", "maxLength": 255, "example": "Active Directory" }, "external_sync_identifier": { "type": "string", "description": "このBoxグループを外部グループにリンクするために外部のグループ同期ツールで使用できる任意の識別子。\n\nこのフィールドの値には、**Active DirectoryオブジェクトID**や**GoogleグループID**などを使用できます。\n\nBoxまたは外部システム内でグループ名が更新されたときの問題を回避するために、このフィールドを使用することをお勧めします。", "example": "AD:123456" }, "description": { "type": "string", "description": "グループについての人間が判読できる説明。", "maxLength": 255, "example": "\"Customer Support Group - as imported from Active Directory\"" }, "invitability_level": { "type": "string", "example": "admins_only", "description": "フォルダでのコラボレーションにグループを招待できるユーザーを指定します。\n\n`admins_only`に設定すると、会社の管理者、共同管理者、およびグループ管理者がグループを招待できるようになります。\n\n`admins_and_members`に設定すると、上記すべての管理者に加えて、グループのメンバーもグループを招待できるようになります。\n\n`all_managed_users`に設定すると、社内のすべての管理対象ユーザーがグループを招待できるようになります。", "enum": [ "admins_only", "admins_and_members", "all_managed_users" ] }, "member_viewability_level": { "type": "string", "example": "admins_only", "description": "グループのメンバーを表示できるユーザーを指定します。\n\n* `admins_only` - 企業の管理者、共同管理者、グループのグループ管理者\n* `admins_and_members` - すべての管理者とグループメンバー\n* `all_managed_users` - 企業のすべての管理対象ユーザー", "enum": [ "admins_only", "admins_and_members", "all_managed_users" ] } } } } } }, "responses": { "200": { "description": "更新されたグループオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Group--Full" } } } }, "409": { "description": "競合が原因でグループを作成できないことを示すエラーを返します。\n\n* `invalid_parameter`: グループ名が企業内で一意でない場合によく返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_groups_id", "summary": "グループを削除", "tags": [ "Groups" ], "x-box-tag": "groups", "description": "グループを完全に削除します。管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_id", "description": "グループのID。", "example": "57645", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "グループが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/groups/{group_id}/memberships": { "get": { "operationId": "get_groups_id_memberships", "summary": "グループのメンバーのリストを取得", "x-box-tag": "memberships", "tags": [ "グループメンバーシップ" ], "description": "グループのすべてのユーザーを取得します。このグループのメンバー、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_id", "description": "グループのID。", "example": "57645", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "メンバーシップオブジェクトのコレクションを返します。メンバーシップが存在しない場合は、空のコレクションが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupMemberships" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/groups/{group_id}/collaborations": { "get": { "operationId": "get_groups_id_collaborations", "summary": "グループコラボレーションのリストを取得", "x-box-tag": "list_collaborations", "tags": [ "コラボレーション (リスト)" ], "description": "グループのすべてのコラボレーションを取得します。会社のグループを調べるには、管理者権限が必要です。\n\nそれぞれのコラボレーションオブジェクトには、そのグループがどのファイルやフォルダにアクセスでき、どのロールが使用されるのかに関する詳細情報が含まれています。", "parameters": [ { "name": "group_id", "description": "グループのID。", "example": "57645", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } } ], "responses": { "200": { "description": "コラボレーションオブジェクトのコレクションを返します。コラボレーションが存在しない場合は、空のコレクションが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collaborations" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/group_memberships": { "post": { "operationId": "post_group_memberships", "summary": "ユーザーをグループに追加", "tags": [ "グループメンバーシップ" ], "x-box-tag": "memberships", "description": "グループメンバーシップを作成します。管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "user", "group" ], "properties": { "user": { "type": "object", "description": "グループに追加するユーザー。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "グループに追加するユーザーのID", "example": "1434325" } } }, "group": { "type": "object", "description": "ユーザーを追加するグループ。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "ユーザーを追加するグループのID", "example": "4545523" } } }, "role": { "type": "string", "example": "member", "description": "グループ内のユーザーのロール。", "enum": [ "member", "admin" ] }, "configurable_permissions": { "type": "object", "example": { "can_run_reports": true }, "description": "管理者権限のカスタム設定 (グループが受け入れる場合)。このオプションは、ロールが`member`であるメンバーには影響しません。\n\nこれらの権限を設定すると、管理者のデフォルトのアクセスレベルが上書きされます。\n\nこのオブジェクトの値として「null」を指定すると、設定可能なすべての権限が無効になります。権限を指定すると、それに応じて権限が設定され、省略した権限はデフォルトで有効になります。", "additionalProperties": { "type": "boolean", "description": "カスタム権限のキーと値のペア。", "example": true, "x-box-example-key": "can_run_reports" } } } } } } }, "responses": { "201": { "description": "新しいグループメンバーシップオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupMembership" } } } }, "403": { "description": "ユーザーをグループに追加できない場合にエラーを返します。\n\n* `forbidden_by_policy`: 情報バリアの制限によりグループへのユーザーの追加が禁止されています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/group_memberships/{group_membership_id}": { "get": { "operationId": "get_group_memberships_id", "summary": "グループメンバーシップを取得", "tags": [ "グループメンバーシップ" ], "x-box-tag": "memberships", "description": "特定のグループメンバーシップを取得します。このグループの管理者、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_membership_id", "description": "グループメンバーシップのID。", "example": "434534", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "グループメンバーシップオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupMembership" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_group_memberships_id", "summary": "グループメンバーシップを更新", "tags": [ "グループメンバーシップ" ], "x-box-tag": "memberships", "description": "ユーザーのグループメンバーシップを更新します。このグループの管理者、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_membership_id", "description": "グループメンバーシップのID。", "example": "434534", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "example": "member", "description": "グループ内のユーザーのロール。", "enum": [ "member", "admin" ] }, "configurable_permissions": { "type": "object", "example": { "can_run_reports": true }, "description": "管理者権限のカスタム設定 (グループが受け入れる場合)。このオプションは、ロールが`member`であるメンバーには影響しません。\n\nこれらの権限を設定すると、管理者のデフォルトのアクセスレベルが上書きされます。\n\nこのオブジェクトの値として「null」を指定すると、設定可能なすべての権限が無効になります。権限を指定すると、それに応じて権限が設定され、省略した権限はデフォルトで有効になります。", "additionalProperties": { "type": "boolean", "description": "カスタム権限のキーと値のペア。", "example": true, "x-box-example-key": "can_run_reports" } } } } } } }, "responses": { "200": { "description": "新しいグループメンバーシップオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupMembership" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_group_memberships_id", "summary": "ユーザーをグループから削除", "tags": [ "グループメンバーシップ" ], "x-box-tag": "memberships", "description": "特定のグループメンバーシップを削除します。このグループの管理者、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。", "parameters": [ { "name": "group_membership_id", "description": "グループメンバーシップのID。", "example": "434534", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "メンバーシップが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/webhooks": { "get": { "operationId": "get_webhooks", "summary": "すべてのWebhookのリストを取得", "tags": [ "Webhooks" ], "x-box-tag": "webhooks", "description": "リクエスト元のアプリケーションに対して定義されているすべてのWebhookを返します。\n\nこのAPIは、認証済みユーザーが所有するファイルまたはフォルダに適用されているWebhookのみを返します。つまり、管理者は、それらのフォルダにアクセスできない限り、サービスアカウントによって作成されたWebhookを表示することはできません。逆もまた同様です。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "Webhookのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhooks" } } } }, "403": { "description": "アプリケーションにWebhookを管理する権限が付与されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_webhooks", "summary": "Webhookを作成", "tags": [ "Webhooks" ], "x-box-tag": "webhooks", "description": "Webhookを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "target", "triggers", "address" ], "properties": { "target": { "type": "object", "description": "Webhookをトリガーする項目", "properties": { "id": { "description": "Webhookをトリガーする項目のID", "type": "string", "example": "1231232" }, "type": { "description": "Webhookをトリガーする項目のタイプ", "type": "string", "example": "file", "enum": [ "file", "folder" ] } } }, "address": { "type": "string", "example": "https://example.com/webhooks", "description": "このWebhookによって通知されるURL" }, "triggers": { "type": "array", "example": [ "FILE.UPLOADED" ], "description": "このWebhookがトリガーされるイベント名の配列", "items": { "title": "Webhookトリガー", "example": "FILE.UPLOADED", "type": "string", "description": "このWebhookをトリガーしたイベント名", "enum": [ "FILE.UPLOADED", "FILE.PREVIEWED", "FILE.DOWNLOADED", "FILE.TRASHED", "FILE.DELETED", "FILE.RESTORED", "FILE.COPIED", "FILE.MOVED", "FILE.LOCKED", "FILE.UNLOCKED", "FILE.RENAMED", "COMMENT.CREATED", "COMMENT.UPDATED", "COMMENT.DELETED", "TASK_ASSIGNMENT.CREATED", "TASK_ASSIGNMENT.UPDATED", "METADATA_INSTANCE.CREATED", "METADATA_INSTANCE.UPDATED", "METADATA_INSTANCE.DELETED", "FOLDER.CREATED", "FOLDER.RENAMED", "FOLDER.DOWNLOADED", "FOLDER.RESTORED", "FOLDER.DELETED", "FOLDER.COPIED", "FOLDER.MOVED", "FOLDER.TRASHED", "WEBHOOK.DELETED", "COLLABORATION.CREATED", "COLLABORATION.ACCEPTED", "COLLABORATION.REJECTED", "COLLABORATION.REMOVED", "COLLABORATION.UPDATED", "SHARED_LINK.DELETED", "SHARED_LINK.CREATED", "SHARED_LINK.UPDATED", "SIGN_REQUEST.COMPLETED", "SIGN_REQUEST.DECLINED", "SIGN_REQUEST.EXPIRED", "SIGN_REQUEST.SIGNER_EMAIL_BOUNCED" ] } } } } } } }, "responses": { "201": { "description": "新しいWebhookオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" } } } }, "400": { "description": "パラメータが正しくなかった場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "アプリケーションにWebhookを管理する権限が付与されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ターゲット項目が見つからなかった場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "同じターゲット、アプリケーション、ユーザーの組み合わせのWebhookがすでに存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/webhooks/{webhook_id}": { "get": { "operationId": "get_webhooks_id", "tags": [ "Webhooks" ], "x-box-tag": "webhooks", "summary": "Webhookを取得", "description": "特定のWebhookを取得します。", "parameters": [ { "name": "webhook_id", "description": "WebhookのID。", "example": "3321123", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Webhookオブジェクトを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" } } } }, "403": { "description": "アプリケーションにWebhookを管理する権限が付与されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "Webhookが見つからなかった場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_webhooks_id", "summary": "Webhookを更新", "tags": [ "Webhooks" ], "x-box-tag": "webhooks", "description": "Webhookを更新します。", "parameters": [ { "name": "webhook_id", "description": "WebhookのID。", "example": "3321123", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "target": { "type": "object", "description": "Webhookをトリガーする項目", "properties": { "id": { "description": "Webhookをトリガーする項目のID", "type": "string", "example": "1231232" }, "type": { "description": "Webhookをトリガーする項目のタイプ", "type": "string", "example": "file", "enum": [ "file", "folder" ] } } }, "address": { "type": "string", "example": "https://example.com/webhooks", "description": "このWebhookによって通知されるURL" }, "triggers": { "type": "array", "example": [ "FILE.UPLOADED" ], "description": "このWebhookがトリガーされるイベント名の配列", "items": { "title": "Webhookトリガー", "example": "FILE.UPLOADED", "type": "string", "description": "このWebhookをトリガーしたイベント名", "enum": [ "FILE.UPLOADED", "FILE.PREVIEWED", "FILE.DOWNLOADED", "FILE.TRASHED", "FILE.DELETED", "FILE.RESTORED", "FILE.COPIED", "FILE.MOVED", "FILE.LOCKED", "FILE.UNLOCKED", "FILE.RENAMED", "COMMENT.CREATED", "COMMENT.UPDATED", "COMMENT.DELETED", "TASK_ASSIGNMENT.CREATED", "TASK_ASSIGNMENT.UPDATED", "METADATA_INSTANCE.CREATED", "METADATA_INSTANCE.UPDATED", "METADATA_INSTANCE.DELETED", "FOLDER.CREATED", "FOLDER.RENAMED", "FOLDER.DOWNLOADED", "FOLDER.RESTORED", "FOLDER.DELETED", "FOLDER.COPIED", "FOLDER.MOVED", "FOLDER.TRASHED", "WEBHOOK.DELETED", "COLLABORATION.CREATED", "COLLABORATION.ACCEPTED", "COLLABORATION.REJECTED", "COLLABORATION.REMOVED", "COLLABORATION.UPDATED", "SHARED_LINK.DELETED", "SHARED_LINK.CREATED", "SHARED_LINK.UPDATED", "SIGN_REQUEST.COMPLETED", "SIGN_REQUEST.DECLINED", "SIGN_REQUEST.EXPIRED", "SIGN_REQUEST.SIGNER_EMAIL_BOUNCED" ] } } } } } } }, "responses": { "200": { "description": "新しいWebhookオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" } } } }, "400": { "description": "パラメータが正しくなかった場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "アプリケーションにWebhookを管理する権限が付与されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ターゲットの項目またはWebhookが見つからなかった場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "同じターゲット、アプリケーション、ユーザーの組み合わせのWebhookがすでに存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_webhooks_id", "summary": "Webhookを削除", "tags": [ "Webhooks" ], "x-box-tag": "webhooks", "description": "Webhookを削除します。", "parameters": [ { "name": "webhook_id", "description": "WebhookのID。", "example": "3321123", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Webhookが正常に削除された場合は、空のレスポンスが返されます。" }, "403": { "description": "アプリケーションにWebhookを管理する権限が付与されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "Webhookが見つからなかった場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/skill_invocations/{skill_id}": { "put": { "operationId": "put_skill_invocations_id", "summary": "ファイルのすべてのBox Skillカードを更新", "tags": [ "Skills" ], "x-box-tag": "skills", "description": "ファイルのすべてのBox Skillメタデータカードを上書きおよび更新するために使用できる代替方法。", "parameters": [ { "name": "skill_id", "description": "このメタデータを適用するスキルのID。", "example": "33243242", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "metadata", "file" ], "properties": { "status": { "type": "string", "description": "この呼び出しのステータスを定義します。スキルカードを設定する際は、`success`に設定します。", "example": "success", "enum": [ "invoked", "processing", "success", "transient_failure", "permanent_failure" ] }, "metadata": { "type": "object", "description": "このスキルに設定するメタデータ。Box Skillsカードのリストです。ファイルの既存のBox Skillsカードはすべてこれらのカードで上書きされます。", "properties": { "cards": { "type": "array", "description": "このファイルに適用するBox Skillカードのリスト。", "items": { "oneOf": [ { "$ref": "#/components/schemas/KeywordSkillCard" }, { "$ref": "#/components/schemas/TimelineSkillCard" }, { "$ref": "#/components/schemas/TranscriptSkillCard" }, { "$ref": "#/components/schemas/StatusSkillCard" } ] } } } }, "file": { "type": "object", "description": "カードを割り当てるファイル。", "properties": { "type": { "type": "string", "description": "`file`", "example": "file", "enum": [ "file" ] }, "id": { "type": "string", "description": "ファイルのID", "example": "3243244" } } }, "file_version": { "type": "object", "description": "カードを割り当てるファイルバージョン (省略可)。", "properties": { "type": { "type": "string", "description": "`file_version`", "example": "file_version", "enum": [ "file_version" ] }, "id": { "type": "string", "description": "ファイルバージョンのID", "example": "731381601045" } } }, "usage": { "type": "object", "description": "この呼び出しの影響を受ける項目を定義する記述子。\n\nカードを`success`状態に設定する場合はこれをデフォルト値に設定し、それ以外のほとんどの場合には省略してください。", "properties": { "unit": { "type": "string", "example": "file", "description": "`file`" }, "value": { "type": "number", "example": 1, "description": "`1`" } } } } } } } }, "responses": { "200": { "description": "ファイルが正常に更新された場合は、空のレスポンスを返します。" }, "400": { "description": "リクエスト本文が無効な場合にエラーを返します。\n\n* `schema_validation_failed` - リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、`enum`または`multiSelect`フィールドに不明なオプションが指定されている場合があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ファイルが見つからないか、ユーザーにアクセス権限がない場合はエラーを返します。\n\n* `not_found` - ファイルが見つからないか、ユーザーがファイルにアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/events": { "options": { "operationId": "options_events", "summary": "イベントのLong pollingエンドポイントを取得", "tags": [ "Events" ], "x-box-tag": "events", "description": "[イベントストリーム](#get-events)へのLong polling更新に使用できるリアルタイムサーバーのリストを返します。\n\nLong pollingとは、サーバーがレスポンスを送信するまでHTTPリクエストを開いたままにしておき、そのプロセスを何度も繰り返して更新されたレスポンスを受信するというコンセプトです。\n\nイベントストリームのLong pollingは、User Eventについてのみ使用でき、Enterprise Eventについては使用できません。\n\nLong pollingを使用するには、最初にこのエンドポイントを使用してLong polling URLのリストを取得します。次に、取得した任意のURLに対してLong pollingリクエストを発行します。\n\n監視対象のアカウントでイベントが発生すると、`new_change`という値を持つレスポンスが送信されます。このレスポンスは、最新の既知の`stream_position`を使用して[eventsエンドポイント](#get-events)にリクエストを送信するなど、さらなるアクションを促すことだけを目的としているため、その他の詳細を含んでいません。\n\nサーバーは、このレスポンスを送信すると接続を閉じます。この時点でイベントのリスト化を再開するには、Long pollingプロセスを繰り返す必要があります。\n\nしばらくイベントが発生せずに接続がタイムアウトになると、`reconnect`という値を持つレスポンスが届きます。このレスポンスを受け取ったら、このエンドポイントを改めて呼び出してプロセスを再開します。\n\n`retry_timeout`の秒数以内にイベントを受信しなかった場合は、リアルタイムサーバー (このエンドポイントのレスポンスに含まれるURLの1つ) に別のリクエストを送信する必要があります。ネットワークエラーが原因で、これを実行しなければならない場合もあります。\n\nまた、リアルタイムサーバーへのリクエスト時に`max_retries`エラーを受信した場合は、まずこのエンドポイントを呼び出してからやり直す必要があります。", "responses": { "200": { "description": "Long pollingイベントの通常のエンドポイントの代わりに使用できるページ割りされたサーバーの配列を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RealtimeServers" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "get": { "operationId": "get_events", "summary": "User EventおよびEnterprise Eventのリストを取得", "tags": [ "Events" ], "x-box-tag": "events", "description": "指定したユーザーまたは会社全体の過去のイベントを最大1年間遡って返します。\n\nデフォルトでは、認証済みユーザーのイベントが返されます。Enterprise全体のイベントを取得するには、`stream_type`を`admin_logs_streaming`に設定して新しいイベントをライブで監視するか、`admin_logs`に設定してイベントの履歴を照会します。このAPIコールを行うユーザーは管理者権限を所有していること、アプリケーションでは`manage enterprise properties`スコープが確認されていることが必要になります。", "parameters": [ { "name": "stream_type", "description": "返されるイベントのタイプを定義します\n\n* `all`を指定すると、ユーザーに関するすべてのイベントが返されます (デフォルト)。\n* `changes`を指定すると、ファイルの更新やコラボレーションなど、ファイルツリーを変更する可能性があるイベントが返されます。\n* `sync`は`changes`に似ていますが、同期対象フォルダのみに適用されます\n* `admin_logs`を指定すると、Enterprise全体のイベントがすべて返されるほか、このAPIコールを行うユーザーには管理者権限が必要になります。このストリームタイプは、Enterprise内の全ユーザーの1年分のイベント履歴や`created_after`から`created_before`までの期間内のイベントをプログラムによってプルすることを目的とします。履歴に含まれるすべてのイベントは、イベントの時刻に基づいて時系列で返されますが、レイテンシは`admin_logs_streaming`よりもかなり高くなります。\n* `admin_logs_streaming`を指定すると、Enterprise全体のイベントがすべて返されるほか、このAPIコールを行うユーザーには管理者権限が必要になります。このストリームタイプは、Enterprise内の全ユーザーの最近のイベントをポーリングすることを目的としています。レイテンシは`admin_logs`よりもかなり低くなりますが、イベントは時系列で返されず、重複を含む場合があります。", "in": "query", "example": "all", "schema": { "type": "string", "default": "all", "enum": [ "all", "changes", "sync", "admin_logs", "admin_logs_streaming" ] } }, { "name": "stream_position", "description": "イベントの受け入れを開始するイベントストリーム内の位置。\n\n* `now`を指定すると、初期化のために空のリストイベントとともに最新のストリーム位置が返されます。\n* `0`または`null`を指定すると、すべてのイベントが返されます。", "example": "1348790499819", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "description": "返されるイベントの数を制限します\n\n注: まだイベントが残っているときでも、返されるイベントの数がリクエストされた制限を下回る場合があります。これは主に、多数のイベントがすでに取得されていて、他に結果があるかどうかを確認するためにこの取得したイベントが先延ばしせずに返される場合に発生します。", "in": "query", "example": 50, "schema": { "type": "integer", "format": "int64", "default": 100, "maximum": 500 } }, { "name": "event_type", "description": "フィルタとして使用するイベントのコンマ区切りリスト。`stream_type`が`admin_logs`または`adming_logs_streaming`のイベントをリクエストする場合にのみ使用できます。`stream_type`がその他の場合、この値は無視されます。", "in": "query", "explode": false, "example": [ "ACCESS_GRANTED" ], "schema": { "type": "array", "items": { "type": "string", "description": "フィルタに使用できるイベントタイプ", "enum": [ "ACCESS_GRANTED", "ACCESS_REVOKED", "ADD_DEVICE_ASSOCIATION", "ADD_LOGIN_ACTIVITY_DEVICE", "ADMIN_LOGIN", "APPLICATION_CREATED", "APPLICATION_PUBLIC_KEY_ADDED", "APPLICATION_PUBLIC_KEY_DELETED", "CHANGE_ADMIN_ROLE", "CHANGE_FOLDER_PERMISSION", "COLLABORATION_ACCEPT", "COLLABORATION_EXPIRATION", "COLLABORATION_INVITE", "COLLABORATION_REMOVE", "COLLABORATION_ROLE_CHANGE", "COMMENT_CREATE", "COMMENT_DELETE", "CONTENT_WORKFLOW_ABNORMAL_DOWNLOAD_ACTIVITY", "CONTENT_WORKFLOW_AUTOMATION_ADD", "CONTENT_WORKFLOW_AUTOMATION_DELETE", "CONTENT_WORKFLOW_POLICY_ADD", "CONTENT_WORKFLOW_SHARING_POLICY_VIOLATION", "CONTENT_WORKFLOW_UPLOAD_POLICY_VIOLATION", "COPY", "DATA_RETENTION_CREATE_RETENTION", "DATA_RETENTION_REMOVE_RETENTION", "DELETE", "DELETE_USER", "DEVICE_TRUST_CHECK_FAILED", "DOWNLOAD", "EDIT", "EDIT_USER", "EMAIL_ALIAS_CONFIRM", "EMAIL_ALIAS_REMOVE", "ENTERPRISE_APP_AUTHORIZATION_UPDATE", "EXTERNAL_COLLAB_SECURITY_SETTINGS", "FAILED_LOGIN", "FILE_MARKED_MALICIOUS", "FILE_WATERMARKED_DOWNLOAD", "GROUP_ADD_ITEM", "GROUP_ADD_USER", "GROUP_CREATION", "GROUP_DELETION", "GROUP_EDITED", "GROUP_REMOVE_ITEM", "GROUP_REMOVE_USER", "ITEM_MODIFY", "ITEM_OPEN", "ITEM_SHARED_UPDATE", "ITEM_SYNC", "ITEM_UNSYNC", "LEGAL_HOLD_ASSIGNMENT_CREATE", "LEGAL_HOLD_ASSIGNMENT_DELETE", "LEGAL_HOLD_POLICY_CREATE", "LEGAL_HOLD_POLICY_DELETE", "LEGAL_HOLD_POLICY_UPDATE", "LOCK", "LOGIN", "METADATA_INSTANCE_CREATE", "METADATA_INSTANCE_DELETE", "METADATA_INSTANCE_UPDATE", "METADATA_TEMPLATE_CREATE", "METADATA_TEMPLATE_DELETE", "METADATA_TEMPLATE_UPDATE", "MOVE", "NEW_USER", "OAUTH2_ACCESS_TOKEN_REVOKE", "PREVIEW", "REMOVE_DEVICE_ASSOCIATION", "REMOVE_LOGIN_ACTIVITY_DEVICE", "RENAME", "RETENTION_POLICY_ASSIGNMENT_ADD", "SHARE", "SHARE_EXPIRATION", "SHIELD_ALERT", "SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED", "SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED_MISSING_JUSTIFICATION", "SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED", "SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED_MISSING_JUSTIFICATION", "SHIELD_JUSTIFICATION_APPROVAL", "SHIELD_SHARED_LINK_ACCESS_BLOCKED", "SHIELD_SHARED_LINK_STATUS_RESTRICTED_ON_CREATE", "SHIELD_SHARED_LINK_STATUS_RESTRICTED_ON_UPDATE", "SIGN_DOCUMENT_ASSIGNED", "SIGN_DOCUMENT_CANCELLED", "SIGN_DOCUMENT_COMPLETED", "SIGN_DOCUMENT_CONVERTED", "SIGN_DOCUMENT_CREATED", "SIGN_DOCUMENT_DECLINED", "SIGN_DOCUMENT_EXPIRED", "SIGN_DOCUMENT_SIGNED", "SIGN_DOCUMENT_VIEWED_BY_SIGNED", "SIGNER_DOWNLOADED", "SIGNER_FORWARDED", "STORAGE_EXPIRATION", "TASK_ASSIGNMENT_CREATE", "TASK_ASSIGNMENT_DELETE", "TASK_ASSIGNMENT_UPDATE", "TASK_CREATE", "TASK_UPDATE", "TERMS_OF_SERVICE_ACCEPT", "TERMS_OF_SERVICE_REJECT", "UNDELETE", "UNLOCK", "UNSHARE", "UPDATE_COLLABORATION_EXPIRATION", "UPDATE_SHARE_EXPIRATION", "UPLOAD", "USER_AUTHENTICATE_OAUTH2_ACCESS_TOKEN_CREATE", "WATERMARK_LABEL_CREATE", "WATERMARK_LABEL_DELETE" ] } } }, { "name": "created_after", "description": "イベントを返す日時の下限。`stream_type`が`admin_logs`のイベントをリクエストする場合にのみ使用できます。`stream_type`がこれ以外の場合、この値は無視されます。", "in": "query", "example": "2012-12-12T10:53:43-08:00", "schema": { "type": "string", "format": "date-time" } }, { "name": "created_before", "description": "イベントを返す日時の上限。`stream_type`が`admin_logs`のイベントをリクエストする場合にのみ使用できます。`stream_type`がこれ以外の場合、この値は無視されます。", "in": "query", "required": false, "example": "2013-12-12T10:53:43-08:00", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "イベントオブジェクトのリストを返します。\n\nイベントオブジェクトは複数のページで返され、各ページ (チャンク) にイベントオブジェクトのリストが含まれます。レスポンスには、このチャンクで返されたイベント数を示す`chunk_size`パラメータに加え、クエリできる次の`stream_position`が含まれます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Events" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collections": { "get": { "operationId": "get_collections", "summary": "すべてのコレクションのリストを取得", "tags": [ "Collections" ], "x-box-tag": "collections", "description": "指定したユーザーのすべてのコレクションを取得します。\n\n現在サポートされているのは、`favorites`コレクションのみです。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "指定したユーザーのすべてのコレクションを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Collections" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collections/{collection_id}/items": { "get": { "operationId": "get_collections_id_items", "summary": "コレクション項目のリストを取得", "tags": [ "Collections" ], "x-box-tag": "collections", "description": "このコレクションに含まれるファイルやフォルダを取得します。", "parameters": [ { "name": "collection_id", "description": "コレクションのID。", "example": "926489", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "offset", "description": "レスポンスが開始される項目のオフセット。\n\nオフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "コレクション内の項目の配列を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Items" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/recent_items": { "get": { "operationId": "get_recent_items", "summary": "最近アクセスした項目のリストを取得", "tags": [ "最近使用した項目" ], "description": "過去90日間、または最大1,000項目まで遡って、ユーザーが最近アクセスした項目に関する情報を返します。", "x-box-tag": "recent_items", "x-box-enable-explorer": true, "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } } ], "responses": { "200": { "description": "最近ユーザーがアクセスした項目のリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecentItems" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policies": { "get": { "operationId": "get_retention_policies", "summary": "リテンションポリシーのリストを取得", "tags": [ "リテンションポリシー" ], "x-box-tag": "retention_policies", "description": "会社のすべてのリテンションポリシーを取得します。", "parameters": [ { "name": "policy_name", "description": "指定したプレフィックスを持つリテンションポリシー名のみに結果を絞り込みます。このフィルタでは大文字と小文字が区別されます。", "in": "query", "required": false, "example": "Sales Policy", "schema": { "type": "string" } }, { "name": "policy_type", "description": "指定したタイプのリテンションポリシーのみに結果を絞り込みます。", "in": "query", "required": false, "example": "finite", "schema": { "type": "string", "enum": [ "finite", "indefinite" ] } }, { "name": "created_by_user_id", "description": "ポリシーを作成したユーザーのIDのみに結果を絞り込みます。", "example": "21312321", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } } ], "responses": { "200": { "description": "企業のリテンションポリシーのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicies" } } } }, "400": { "description": "存在しない`policy_type`が指定された場合は、`bad_request`を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "`created_by_user_id`で指定されたユーザーが存在しない場合は、`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_retention_policies", "summary": "リテンションポリシーを作成", "tags": [ "リテンションポリシー" ], "x-box-tag": "retention_policies", "description": "リテンションポリシーを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "policy_name", "policy_type", "disposition_action" ], "properties": { "policy_name": { "type": "string", "description": "リテンションポリシーの名前", "example": "Some Policy Name" }, "description": { "type": "string", "description": "リテンションポリシーのテキストによる追加の説明。", "example": "Policy to retain all reports for at least one month" }, "policy_type": { "type": "string", "example": "finite", "description": "リテンションポリシーのタイプ。リテンションポリシーのタイプは、`finite` (コンテンツを保持する期間が事前にわかっている場合)、または`indefinite` (コンテンツを保持する期間が不明な場合) のいずれかになります。", "enum": [ "finite", "indefinite" ] }, "disposition_action": { "type": "string", "example": "permanently_delete", "description": "リテンションポリシーの廃棄アクション。`permanently_delete`に設定すると、ポリシーによって保持されているコンテンツが完全に削除されます。`remove_retention`に設定すると、コンテンツへのリテンションポリシーの適用が解除され、リテンションポリシーの有効期限が切れた後は、ユーザーがコンテンツを削除できるようになります。", "enum": [ "permanently_delete", "remove_retention" ] }, "retention_length": { "oneOf": [ { "type": "string", "format": "int32", "nullable": true }, { "type": "number", "format": "int32", "nullable": false } ], "example": "365", "description": "リテンションポリシーの期間。この値はリテンションポリシーがコンテンツに割り当てられた後、有効である日数を示します。ポリシーの`policy_type`が`indefinite`である場合は、`retention_length`も`indefinite`になります。" }, "retention_type": { "type": "string", "example": "modifiable", "description": "以下のリテンションの種類を指定します。\n\n* `modifiable`: リテンションポリシーを変更できます。たとえば、フォルダの追加と削除、ポリシー期間の短縮と延長、または割り当ての削除を行うことができます。リテンションポリシーが規制目的に関連していない場合はこの種類を使用してください。\n\n* `non_modifiable`: フォルダの追加、期間の延長、ポリシーの撤回、廃棄アクションまたは通知設定の変更という限られた方法でしかリテンションポリシーを変更できません。割り当ての削除やポリシー期間の短縮など、その他の操作は実行できません。規制に関するリテンションポリシーを確実に遵守する場合はこの種類を使用してください。", "enum": [ "modifiable", "non_modifiable" ] }, "can_owner_extend_retention": { "type": "boolean", "enum": [ true, false ], "example": true, "description": "ファイルの所有者がリテンションを延長できるかどうか。" }, "are_owners_notified": { "type": "boolean", "enum": [ true, false ], "example": true, "description": "ポリシーの有効期限が近付いたときにファイルの所有者と共同所有者に通知するかどうか。" }, "custom_notification_recipients": { "type": "array", "description": "リテンションポリシーの期間が終了に近づいたときに通知されるユーザーのリスト。", "items": { "$ref": "#/components/schemas/User--Mini" } } } } } } }, "responses": { "201": { "description": "新しいリテンションポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicy" } } } }, "400": { "description": "`infinite`リテンションポリシーに`retention_length`が指定された場合、誤った`disposition_action`が設定された場合、または説明の文字数が上限の500文字を超える場合は、`bad_request`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "指定した名前を持つリテンションポリシーがすでに存在する場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policies/{retention_policy_id}": { "get": { "operationId": "get_retention_policies_id", "summary": "リテンションポリシーを取得", "tags": [ "リテンションポリシー" ], "x-box-tag": "retention_policies", "description": "リテンションポリシーを取得します。", "parameters": [ { "name": "retention_policy_id", "description": "リテンションポリシーのID。", "example": "982312", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "リテンションポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicy" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_retention_policies_id", "summary": "リテンションポリシーを更新", "tags": [ "リテンションポリシー" ], "x-box-tag": "retention_policies", "description": "リテンションポリシーを更新します。", "parameters": [ { "name": "retention_policy_id", "description": "リテンションポリシーのID。", "example": "982312", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "policy_name": { "type": "string", "description": "リテンションポリシーの名前", "example": "Some Policy Name", "nullable": true }, "description": { "type": "string", "description": "リテンションポリシーのテキストによる追加の説明。", "example": "Policy to retain all reports for at least one month", "nullable": true }, "disposition_action": { "anyOf": [ { "type": "string", "enum": [ "permanently_delete", "remove_retention" ] }, { "type": "string", "pattern": ".^", "nullable": true } ], "description": "リテンションポリシーの廃棄アクション。このアクションを`permanently_delete`に設定すると、ポリシーによって保持されているコンテンツが完全に削除されます。`remove_retention`に設定すると、コンテンツへのリテンションポリシーの適用が解除され、リテンションポリシーの有効期限が切れた後は、ユーザーがコンテンツを削除できるようになります。`disposition_action`を変更しない場合は「null」を使用できます。", "example": "permanently_delete" }, "retention_type": { "type": "string", "example": "non-modifiable", "nullable": true, "description": "以下のリテンションの種類を指定します。\n\n* `modifiable`: リテンションポリシーを変更できます。たとえば、フォルダの追加と削除、ポリシー期間の短縮と延長、または割り当ての削除を行うことができます。リテンションポリシーが規制目的に関連していない場合はこの種類を使用してください。\n* `non-modifiable`: フォルダの追加、期間の延長、ポリシーの撤回、廃棄アクションまたは通知設定の変更という限られた方法でしかリテンションポリシーを変更できません。割り当ての削除やポリシー期間の短縮など、その他の操作は実行できません。規制に関するリテンションポリシーを確実に遵守する場合はこの種類を使用してください。\n\nリテンションポリシーを更新する際は、`non-modifiable`の種類のみを使用できます。`modifiable`ポリシーを`non-modifiable`に変換することはできますが、その逆はできません。" }, "retention_length": { "oneOf": [ { "type": "string", "format": "int32", "nullable": true }, { "type": "number", "format": "int32", "nullable": false } ], "example": "365", "description": "リテンションポリシーの期間。この値はリテンションポリシーがコンテンツに割り当てられた後、有効である日数を示します。ポリシーの`policy_type`が`indefinite`である場合は、`retention_length`も`indefinite`になります。" }, "status": { "type": "string", "example": "retired", "nullable": true, "description": "リテンションポリシーを撤回する場合に使用します。\n\nポリシーを撤回しない場合は、このパラメータを含めないようにするか、 このパラメータを`null`に設定します。" }, "can_owner_extend_retention": { "type": "boolean", "nullable": true, "description": "元のリテンション期間が終了に近づいたときに、ポリシーが適用されている項目の所有者がリテンションを延長できるかどうかを決定します。", "example": false }, "are_owners_notified": { "type": "boolean", "nullable": true, "description": "リテンション期間が終了に近づいたときに、ポリシーが適用されている項目の所有者と共同所有者に通知するかどうかを決定します。", "example": false }, "custom_notification_recipients": { "type": "array", "nullable": true, "description": "リテンション期間が終了に近づいたときに通知されるユーザーのリスト。", "items": { "$ref": "#/components/schemas/User--Base" } } } } } } }, "responses": { "200": { "description": "更新されたリテンションポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicy" } } } }, "400": { "description": "誤った`disposition_action`が設定された場合、または説明の文字数が上限の500文字を超える場合は、`bad_request`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "ユーザーが、変更不可ポリシーの期間を短縮しようとする場合または変更不可ポリシーを変更可能ポリシーに変換しようとする場合にエラーを返します。注: ポリシー期間の延長は許可されています。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "指定した名前を持つリテンションポリシーがすでに存在する場合は、エラーを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_retention_policies_id", "summary": "リテンションポリシーを削除", "tags": [ "リテンションポリシー" ], "x-box-tag": "retention_policies", "description": "リテンションポリシーを完全に削除します。", "parameters": [ { "name": "retention_policy_id", "description": "リテンションポリシーのID。", "example": "982312", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ポリシーが削除された場合は、空のレスポンスを返します。" }, "403": { "description": "ポリシーが変更不可の場合、またはユーザーにこのアクションを実行するために必要なアクセス権限がない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ポリシーが見つからない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policies/{retention_policy_id}/assignments": { "get": { "operationId": "get_retention_policies_id_assignments", "summary": "リテンションポリシー割り当てのリストを取得", "tags": [ "リテンションポリシー割り当て" ], "x-box-tag": "retention_policy_assignments", "description": "指定したリテンションポリシーに関連付けられているすべてのリテンションポリシー割り当てのリストを返します。", "parameters": [ { "name": "retention_policy_id", "description": "リテンションポリシーのID。", "example": "982312", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "type", "description": "取得するリテンションポリシー割り当てのタイプ。", "in": "query", "required": false, "example": "metadata_template", "schema": { "type": "string", "enum": [ "folder", "enterprise", "metadata_template" ] } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "指定したリテンションポリシーに関連付けられているリテンションポリシー割り当てのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicyAssignments" } } } }, "400": { "description": "不明な`type`が指定された場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policy_assignments": { "post": { "operationId": "post_retention_policy_assignments", "summary": "リテンションポリシーを割り当て", "tags": [ "リテンションポリシー割り当て" ], "x-box-tag": "retention_policy_assignments", "description": "リテンションポリシーを項目に割り当てます。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "policy_id", "assign_to" ], "properties": { "policy_id": { "type": "string", "description": "割り当てるリテンションポリシーのID", "example": "173463" }, "assign_to": { "type": "object", "description": "ポリシーを割り当てる項目", "required": [ "type" ], "properties": { "type": { "type": "string", "description": "ポリシーを割り当てる項目のタイプ。", "example": "metadata_template", "enum": [ "enterprise", "folder", "metadata_template" ] }, "id": { "type": "string", "nullable": true, "description": "ポリシーを割り当てる項目のID。`type`が`enterprise`に設定されている場合は、`null`に設定するか省略します。", "example": "6564564" } } }, "filter_fields": { "type": "array", "description": "`assign_to`のタイプが`metadata_template`の場合は、必要に応じて`filter_fields`パラメータを追加します。このパラメータには、フィールドエントリと値エントリを含むオブジェクトの配列が必要になります。現在、`field`および`value`のオブジェクトは1つだけサポートされています。", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "メタデータ属性キーID。", "example": "a0f4ee4e-1dc1-4h90-a8a9-aef55fc681d4" }, "value": { "type": "string", "description": "メタデータ属性フィールドID。値については、列挙型とmultiselect型のみがサポートされています。", "example": "0c27b756-0p87-4fe0-a43a-59fb661ccc4e" } } } }, "start_date_field": { "description": "リテンションポリシー割り当ての開始日。\n\n`assigned_to`のタイプが`metadata_template`の場合、このフィールドには、日付フィールドのメタデータ属性キーIDを指定できます。", "type": "string", "example": "upload_date" } } } } } }, "responses": { "201": { "description": "新しいリテンションポリシー割り当てオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicyAssignment" } } } }, "400": { "description": "企業にリテンションポリシーを割り当てている最中に`id`が指定された場合は、エラーを返します。\n\n`start_date_field`が存在するものの、`assign_to.type`が`metadata_template`でない場合は、エラーを返します。\n\n`start_date_field`が存在するものの、`assign_to.id`で指定されたものとは異なるメタデータテンプレートに属している場合は、エラーを返します。\n\n`start_date_field`が存在するものの、`retention_policy`の`retention_length`が「indefinite」である場合は、エラーを返します。\n\n`start_date_field`が存在するものの、有効なメタデータの日付フィールドに解決できない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "指定した`policy_id`を持つリテンションポリシーが存在しない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "期間が同じであるか、それよりも長いリテンションポリシーがこの項目にすでに割り当てられている場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policy_assignments/{retention_policy_assignment_id}": { "get": { "operationId": "get_retention_policy_assignments_id", "summary": "リテンションポリシー割り当てを取得", "tags": [ "リテンションポリシー割り当て" ], "x-box-tag": "retention_policy_assignments", "description": "リテンションポリシー割り当てを取得します。", "parameters": [ { "name": "retention_policy_assignment_id", "description": "リテンションポリシー割り当てのID。", "example": "1233123", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "リテンションポリシー割り当てオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicyAssignment" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_retention_policy_assignments_id", "summary": "リテンションポリシー割り当てを削除", "tags": [ "リテンションポリシー割り当て" ], "x-box-tag": "retention_policy_assignments", "description": "コンテンツに適用されたリテンションポリシー割り当てを削除します。", "parameters": [ { "name": "retention_policy_assignment_id", "description": "リテンションポリシー割り当てのID。", "example": "1233123", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ポリシー割り当てが正常に削除された場合は、空のレスポンスを返します。" }, "403": { "description": "変更できないリテンションポリシーに割り当てが関連する場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "リテンションポリシー割り当てが存在しない場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policy_assignments/{retention_policy_assignment_id}/files_under_retention": { "get": { "operationId": "get_retention_policy_assignments_id_files_under_retention", "summary": "リテンションの対象となるファイルを取得", "tags": [ "リテンションポリシー割り当て" ], "x-box-tag": "retention_policy_assignments", "description": "リテンションポリシー割り当てのために、リテンションの対象となるファイルのリストを返します。", "parameters": [ { "name": "retention_policy_assignment_id", "description": "リテンションポリシー割り当てのID。", "example": "1233123", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "指定したリテンションポリシー割り当てに関連付けられている、リテンションの対象となるファイルのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilesUnderRetention" } } } }, "400": { "description": "`retention_policy_assignment_id`が指定されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/retention_policy_assignments/{retention_policy_assignment_id}/file_versions_under_retention": { "get": { "operationId": "get_retention_policy_assignments_id_file_versions_under_retention", "summary": "リテンションの対象となるファイルバージョンを取得", "tags": [ "リテンションポリシー割り当て" ], "x-box-tag": "retention_policy_assignments", "description": "リテンションポリシー割り当てのために、リテンションの対象となるファイルバージョンのリストを返します。", "parameters": [ { "name": "retention_policy_assignment_id", "description": "リテンションポリシー割り当てのID。", "example": "1233123", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "指定したリテンションポリシー割り当てに関連付けられている、リテンションの対象となるファイルバージョンのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilesUnderRetention" } } } }, "400": { "description": "`retention_policy_assignment_id`が指定されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/legal_hold_policies": { "get": { "operationId": "get_legal_hold_policies", "summary": "すべてのリーガルホールドポリシーのリストを取得", "tags": [ "リーガルホールドポリシー" ], "x-box-tag": "legal_hold_policies", "description": "会社に属するリーガルホールドポリシーのリストを取得します。", "parameters": [ { "name": "policy_name", "description": "名前がこの検索語で始まるポリシーのみに結果を絞り込みます。このフィルタではプレフィックスを指定します。大文字と小文字は区別されません。", "in": "query", "example": "Sales Policy", "required": false, "schema": { "type": "string" } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "リーガルホールドポリシーのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicies" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_legal_hold_policies", "summary": "リーガルホールドポリシーを作成", "tags": [ "リーガルホールドポリシー" ], "x-box-tag": "legal_hold_policies", "description": "新しいリーガルホールドポリシーを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "policy_name" ], "properties": { "policy_name": { "description": "ポリシーの名前。", "example": "Sales Policy", "type": "string", "maxLength": 254 }, "description": { "description": "ポリシーの説明。", "example": "A custom policy for the sales team", "type": "string", "maxLength": 500 }, "filter_started_at": { "description": "フィルタの開始日。\n\n`custodian`のリーガルホールド割り当てを使用してこのポリシーが適用されている場合は、日付範囲内に作成またはアップロードされたファイルバージョンのみに適用されます。フォルダやファイルなど、他の割り当てタイプの場合、日付フィルタは無視されます。\n\n`is_ongoing`が`false`に設定されている場合は必須です。", "example": "2012-12-12T10:53:43-08:00", "type": "string", "maxLength": 500, "format": "date-time" }, "filter_ended_at": { "description": "フィルタの終了日。\n\n`custodian`のリーガルホールド割り当てを使用してこのポリシーが適用されている場合は、日付範囲内に作成またはアップロードされたファイルバージョンのみに適用されます。フォルダやファイルなど、他の割り当てタイプの場合、日付フィルタは無視されます。\n\n`is_ongoing`が`false`に設定されている場合は必須です。", "example": "2012-12-18T10:53:43-08:00", "type": "string", "maxLength": 500, "format": "date-time" }, "is_ongoing": { "description": "このポリシーに基づく新しい割り当てを初期化後のファイルにも引き続き適用するかどうか。\n\nリーガルホールド割り当てを使用してこのポリシーを適用した場合は、ポリシーの適用後も同じポリシーが新しいファイルバージョンに引き続き適用されます。\n\nたとえば、今日リーガルホールド割り当てをユーザーに適用し、そのユーザーが明日ファイルをアップロードした場合、そのファイルは保持されます。これは、ポリシーが撤回されるまで継続されます。\n\nフィルタ日付が設定されていない場合は必須です。", "example": true, "type": "boolean" } } } } } }, "responses": { "201": { "description": "新しいリーガルホールドポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicy" } } } }, "400": { "description": "必須のパラメータが指定されていない場合や、`is_ongoing`もフィルタの日付も指定されていない場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "この名前のポリシーがすでに存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/legal_hold_policies/{legal_hold_policy_id}": { "get": { "operationId": "get_legal_hold_policies_id", "summary": "リーガルホールドポリシーを取得", "tags": [ "リーガルホールドポリシー" ], "x-box-tag": "legal_hold_policies", "description": "リーガルホールドポリシーを取得します。", "parameters": [ { "name": "legal_hold_policy_id", "description": "リーガルホールドポリシーのID", "example": "324432", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "リーガルホールドポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicy" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_legal_hold_policies_id", "summary": "リーガルホールドポリシーを更新", "tags": [ "リーガルホールドポリシー" ], "x-box-tag": "legal_hold_policies", "description": "リーガルホールドポリシーを更新します。", "parameters": [ { "name": "legal_hold_policy_id", "description": "リーガルホールドポリシーのID", "example": "324432", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "policy_name": { "description": "ポリシーの名前。", "example": "Sales Policy", "type": "string", "maxLength": 254 }, "description": { "description": "ポリシーの説明。", "example": "A custom policy for the sales team", "type": "string", "maxLength": 500 }, "release_notes": { "description": "ポリシーが解除された理由に関するメモ。", "example": "Required for GDPR", "type": "string", "maxLength": 500 } } } } } }, "responses": { "200": { "description": "新しいリーガルホールドポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicy" } } } }, "409": { "description": "この名前のポリシーがすでに存在する場合は、エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_legal_hold_policies_id", "x-box-tag": "legal_hold_policies", "tags": [ "リーガルホールドポリシー" ], "summary": "リーガルホールドポリシーを削除", "description": "既存のリーガルホールドポリシーを削除します。\n\nこれは非同期的プロセスです。レスポンスの返された時点では、ポリシーはまだ完全には削除されていません。", "parameters": [ { "name": "legal_hold_policy_id", "description": "リーガルホールドポリシーのID", "example": "324432", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "ポリシーが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/legal_hold_policy_assignments": { "get": { "operationId": "get_legal_hold_policy_assignments", "summary": "リーガルホールドポリシー割り当てのリストを取得", "tags": [ "リーガルホールドポリシー割り当て" ], "x-box-tag": "legal_hold_policy_assignments", "description": "リーガルホールドポリシーが割り当てられている項目のリストを取得します。", "parameters": [ { "name": "policy_id", "description": "リーガルホールドポリシーのID", "example": "324432", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "assign_to_type", "description": "ポリシーが適用されている項目のタイプのみに結果を絞り込みます。", "example": "file", "in": "query", "schema": { "type": "string", "enum": [ "file", "file_version", "folder", "user" ] } }, { "name": "assign_to_id", "description": "ポリシーが割り当てられている項目のIDのみに結果を絞り込みます。", "example": "1234323", "in": "query", "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "リーガルホールドポリシー割り当てのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicyAssignments" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_legal_hold_policy_assignments", "summary": "リーガルホールドポリシーを割り当て", "tags": [ "リーガルホールドポリシー割り当て" ], "x-box-tag": "legal_hold_policy_assignments", "description": "ファイル、ファイルバージョン、フォルダ、またはユーザーにリーガルホールドを割り当てます。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "policy_id", "assign_to" ], "properties": { "policy_id": { "description": "割り当てるポリシーのID。", "example": "123244", "type": "string" }, "assign_to": { "type": "object", "description": "ポリシーを割り当てる項目", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "description": "ポリシーを割り当てる項目のタイプ", "example": "folder", "enum": [ "file", "file_version", "folder", "user" ] }, "id": { "type": "string", "description": "ポリシーを割り当てる項目のID", "example": "6564564" } } } } } } } }, "responses": { "201": { "description": "新しいリーガルホールドポリシー割り当てを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicyAssignment" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/legal_hold_policy_assignments/{legal_hold_policy_assignment_id}": { "get": { "operationId": "get_legal_hold_policy_assignments_id", "summary": "リーガルホールドポリシー割り当てを取得", "tags": [ "リーガルホールドポリシー割り当て" ], "x-box-tag": "legal_hold_policy_assignments", "description": "リーガルホールドポリシー割り当てを取得します。", "parameters": [ { "name": "legal_hold_policy_assignment_id", "description": "リーガルホールドポリシー割り当てのID", "example": "753465", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "リーガルホールドポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldPolicyAssignment" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_legal_hold_policy_assignments_id", "x-box-tag": "legal_hold_policy_assignments", "tags": [ "リーガルホールドポリシー割り当て" ], "summary": "リーガルホールドポリシーの割り当てを解除", "description": "項目からリーガルホールドを削除します。\n\nこれは非同期的プロセスです。レスポンスが返された時点では、ポリシーはまだ完全には削除されていません。", "parameters": [ { "name": "legal_hold_policy_assignment_id", "description": "リーガルホールドポリシー割り当てのID", "example": "753465", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "割り当てが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/legal_hold_policy_assignments/{legal_hold_policy_assignment_id}/files_on_hold": { "get": { "operationId": "get_legal_hold_policy_assignments_id_files_on_hold", "summary": "リーガルホールドポリシー割り当てに関する現在のファイルバージョンのリストを取得", "tags": [ "リーガルホールドポリシー割り当て" ], "x-box-tag": "legal_hold_policy_assignments", "description": "リーガルホールド割り当てに関する現在のファイルバージョンのリストを取得します。\n\n場合によっては、代わりに以前のファイルバージョンを取得できます。このような場合は、代わりに`GET /legal_hold_policy_assignments/:id/file_versions_on_hold` APIを使用すると、このリーガルホールドポリシー割り当てに関するファイルの以前のバージョンが返されます。\n\n進行中の再構築作業により、このAPIでは、このポリシーID用に保持されているすべてのファイルバージョンが返されない場合があります。代わりに、このAPIで返されるのは、新しく開発されたアーキテクチャで保持されている最新のファイルバージョンのみです。`GET\n/file_version_legal_holds` APIを使用すると、従来のアーキテクチャ内で保持されているファイルの現在のバージョンと過去のバージョンを取得できます。\n\n`GET /legal_hold_policy_assignments?policy_id={id}` APIを使用すると、指定したポリシーIDのポリシー割り当てのリストを確認できます。", "parameters": [ { "name": "legal_hold_policy_assignment_id", "description": "リーガルホールドポリシー割り当てのID", "example": "753465", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "特定のリーガルホールドポリシー割り当てに関する、リーガルホールドで保持されている現在のファイルバージョンのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersionLegalHolds" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/file_version_retentions": { "get": { "operationId": "get_file_version_retentions", "tags": [ "ファイルバージョンリテンション" ], "x-box-tag": "file_version_retentions", "summary": "ファイルバージョンリテンションのリストを取得", "description": "指定した会社のすべてのファイルバージョンリテンションを取得します。", "parameters": [ { "name": "file_id", "description": "このIDを持つファイルのみに結果を絞り込みます。", "in": "query", "example": "43123123", "required": false, "schema": { "type": "string" } }, { "name": "file_version_id", "description": "このIDを持つファイルバージョンのみに結果を絞り込みます。", "in": "query", "example": "1", "required": false, "schema": { "type": "string" } }, { "name": "policy_id", "description": "このIDを持つリテンションポリシーのみに結果を絞り込みます。", "in": "query", "required": false, "example": "982312", "schema": { "type": "string" } }, { "name": "disposition_action", "description": "この廃棄アクションを使用するリテンションポリシーのみに結果を絞り込みます。", "in": "query", "required": false, "example": "permanently_delete", "schema": { "type": "string", "enum": [ "permanently_delete", "remove_retention" ] } }, { "name": "disposition_before", "description": "この日付の前に廃棄が有効になるファイルのみに結果を絞り込みます。", "in": "query", "required": false, "example": "2012-12-12T10:53:43-08:00", "schema": { "type": "string" } }, { "name": "disposition_after", "description": "この日付の後で廃棄が有効になるファイルのみに結果を絞り込みます。", "in": "query", "required": false, "example": "2012-12-19T10:34:23-08:00", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } } ], "responses": { "200": { "description": "会社のすべてのファイルバージョンリテンションのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersionRetentions" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/legal_hold_policy_assignments/{legal_hold_policy_assignment_id}/file_versions_on_hold": { "get": { "operationId": "get_legal_hold_policy_assignments_id_file_versions_on_hold", "summary": "リーガルホールドポリシー割り当てに関する以前のファイルバージョンのリストを取得", "tags": [ "リーガルホールドポリシー割り当て" ], "x-box-tag": "legal_hold_policy_assignments", "description": "リーガルホールド割り当てに関する以前のファイルバージョンのリストを取得します。\n\n場合によっては、代わりに最新のファイルバージョンのみが必要になることもあります。このような場合は、代わりに`GET /legal_hold_policy_assignments/:id/files_on_hold` APIを使用すると、このリーガルホールドポリシー割り当てに関するファイルの現在 (最新) のバージョンが返されます。\n\n進行中の再構築作業により、このAPIでは、このポリシーIDの保持されているファイルがすべて返されるとは限りません。代わりに、このAPIで返されるのは、新しく開発されたアーキテクチャで保持されている過去のファイルバージョンのみです。`GET /file_version_legal_holds` APIを使用すると、従来のアーキテクチャ内で保持されているファイルの現在のバージョンと過去のバージョンを取得できます。\n\n`GET /legal_hold_policy_assignments?policy_id={id}` APIを使用すると、指定したポリシーIDのポリシー割り当てのリストを確認できます。", "parameters": [ { "name": "legal_hold_policy_assignment_id", "description": "リーガルホールドポリシー割り当てのID", "example": "753465", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "特定のリーガルホールドポリシー割り当てに関する、リーガルホールドで保持されている以前のファイルバージョンのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersionLegalHolds" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/file_version_retentions/{file_version_retention_id}": { "get": { "operationId": "get_file_version_retentions_id", "tags": [ "ファイルバージョンリテンション" ], "x-box-tag": "file_version_retentions", "summary": "ファイルのリテンションを取得", "description": "ファイルバージョンリテンションに関する情報を返します。", "parameters": [ { "name": "file_version_retention_id", "description": "ファイルバージョンリテンションのID", "in": "path", "required": true, "example": "3424234", "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルバージョンリテンションオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersionRetention" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/file_version_legal_holds/{file_version_legal_hold_id}": { "get": { "operationId": "get_file_version_legal_holds_id", "summary": "ファイルバージョンのリーガルホールドを取得", "tags": [ "ファイルバージョンのリーガルホールド" ], "x-box-tag": "file_version_legal_holds", "description": "ファイルバージョンに割り当てられているリーガルホールドポリシーに関する情報を取得します。", "parameters": [ { "name": "file_version_legal_hold_id", "description": "ファイルバージョンリーガルホールドのID", "in": "path", "required": true, "example": "2348213", "schema": { "type": "string" } } ], "responses": { "200": { "description": "ファイルバージョンのリーガルホールドポリシー割り当てを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersionLegalHold" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/file_version_legal_holds": { "get": { "operationId": "get_file_version_legal_holds", "summary": "ファイルバージョンのリーガルホールドのリストを取得", "tags": [ "ファイルバージョンのリーガルホールド" ], "x-box-tag": "file_version_legal_holds", "description": "リーガルホールド割り当てに関する、リーガルホールドのファイルバージョンのリストを取得します。\n\n進行中の再構築作業により、このAPIでは、このポリシーIDのファイルバージョンがすべて返されるとは限りません。\n\n代わりに、このAPIで返されるのは、従来のアーキテクチャで保持されているファイルバージョンのみです。新しいアーキテクチャで保持されているすべてのファイルバージョンをリクエストするために2つの新しいエンドポイントが使用可能になります。\n\n新しいアーキテクチャで保持されるファイルバージョンについては、`GET\n/legal_hold_policy_assignments/:id/file_versions_on_hold` APIを使用すると、このポリシー割り当てに使用できる過去のファイルバージョンをすべて返すことができます。また、`GET /legal_hold_policy_assignments/:id/files_on_hold` APIを使用すると、リーガルホールドの対象となるファイルの現在 (最新) バージョンを返すこともできます。\n\n`GET /legal_hold_policy_assignments?policy_id={id}` APIを使用すると、指定したポリシーIDのポリシー割り当てのリストを確認できます。\n\n再構築が完了すると、このAPIは非推奨になります。", "parameters": [ { "name": "policy_id", "description": "ファイルバージョンのリーガルホールドを取得するためのリーガルホールドポリシーのID。", "in": "query", "example": "133870", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "特定のリーガルホールドポリシーに関する、ファイルバージョンリーガルホールドのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileVersionLegalHolds" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barriers/{shield_information_barrier_id}": { "get": { "operationId": "get_shield_information_barriers_id", "summary": "指定したIDのShield情報バリアを取得", "tags": [ "Shield情報バリア" ], "x-box-tag": "shield_information_barriers", "description": "指定されたIDに基づいてShield情報バリアを取得します。", "parameters": [ { "name": "shield_information_barrier_id", "description": "Shield情報バリアのID。", "example": "1910967", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Shield情報バリアオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrier" } } } }, "404": { "description": "Shield情報バリアが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barriers/change_status": { "post": { "operationId": "post_shield_information_barriers_change_status", "summary": "指定したIDのShield情報バリアの変更されたステータスを追加", "tags": [ "Shield情報バリア" ], "x-box-tag": "shield_information_barriers", "description": "指定されたIDのShield情報バリアのステータスを変更します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "status" ], "properties": { "id": { "type": "string", "example": "1910967", "description": "Shield情報バリアのID。" }, "status": { "type": "string", "enum": [ "pending", "disabled" ], "example": "pending", "description": "Shield情報バリアの任意のステータス。" } } } } } }, "responses": { "200": { "description": "更新されたShield情報バリアオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrier" } } } }, "404": { "description": "Shield情報バリアが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "既存の情報バリアとの競合が存在する場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barriers": { "get": { "operationId": "get_shield_information_barriers", "summary": "Shield情報バリアのリストを取得", "tags": [ "Shield情報バリア" ], "x-box-tag": "shield_information_barriers", "description": "JWTを使用している企業のShield情報バリアオブジェクトのリストを取得します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "Shield情報バリアオブジェクトのページ割りされたリストを返します。現在バリアがない場合は空のリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarriers" } } } }, "404": { "description": "JWTを使用している企業が見つからない場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_shield_information_barriers", "summary": "Shield情報バリアを作成", "tags": [ "Shield情報バリア" ], "x-box-tag": "shield_information_barriers", "description": "Shield情報バリアを作成して、同じ会社内で個人/グループを分離し、機密情報が互いにやり取りされるのを防ぎます。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "enterprise": { "allOf": [ { "$ref": "#/components/schemas/Enterprise--Base" } ], "description": "このバリアが配置されている企業の`type`と`id`。" } }, "required": [ "enterprise" ] } } } }, "responses": { "201": { "description": "新しいShield情報バリアオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrier" } } } }, "404": { "description": "企業が見つからない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_reports": { "get": { "operationId": "get_shield_information_barrier_reports", "summary": "Shield情報バリアレポートのリストを取得", "tags": [ "Shield情報バリアレポート" ], "x-box-tag": "shield_information_barrier_reports", "description": "Shield情報バリアレポートのリストを取得します。", "parameters": [ { "name": "shield_information_barrier_id", "description": "Shield情報バリアのID。", "example": "1910967", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "Shield情報バリアレポートオブジェクトのページ割りされたリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierReports" } } } }, "404": { "description": "Shield情報バリアが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_shield_information_barrier_reports", "summary": "Shield情報バリアレポートを作成", "tags": [ "Shield情報バリアレポート" ], "x-box-tag": "shield_information_barrier_reports", "description": "指定されたバリアのShield情報バリアレポートを作成します。", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierReference" } } } }, "responses": { "201": { "description": "Shield情報バリアレポートの情報オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierReport" } } } }, "404": { "description": "Shield情報バリアレポートが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "Shield情報バリアレポートが現在作成中の場合は`conflict`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_reports/{shield_information_barrier_report_id}": { "get": { "operationId": "get_shield_information_barrier_reports_id", "summary": "IDを指定してShield情報バリアレポートを取得", "tags": [ "Shield情報バリアレポート" ], "x-box-tag": "shield_information_barrier_reports", "description": "IDを指定してShield情報バリアレポートを取得します。", "parameters": [ { "name": "shield_information_barrier_report_id", "description": "Shield情報バリアレポートのID。", "example": "3423", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Shield情報バリアレポートオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierReport" } } } }, "404": { "description": "Shield情報バリアレポートが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_segments/{shield_information_barrier_segment_id}": { "get": { "operationId": "get_shield_information_barrier_segments_id", "summary": "指定したIDのShield情報バリアのセグメントを取得", "tags": [ "Shield情報バリアのセグメント" ], "x-box-tag": "shield_information_barrier_segments", "description": "指定されたIDに基づいてShield情報バリアのセグメントを取得します。", "parameters": [ { "name": "shield_information_barrier_segment_id", "description": "Shield情報バリアのセグメントのID。", "example": "3423", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Shield情報バリアのセグメントオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegment" } } } }, "404": { "description": "Shield情報バリアのセグメントが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_shield_information_barrier_segments_id", "summary": "Shield情報バリアのセグメントを削除", "tags": [ "Shield情報バリアのセグメント" ], "x-box-tag": "shield_information_barrier_segments", "description": "指定されたIDに基づいてShield情報バリアのセグメントを削除します。", "parameters": [ { "name": "shield_information_barrier_segment_id", "description": "Shield情報バリアのセグメントのID。", "example": "3423", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "204": { "description": "レスポンスの本文は空です。" }, "404": { "description": "指定されたIDのShield情報バリアのセグメントが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_shield_information_barrier_segments_id", "summary": "指定したIDのShield情報バリアのセグメントを更新", "tags": [ "Shield情報バリアのセグメント" ], "x-box-tag": "shield_information_barrier_segments", "description": "指定されたIDに基づいてShield情報バリアのセグメントを更新します。", "parameters": [ { "name": "shield_information_barrier_segment_id", "description": "Shield情報バリアのセグメントのID。", "example": "3423", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "description": "Shield情報バリアのセグメントに対して行われる更新を含むオブジェクト。使用可能なプロパティには「name」と「description」があり、オブジェクトの値が更新内容となります。", "properties": { "name": { "type": "string", "pattern": "\\S+", "example": "Investment Banking", "description": "Shield情報バリアのセグメントの更新した名前。" }, "description": { "type": "string", "nullable": true, "example": "'Corporate division that engages in advisory_based\nfinancial transactions on behalf of individuals,\ncorporations, and governments.'", "description": "Shield情報バリアのセグメントの更新した説明。" } } } } } }, "responses": { "200": { "description": "更新されたShield情報バリアのセグメントオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegment" } } } }, "404": { "description": "Shield情報バリアのセグメントが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "同じ名前のShield情報バリアのセグメントが存在する場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_segments": { "get": { "operationId": "get_shield_information_barrier_segments", "summary": "Shield情報バリアのセグメントのリストを取得", "tags": [ "Shield情報バリアのセグメント" ], "x-box-tag": "shield_information_barrier_segments", "description": "指定した情報バリアIDのShield情報バリアのセグメントオブジェクトのリストを取得します。", "parameters": [ { "name": "shield_information_barrier_id", "description": "Shield情報バリアのID。", "example": "1910967", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "Shield情報バリアのセグメントオブジェクトのページ割りされたリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegments" } } } }, "404": { "description": "指定されたIDのShield情報バリアが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_shield_information_barrier_segments", "summary": "Shield情報バリアのセグメントを作成", "tags": [ "Shield情報バリアのセグメント" ], "x-box-tag": "shield_information_barrier_segments", "description": "Shield情報バリアのセグメントを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "shield_information_barrier", "name" ], "properties": { "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" }, "name": { "type": "string", "example": "Investment Banking", "description": "Shield情報バリアのセグメントの名前" }, "description": { "type": "string", "example": "'Corporate division that engages in\n advisory_based financial\ntransactions on behalf of individuals,\ncorporations, and governments.'", "description": "Shield情報バリアのセグメントの説明" } } } } } }, "responses": { "201": { "description": "新しいShield情報バリアのセグメントオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegment" } } } }, "404": { "description": "Shield情報バリアが見つからなかった場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "409": { "description": "同じ名前のShield情報バリアのセグメントが存在する場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_segment_members/{shield_information_barrier_segment_member_id}": { "get": { "operationId": "get_shield_information_barrier_segment_members_id", "summary": "IDを指定してShield情報バリアのセグメントメンバーを取得", "tags": [ "Shield情報バリアのセグメントメンバー" ], "x-box-tag": "shield_information_barrier_segment_members", "description": "IDを指定してShield情報バリアのセグメントメンバーを取得します。", "parameters": [ { "name": "shield_information_barrier_segment_member_id", "description": "Shield情報バリアのセグメントメンバーのID。", "example": "7815", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Shield情報バリアのセグメントメンバーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentMember" } } } }, "404": { "description": "Shield情報バリアのセグメントメンバーが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_shield_information_barrier_segment_members_id", "summary": "IDを指定してShield情報バリアのセグメントメンバーを削除", "tags": [ "Shield情報バリアのセグメントメンバー" ], "x-box-tag": "shield_information_barrier_segment_members", "description": "指定されたIDに基づいてShield情報バリアのセグメントメンバーを削除します。", "parameters": [ { "name": "shield_information_barrier_segment_member_id", "description": "Shield情報バリアのセグメントメンバーのID。", "example": "7815", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "セグメントメンバーが正常に削除された場合は空のレスポンスを返します。" }, "404": { "description": "Shield情報バリアのセグメントメンバーが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_segment_members": { "get": { "operationId": "get_shield_information_barrier_segment_members", "summary": "Shield情報バリアのセグメントメンバーのリストを取得", "tags": [ "Shield情報バリアのセグメントメンバー" ], "x-box-tag": "shield_information_barrier_segment_members", "description": "指定されたセグメントIDに基づいてShield情報バリアのセグメントメンバーのリストを取得します。", "parameters": [ { "name": "shield_information_barrier_segment_id", "description": "Shield情報バリアのセグメントのID。", "example": "3423", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "Shield情報バリアのセグメントメンバーオブジェクトのページ割りされたリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentMembers" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_shield_information_barrier_segment_members", "summary": "Shield情報バリアのセグメントメンバーを作成", "tags": [ "Shield情報バリアのセグメントメンバー" ], "x-box-tag": "shield_information_barrier_segment_members", "description": "新しいShield情報バリアのセグメントメンバーを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "shield_information_barrier_segment", "user" ], "properties": { "type": { "description": "\\-| Shieldバリアのセグメントメンバーのタイプ。", "type": "string", "example": "shield_information_barrier_segment_member", "enum": [ "shield_information_barrier_segment_member" ] }, "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" }, "shield_information_barrier_segment": { "type": "object", "properties": { "id": { "type": "string", "example": "432554", "description": "リクエストしているShield情報バリアのセグメントのID参照。" }, "type": { "type": "string", "description": "このメンバーのShieldバリアのセグメントのタイプ。", "example": "shield_information_barrier_segment", "enum": [ "shield_information_barrier_segment" ] } }, "description": "リクエストされたShield情報バリアのセグメントの`type`と`id`。" }, "user": { "allOf": [ { "$ref": "#/components/schemas/User--Base" } ], "description": "制限が適用されるユーザー。" } } } } } }, "responses": { "201": { "description": "新しいShield情報バリアのセグメントメンバーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentMember" } } } }, "404": { "description": "Shield情報バリアまたはセグメントが見つからなかった場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_segment_restrictions/{shield_information_barrier_segment_restriction_id}": { "get": { "operationId": "get_shield_information_barrier_segment_restrictions_id", "summary": "IDを指定してShield情報バリアのセグメント制限を取得", "tags": [ "Shield情報バリアのセグメント制限" ], "x-box-tag": "shield_information_barrier_segment_restrictions", "description": "指定されたIDに基づいてShield情報バリアのセグメント制限を取得します。", "parameters": [ { "name": "shield_information_barrier_segment_restriction_id", "description": "Shield情報バリアのセグメント制限のID。", "example": "4563", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Shield情報バリアのセグメント制限オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentRestriction" } } } }, "404": { "description": "Shield情報バリアのセグメント制限が見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_shield_information_barrier_segment_restrictions_id", "summary": "IDを指定してShield情報バリアのセグメント制限を削除", "tags": [ "Shield情報バリアのセグメント制限" ], "x-box-tag": "shield_information_barrier_segment_restrictions", "description": "指定されたIDに基づいてShield情報バリアのセグメント制限を削除します。", "parameters": [ { "name": "shield_information_barrier_segment_restriction_id", "description": "Shield情報バリアのセグメント制限のID。", "example": "4563", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "レスポンスの本文は空です。" }, "404": { "description": "Shield情報バリアのセグメント制限が見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/shield_information_barrier_segment_restrictions": { "get": { "operationId": "get_shield_information_barrier_segment_restrictions", "summary": "Shield情報バリアのセグメント制限のリストを取得", "tags": [ "Shield情報バリアのセグメント制限" ], "x-box-tag": "shield_information_barrier_segment_restrictions", "description": "指定されたセグメントIDに基づいてShield情報バリアのセグメント制限のリストを取得します。", "parameters": [ { "name": "shield_information_barrier_segment_id", "description": "Shield情報バリアのセグメントのID。", "example": "3423", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "Shield情報バリアのセグメント制限オブジェクトのページ割りされたリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentRestrictions" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_shield_information_barrier_segment_restrictions", "summary": "Shield情報バリアのセグメント制限を作成", "tags": [ "Shield情報バリアのセグメント制限" ], "x-box-tag": "shield_information_barrier_segment_restrictions", "description": "Shield情報バリアのセグメント制限オブジェクトを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "type", "shield_information_barrier_segment", "restricted_segment" ], "properties": { "type": { "type": "string", "description": "このメンバーのShieldバリアのセグメント制限のタイプ。", "example": "shield_information_barrier_segment_restriction", "enum": [ "shield_information_barrier_segment_restriction" ] }, "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" }, "shield_information_barrier_segment": { "type": "object", "properties": { "id": { "type": "string", "example": "1910967", "description": "リクエストしているShield情報バリアのセグメントのID参照。" }, "type": { "type": "string", "description": "このメンバーのShieldバリアのセグメントのタイプ。", "example": "shield_information_barrier_segment", "enum": [ "shield_information_barrier_segment" ] } }, "description": "リクエストされたShield情報バリアのセグメントの`type`と`id`。" }, "restricted_segment": { "type": "object", "properties": { "id": { "type": "string", "example": "1910967", "description": "制限されたShield情報バリアのセグメントのID参照。" }, "type": { "type": "string", "example": "shield_information_barrier_segment", "description": "制限されたShield情報バリアのセグメントのタイプ。", "enum": [ "shield_information_barrier_segment" ] } }, "description": "制限されたShield情報バリアのセグメントの`type`と`id`。" } } } } } }, "responses": { "201": { "description": "新しく作成されたShield情報バリアのセグメント制限オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentRestriction" } } } }, "404": { "description": "Shield情報バリアまたはセグメントが見つからなかった場合は`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/device_pinners/{device_pinner_id}": { "get": { "operationId": "get_device_pinners_id", "summary": "デバイスピンを取得", "tags": [ "Device Pinner" ], "x-box-tag": "device_pinners", "description": "個々のデバイスピンに関する情報を取得します。", "parameters": [ { "name": "device_pinner_id", "description": "デバイスピンのID", "in": "path", "required": true, "example": "2324234", "schema": { "type": "string" } } ], "responses": { "200": { "description": "単一のデバイスピンに関する情報を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DevicePinner" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_device_pinners_id", "summary": "デバイスピンを削除", "tags": [ "Device Pinner" ], "x-box-tag": "device_pinners", "description": "個々のデバイスピンを削除します。", "parameters": [ { "name": "device_pinner_id", "description": "デバイスピンのID", "in": "path", "required": true, "example": "2324234", "schema": { "type": "string" } } ], "responses": { "204": { "description": "ピンが削除された場合は、空のレスポンスを返します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/enterprises/{enterprise_id}/device_pinners": { "get": { "operationId": "get_enterprises_id_device_pinners", "summary": "会社のデバイスピンのリストを取得", "tags": [ "Device Pinner" ], "x-box-tag": "device_pinners", "description": "会社内のすべてのデバイスピンを取得します。\n\nこの呼び出しを行うにはユーザーに管理者権限が必要で、アプリケーションに「Enterpriseの管理」スコープが必要です。", "parameters": [ { "name": "enterprise_id", "description": "会社のID", "in": "path", "required": true, "example": "3442311", "schema": { "type": "string" } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "direction", "description": "結果を並べ替える方向。アルファベットの昇順 (`ASC`) または降順 (`DESC`) のいずれかを指定できます。", "in": "query", "required": false, "example": "ASC", "schema": { "type": "string", "enum": [ "ASC", "DESC" ] } } ], "responses": { "200": { "description": "指定した会社のデバイスピンのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DevicePinners" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/terms_of_services": { "get": { "operationId": "get_terms_of_services", "x-box-tag": "terms_of_services", "summary": "サービス利用規約のリストを取得", "tags": [ "サービス利用規約" ], "description": "企業の現在のサービス利用規約のテキストと設定を返します。", "parameters": [ { "name": "tos_type", "description": "指定した種類のサービス利用規約のみに結果を絞り込みます。", "in": "query", "required": false, "example": "managed", "schema": { "type": "string", "enum": [ "external", "managed" ] } } ], "responses": { "200": { "description": "企業のサービス利用規約のテキストおよび設定のコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfServices" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_terms_of_services", "tags": [ "サービス利用規約" ], "summary": "サービス利用規約を作成", "x-box-tag": "terms_of_services", "description": "指定した企業とユーザータイプに適用されるサービス利用規約を作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "text" ], "properties": { "status": { "description": "このサービス利用規約がアクティブであるかどうか。", "example": "enabled", "type": "string", "enum": [ "enabled", "disabled" ] }, "tos_type": { "description": "サービス利用規約を設定するユーザーのタイプ。", "example": "managed", "type": "string", "enum": [ "external", "managed" ] }, "text": { "description": "ユーザーに対して表示されるサービス利用規約のテキスト。\n\n`status`が`disabled`に設定されている場合は、テキストを空に設定できます。", "example": "By collaborating on this file you are accepting...", "type": "string" } } } } } }, "responses": { "200": { "description": "新しいタスクオブジェクトを返します", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfService" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/terms_of_services/{terms_of_service_id}": { "get": { "operationId": "get_terms_of_services_id", "summary": "サービス利用規約を取得", "tags": [ "サービス利用規約" ], "x-box-tag": "terms_of_services", "description": "特定のサービス利用規約を取得します。", "parameters": [ { "name": "terms_of_service_id", "description": "サービス利用規約のID。", "example": "324234", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "サービス利用規約オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfService" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_terms_of_services_id", "summary": "サービス利用規約を更新", "tags": [ "サービス利用規約" ], "x-box-tag": "terms_of_services", "description": "特定のサービス利用規約を更新します。", "parameters": [ { "name": "terms_of_service_id", "description": "サービス利用規約のID。", "example": "324234", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "text" ], "properties": { "status": { "description": "このサービス利用規約がアクティブであるかどうか。", "example": "enabled", "type": "string", "enum": [ "enabled", "disabled" ] }, "text": { "description": "ユーザーに対して表示されるサービス利用規約のテキスト。\n\n`status`が`disabled`に設定されている場合は、テキストを空に設定できます。", "example": "By collaborating on this file you are accepting...", "type": "string" } } } } } }, "responses": { "200": { "description": "更新されたサービス利用規約オブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfService" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/terms_of_service_user_statuses": { "get": { "operationId": "get_terms_of_service_user_statuses", "summary": "サービス利用規約のユーザーステータスのリストを取得", "tags": [ "サービス利用規約のユーザーステータス" ], "x-box-tag": "terms_of_service_user_statuses", "description": "ユーザーとそのユーザーに適用されるサービス利用規約のステータスの概要 (ユーザーが利用規約に同意したかどうかや、いつ同意したかなど) を取得します。", "parameters": [ { "name": "tos_id", "description": "サービス利用規約のID。", "example": "324234", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "description": "指定したユーザーIDのみに結果を絞り込みます。", "example": "123334", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "サービス利用規約のステータスのリストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfServiceUserStatuses" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_terms_of_service_user_statuses", "summary": "新規ユーザーのサービス利用規約のステータスを作成", "tags": [ "サービス利用規約のユーザーステータス" ], "x-box-tag": "terms_of_service_user_statuses", "description": "ユーザーのサービス利用規約のステータスを設定します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "tos", "user", "is_accepted" ], "properties": { "tos": { "type": "object", "description": "ステータスを設定するサービス利用規約。", "required": [ "id", "type" ], "properties": { "type": { "type": "string", "description": "オブジェクトのタイプ。", "example": "terms_of_service", "enum": [ "terms_of_service" ] }, "id": { "type": "string", "description": "サービス利用規約のID", "example": "1232132" } } }, "user": { "type": "object", "description": "ステータスを設定するユーザー。", "required": [ "id", "type" ], "properties": { "type": { "type": "string", "description": "オブジェクトのタイプ。", "example": "user", "enum": [ "user" ] }, "id": { "type": "string", "description": "ユーザーのID", "example": "3423423" } } }, "is_accepted": { "type": "boolean", "example": true, "description": "ユーザーが利用規約に同意したかどうか。" } } } } } }, "responses": { "201": { "description": "サービス利用規約ステータスオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfServiceUserStatus" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/terms_of_service_user_statuses/{terms_of_service_user_status_id}": { "put": { "operationId": "put_terms_of_service_user_statuses_id", "summary": "既存ユーザーのサービス利用規約のステータスを更新", "tags": [ "サービス利用規約のユーザーステータス" ], "x-box-tag": "terms_of_service_user_statuses", "description": "ユーザーのサービス利用規約のステータスを更新します。", "parameters": [ { "name": "terms_of_service_user_status_id", "description": "サービス利用規約ステータスのID。", "example": "324234", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "is_accepted" ], "properties": { "is_accepted": { "type": "boolean", "example": true, "description": "ユーザーが利用規約に同意したかどうか。" } } } } } }, "responses": { "200": { "description": "更新されたサービス利用規約のステータスオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermsOfServiceUserStatus" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collaboration_whitelist_entries": { "get": { "operationId": "get_collaboration_whitelist_entries", "summary": "許可されたコラボレーションドメインのリストを取得", "tags": [ "コラボレーションに対するドメインを制限" ], "x-box-tag": "collaboration_allowlist_entries", "description": "現在の会社内でコラボレーションを作成しても安全であると見なされているドメインのリストを返します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "コラボレーションが許可されているドメインのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CollaborationAllowlistEntries" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_collaboration_whitelist_entries", "summary": "許可されたコラボレーションドメインのリストにドメインを追加", "tags": [ "コラボレーションに対するドメインを制限" ], "x-box-tag": "collaboration_allowlist_entries", "description": "コラボレーションが許可されているドメインのリストに新しいエントリを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "domain", "direction" ], "properties": { "domain": { "type": "string", "description": "許可されたドメインのリストに追加するドメイン。", "example": "example.com" }, "direction": { "type": "string", "description": "コラボレーションを許可する方向。", "example": "inbound", "enum": [ "inbound", "outbound", "both" ] } } } } } }, "responses": { "200": { "description": "許可されたドメインのリストに新しいエントリを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CollaborationAllowlistEntry" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collaboration_whitelist_entries/{collaboration_whitelist_entry_id}": { "get": { "operationId": "get_collaboration_whitelist_entries_id", "summary": "許可されたコラボレーションドメインを取得", "tags": [ "コラボレーションに対するドメインを制限" ], "x-box-tag": "collaboration_allowlist_entries", "description": "現在の会社内でコラボレーションを作成しても安全であると見なされているドメインを返します。", "parameters": [ { "name": "collaboration_whitelist_entry_id", "description": "リスト内のエントリのID。", "in": "path", "required": true, "example": "213123", "schema": { "type": "string" } } ], "responses": { "200": { "description": "許可されたドメインのリストにエントリを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CollaborationAllowlistEntry" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_collaboration_whitelist_entries_id", "summary": "許可されたコラボレーションドメインのリストからドメインを削除", "tags": [ "コラボレーションに対するドメインを制限" ], "x-box-tag": "collaboration_allowlist_entries", "description": "現在の会社内でコラボレーションを作成しても安全であると見なされているドメインのリストからドメインを削除します。", "parameters": [ { "name": "collaboration_whitelist_entry_id", "description": "リスト内のエントリのID。", "in": "path", "required": true, "example": "213123", "schema": { "type": "string" } } ], "responses": { "204": { "description": "エントリが正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collaboration_whitelist_exempt_targets": { "get": { "operationId": "get_collaboration_whitelist_exempt_targets", "summary": "コラボレーションドメインの制限から除外するユーザーのリストを取得", "tags": [ "ドメインの制限 (ユーザーの除外)" ], "x-box-tag": "collaboration_allowlist_exempt_targets", "description": "コラボレーションドメインの制限から除外されているユーザーのリストを返します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "除外するユーザーのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CollaborationAllowlistExemptTargets" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_collaboration_whitelist_exempt_targets", "summary": "コラボレーションドメインの制限からのユーザー除外を作成", "tags": [ "ドメインの制限 (ユーザーの除外)" ], "x-box-tag": "collaboration_allowlist_exempt_targets", "description": "コラボレーションが許可されたドメインリストで設定された制限からユーザーを除外します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "user" ], "properties": { "user": { "type": "object", "description": "除外するユーザー。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "除外するユーザーのID。", "example": "23522323" } } } } } } } }, "responses": { "200": { "description": "新しい除外エントリを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CollaborationAllowlistExemptTarget" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/collaboration_whitelist_exempt_targets/{collaboration_whitelist_exempt_target_id}": { "get": { "operationId": "get_collaboration_whitelist_exempt_targets_id", "summary": "コラボレーションドメインの制限から除外するユーザーを取得", "tags": [ "ドメインの制限 (ユーザーの除外)" ], "x-box-tag": "collaboration_allowlist_exempt_targets", "description": "コラボレーションドメインの制限から除外されているユーザーを返します。", "parameters": [ { "name": "collaboration_whitelist_exempt_target_id", "description": "リストに対する除外のID。", "in": "path", "required": true, "example": "984923", "schema": { "type": "string" } } ], "responses": { "200": { "description": "コラボレーションドメインのリストから除外されたユーザーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CollaborationAllowlistExemptTarget" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_collaboration_whitelist_exempt_targets_id", "summary": "ドメインの制限から除外されるユーザーのリストからユーザーを削除", "tags": [ "ドメインの制限 (ユーザーの除外)" ], "x-box-tag": "collaboration_allowlist_exempt_targets", "description": "コラボレーションが許可されたドメインリストで設定された制限からユーザーの除外を削除します。", "parameters": [ { "name": "collaboration_whitelist_exempt_target_id", "description": "リストに対する除外のID。", "in": "path", "required": true, "example": "984923", "schema": { "type": "string" } } ], "responses": { "204": { "description": "例外が正常に削除された場合は、空のレスポンスが返されます。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/storage_policies": { "get": { "operationId": "get_storage_policies", "summary": "ストレージポリシーのリストを取得", "tags": [ "標準およびZonesのストレージポリシー" ], "x-box-tag": "storage_policies", "description": "企業のすべてのストレージポリシーを取得します。", "parameters": [ { "name": "fields", "description": "レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。\n\nこのパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。", "in": "query", "example": [ "id", "type", "name" ], "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "ストレージポリシーのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePolicies" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/storage_policies/{storage_policy_id}": { "get": { "operationId": "get_storage_policies_id", "summary": "ストレージポリシーを取得", "tags": [ "標準およびZonesのストレージポリシー" ], "x-box-tag": "storage_policies", "description": "特定のストレージポリシーを取得します。", "parameters": [ { "name": "storage_policy_id", "description": "ストレージポリシーのID。", "example": "34342", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ストレージポリシーオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePolicy" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/storage_policy_assignments": { "get": { "operationId": "get_storage_policy_assignments", "summary": "ストレージポリシー割り当てのリストを取得", "tags": [ "標準およびZonesのストレージポリシー割り当て" ], "x-box-tag": "storage_policy_assignments", "description": "会社またはユーザーのすべてのストレージポリシー割り当てを取得します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "resolved_for_type", "in": "query", "example": "user", "description": "割り当てを返すターゲットのタイプ", "required": true, "schema": { "type": "string", "enum": [ "user", "enterprise" ] } }, { "name": "resolved_for_id", "in": "query", "required": true, "example": "984322", "description": "割り当てを返すユーザーまたは会社のID", "schema": { "type": "string" } } ], "responses": { "200": { "description": "会社またはユーザーのストレージポリシーのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePolicyAssignments" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_storage_policy_assignments", "summary": "ストレージポリシーを割り当て", "tags": [ "標準およびZonesのストレージポリシー割り当て" ], "x-box-tag": "storage_policy_assignments", "description": "会社またはユーザーに対するストレージポリシー割り当てを作成します。", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "storage_policy", "assigned_to" ], "properties": { "storage_policy": { "type": "object", "description": "ユーザーまたは会社に割り当てるストレージポリシー", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "description": "割り当てるタイプ。", "example": "storage_policy", "enum": [ "storage_policy" ] }, "id": { "type": "string", "description": "割り当てるストレージポリシーのID。", "example": "1434325" } } }, "assigned_to": { "type": "object", "description": "ストレージポリシーを割り当てるユーザーまたは会社。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "description": "ポリシーを割り当てるタイプ。", "example": "user", "enum": [ "user", "enterprise" ] }, "id": { "type": "string", "description": "ユーザーまたは会社のID", "example": "9987987" } } } } } } } }, "responses": { "200": { "description": "作成された新しいストレージポリシー割り当てを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePolicyAssignment" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/storage_policy_assignments/{storage_policy_assignment_id}": { "get": { "operationId": "get_storage_policy_assignments_id", "summary": "ストレージポリシー割り当てを取得", "tags": [ "標準およびZonesのストレージポリシー割り当て" ], "x-box-tag": "storage_policy_assignments", "description": "特定のストレージポリシー割り当てを取得します。", "parameters": [ { "name": "storage_policy_assignment_id", "description": "ストレージポリシー割り当てのID。", "example": "932483", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ストレージポリシー割り当てオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePolicyAssignment" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "put": { "operationId": "put_storage_policy_assignments_id", "summary": "ストレージポリシー割り当てを更新", "tags": [ "標準およびZonesのストレージポリシー割り当て" ], "x-box-tag": "storage_policy_assignments", "description": "特定のストレージポリシー割り当てを更新します。", "parameters": [ { "name": "storage_policy_assignment_id", "description": "ストレージポリシー割り当てのID。", "example": "932483", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "storage_policy" ], "properties": { "storage_policy": { "type": "object", "description": "ユーザーまたは会社に割り当てるストレージポリシー", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "description": "割り当てるタイプ。", "example": "storage_policy", "enum": [ "storage_policy" ] }, "id": { "type": "string", "description": "割り当てるストレージポリシーのID。", "example": "1434325" } } } } } } } }, "responses": { "200": { "description": "更新されたストレージポリシー割り当てオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePolicyAssignment" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_storage_policy_assignments_id", "summary": "ストレージポリシーの割り当てを解除", "tags": [ "標準およびZonesのストレージポリシー割り当て" ], "x-box-tag": "storage_policy_assignments", "description": "ストレージポリシーの割り当てを削除します。\n\nユーザーに対するストレージポリシーの割り当てを削除すると、そのユーザーは会社のデフォルトのストレージポリシーを継承します。\n\nこのエンドポイントの呼び出しには、24時間につき1ユーザーあたり2回までというレート制限が適用されます。", "parameters": [ { "name": "storage_policy_assignment_id", "description": "ストレージポリシー割り当てのID。", "example": "932483", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "ストレージポリシー割り当てが正常に削除された場合は、空のレスポンスを返します。" }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/zip_downloads": { "post": { "operationId": "post_zip_downloads", "summary": "zipダウンロードを作成", "tags": [ "zipダウンロード" ], "x-box-tag": "zip_downloads", "x-box-reference-category": "zip_downloads", "description": "複数のファイルやフォルダを1つの`zip`アーカイブファイルとしてダウンロードするためのリクエストを作成します。このAPIでは、アーカイブは返されませんが、代わりにユーザーがすべての項目にアクセスできるかどうかを確認するチェックがすべて実行され、アーカイブのダウンロードに使用できる`download_url`および`status_url`が返されます。\n\nアーカイブの上限は、アカウントのアップロード上限または10,000ファイルのいずれかで、最初に達した上限が適用されます。\n\n**注**: 大きいファイルをダウンロードする場合は、距離、ネットワーク遅延、帯域幅、輻輳のほか、パケット損失率や現在のサーバー負荷など、さまざまな要因の影響を受けることがあります。このような理由から、Boxでは、ZIPアーカイブの合計サイズが25 GBを超えないようにすることをお勧めします。", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ZipDownloadRequest" } } } }, "responses": { "202": { "description": "`zip`アーカイブをダウンロードする準備ができている場合、このAPIによって、`download_url`、`status_url`のほか、リクエストの作成時に発生した可能性のある競合を含むレスポンスが返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ZipDownload" }, "examples": { "default": { "value": { "download_url": "https://dl.boxcloud.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/content", "status_url": "https://api.box.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/status", "expires_at": "2020-07-22T11:26:08Z", "name_conflicts": [ [ { "id": "12345", "type": "file", "original_name": "Report.pdf", "download_name": "3aa6a7.pdf" }, { "id": "34325", "type": "file", "original_name": "Report.pdf", "download_name": "5d53f2.pdf" } ] ] } } } } } }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\nほとんどの場合、このエラーは、JSONリクエスト本文が有効なJSONではないこと、項目のいずれかでIDが誤っているか指定されていないこと、いずれかの項目がファイルでもフォルダでもないこと、またはIDが`0`のルートフォルダがアーカイブに追加するフォルダのリストに追加されたことが原因で発生する可能性があります。\n\n以下は、このレスポンスに対する共通エラーコードのリストです。\n\n* `bad_request` - リクエスト本文がないか無効である、またはファイルリストとフォルダリストの両方が空です。さらに、このエラーは、IDが`0`のルートフォルダをアーカイブに追加しようとすると返される場合があります。\n* `zip_download_file_count_exceeded_limit` - リクエストされたファイルおよびフォルダによって、アーカイブのファイル数が10,000を超えます。アーカイブあたりのファイル数を減らすには、リクエストを複数のリクエストに分割する必要があります。\n* `zip_download_pre_compressed_bytes_exceeded_limit` - リクエストされたファイルおよびフォルダにより、アーカイブが、許可されたダウンロード上限を超えます。アーカイブのサイズを縮小するには、リクエストを複数のリクエストに分割する必要があります。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "承認ヘッダーが指定されていても、ユーザーが項目にアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/zip_downloads/{zip_download_id}/content": { "get": { "operationId": "get_zip_downloads_id_content", "summary": "zipアーカイブをダウンロード", "tags": [ "zipダウンロード" ], "x-box-tag": "zip_downloads", "x-box-reference-category": "zip_downloads", "description": "`zip`アーカイブのコンテンツをバイナリ形式で返します。このURLは、どのような形式の認証も要求せず、ユーザーのブラウザでユーザーのデバイスにアーカイブをダウンロードする際に使用できます。\n\nデフォルトでは、このURLの有効期間は、このアーカイブに対するリクエストを作成してから数秒間だけです。一度ダウンロードが開始されると、停止して再開することはできません。代わりに、zipアーカイブに対する新しいリクエストを作成する必要があります。\n\nこのエンドポイントのURLは固定であるとは考えないでください。代わりに、[zipダウンロードを作成](e://post_zip_downloads)APIを使用して`zip`アーカイブの作成をリクエストした後、このエンドポイントのレスポンスにある`download_url`フィールドに従ってください。", "security": [], "servers": [ { "url": "https://dl.boxcloud.com/2.0", "description": "zipダウンロードを実行するための不明瞭なサーバーURL。このURL形式は、時間が経つと変わる可能性があります。" } ], "parameters": [ { "name": "zip_download_id", "description": "この`zip`アーカイブを表す一意の識別子。", "example": "Lu6fA9Ob-jyysp3AAvMF4AkLEwZwAYbL=tgj2zIC=eK9RvJnJbjJl9rNh2qBgHDpyOCAOhpM=vajg2mKq8Mdd", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "`zip`アーカイブのファイルおよびフォルダをストリームの形式にして、このダウンロードに対してリクエストされた項目のコンテンツを返します。", "headers": { "Content-Disposition": { "description": "ダウンロードするアーカイブの名前", "schema": { "type": "string", "example": "attachment;filename=\"Avatars.zip\";filename*=UTF-8''Avatars.zip" } } }, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "description": "アーカイブのバイナリコンテンツ。これには、このダウンロードに対してリクエストされた項目が含まれます。" } } } }, "404": { "description": "このダウンロードリクエストのIDが無効な場合にエラーを返します。また、このエラーは、以前にこのURLが呼び出されている場合にも返されます。このアーカイブを再度ダウンロードするには、zipダウンロードの新しいリクエストを作成してください。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "429": { "description": "ユーザーまたは会社の同時実行zipダウンロード数に達した場合にエラーを返します。\n\n* `user_too_many_concurrent_downloads` - ユーザーあたりのzipアーカイブの並行ダウンロード数が最大値5に達しました。\n* `enterprise_too_many_concurrent_downloads` - 企業あたりのzipアーカイブの並行ダウンロード数が最大値10に達しました。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/zip_downloads/{zip_download_id}/status": { "get": { "operationId": "get_zip_downloads_id_status", "summary": "zipダウンロードのステータスを取得", "tags": [ "zipダウンロード" ], "x-box-tag": "zip_downloads", "x-box-reference-category": "zip_downloads", "description": "`zip`アーカイブのダウンロードステータスを返します。これにより、アプリケーションは、ダウンロードの進行状況のほか、スキップされた可能性のある項目の数を確認できます。\n\nこのエンドポイントにアクセスできるのは、ダウンロードが開始された後だけです。このエンドポイントの有効期間は、ダウンロードを開始してから12時間です。\n\nこのエンドポイントのURLは固定であるとは考えないでください。代わりに、[zipダウンロードを作成](e://post_zip_downloads)APIを使用して`zip`アーカイブの作成をリクエストした後、このエンドポイントのレスポンスにある`status_url`フィールドに従ってください。", "parameters": [ { "name": "zip_download_id", "description": "この`zip`アーカイブを表す一意の識別子。", "example": "Lu6fA9Ob-jyysp3AAvMF4AkLEwZwAYbL=tgj2zIC=eK9RvJnJbjJl9rNh2qBgHDpyOCAOhpM=vajg2mKq8Mdd", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ダウンロード中の`zip`アーカイブのステータスを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ZipDownloadStatus" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "承認ヘッダーが指定されていても、ユーザーが項目にアクセスできない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "このダウンロードリクエストのIDが無効な場合、またはダウンロードが開始される前にダウンロードのステータスがリクエストされた場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/sign_requests/{sign_request_id}/cancel": { "post": { "operationId": "post_sign_requests_id_cancel", "summary": "署名リクエストをキャンセル", "tags": [ "署名リクエスト" ], "x-box-tag": "sign_requests", "description": "署名リクエストをキャンセルします。", "parameters": [ { "name": "sign_request_id", "description": "署名リクエストのID", "example": "33243242", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "署名リクエストオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignRequest" } } } }, "404": { "description": "署名リクエストが見つからない場合、またはユーザーが署名リクエストにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/sign_requests/{sign_request_id}/resend": { "post": { "operationId": "post_sign_requests_id_resend", "summary": "署名リクエストを再送信", "tags": [ "署名リクエスト" ], "x-box-tag": "sign_requests", "description": "未署名の署名者全員に署名リクエストのメールを再送信します。", "parameters": [ { "name": "sign_request_id", "description": "署名リクエストのID", "example": "33243242", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "APIコールが成功した場合に空のレスポンスを返します。メール通知が非同期的に送信されます。" }, "404": { "description": "署名リクエストが見つからない場合、またはユーザーが署名リクエストにアクセスできない場合はエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/sign_requests/{sign_request_id}": { "get": { "operationId": "get_sign_requests_id", "summary": "IDを指定して署名リクエストを取得", "tags": [ "署名リクエスト" ], "x-box-tag": "sign_requests", "description": "IDを指定して署名リクエストを取得します。", "parameters": [ { "name": "sign_request_id", "description": "署名リクエストのID", "example": "33243242", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "署名リクエストを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignRequest" } } } }, "404": { "description": "署名リクエストが見つからない場合、ユーザーが署名リクエストにアクセスできない場合、または`sign_files`や`parent_folder`が削除された場合にエラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/sign_requests": { "get": { "operationId": "get_sign_requests", "summary": "署名リクエストのリストを取得", "tags": [ "署名リクエスト" ], "x-box-tag": "sign_requests", "description": "ユーザーが作成した署名リクエストを取得します。`sign_files`や`parent_folder`が削除された場合、署名リクエストはリストで返されません。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "署名リクエストのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignRequests" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_sign_requests", "summary": "署名リクエストを作成", "tags": [ "署名リクエスト" ], "x-box-tag": "sign_requests", "description": "署名リクエストを作成します。これには、署名用ドキュメントの準備と署名者への署名リクエストの送信が含まれます。", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignRequestCreateRequest" } } } }, "responses": { "201": { "description": "署名リクエストオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignRequest" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/workflows": { "get": { "operationId": "get_workflows", "summary": "ワークフローのリストを取得", "tags": [ "Workflows" ], "x-box-tag": "workflows", "description": "指定した`folder ID`に作用し、トリガータイプが`WORKFLOW_MANUAL_START`のフローを含むワークフローのリストを返します。\n\nアプリケーションは、このエンドポイントを使用するために、開発者コンソールでの`Manage Box Relay`アプリケーションスコープの使用が承認されている必要があります。", "parameters": [ { "name": "folder_id", "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folder/123`の場合、`folder_id`は`123`です。\n\nBoxアカウントのルートフォルダは常にID `0`で表されます。", "example": "12345", "in": "query", "required": true, "schema": { "type": "string", "nullable": false } }, { "name": "trigger_type", "description": "検索するトリガーのタイプ。", "example": "WORKFLOW_MANUAL_START", "in": "query", "required": false, "schema": { "type": "string", "nullable": false } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } } ], "responses": { "200": { "description": "ワークフローを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Workflows" } } } }, "400": { "description": "トリガータイプが`WORKFLOW_MANUAL_START`ではない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/workflows/{workflow_id}/start": { "post": { "operationId": "post_workflows_id_start", "summary": "リクエスト本文に基づいてワークフローを開始", "tags": [ "Workflows" ], "x-box-tag": "workflows", "description": "トリガータイプが`WORKFLOW_MANUAL_START`のフローを開始します。\n\nアプリケーションは、開発者コンソールでの`Manage Box Relay`アプリケーションスコープの使用が承認されている必要があります。", "parameters": [ { "name": "workflow_id", "description": "ワークフローのID。", "example": "12345", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "flow", "files", "folder" ], "properties": { "type": { "type": "string", "description": "パラメータオブジェクトのタイプ", "example": "workflow_parameters", "enum": [ "workflow_parameters" ] }, "flow": { "type": "object", "description": "トリガーされるフロー", "properties": { "type": { "type": "string", "description": "フローオブジェクトのタイプ", "example": "flow" }, "id": { "type": "string", "description": "フローのID", "example": "123456789" } } }, "files": { "type": "array", "description": "ワークフローが開始されるファイルの配列。すべてのファイルは、ワークフローの設定済みフォルダに存在する必要があります。", "items": { "type": "object", "description": "ワークフローが開始されるファイル", "properties": { "type": { "type": "string", "description": "ファイルオブジェクトのタイプ", "example": "file", "enum": [ "file" ] }, "id": { "type": "string", "description": "ファイルのID", "example": "12345678" } } } }, "folder": { "type": "object", "description": "ワークフローが設定されているフォルダオブジェクト。", "properties": { "type": { "type": "string", "description": "フォルダオブジェクトのタイプ", "example": "folder", "enum": [ "folder" ] }, "id": { "type": "string", "description": "フォルダのID", "example": "87654321" } } }, "outcomes": { "type": "array", "description": "ワークフローで完了する必要がある設定可能な結果。", "items": { "$ref": "#/components/schemas/Outcome" } } } } } } }, "responses": { "204": { "description": "ワークフローを開始します。" }, "400": { "description": "パラメータが不足しているか無効の場合はエラーを返します。\n\n* ワークフローが有効でない場合は`workflow_is_not_enabled`\n* 指定されたフォルダIDに対してワークフローが有効でない場合は`workflow_not_active_on_provided_folder`\n* 指定されたパラメータが予期されたパラメータと一致しない場合は`parameters_provided_do_not_match_target_outcome`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "403": { "description": "権限が不足している場合にエラーを返します。\n\n* ユーザーにファイルまたはフォルダへのアクセス権限がない場合は`insufficient_access`\n* ユーザーにRelay全体へのアクセス権限がない場合は`missing_relay_full_access`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "ワークフローが見つからない場合、または認証済みユーザーがワークフローにアクセスできない場合はエラーを返します。\n\n* ワークフローが見つからない場合は`workflow_not_found`\n* フローが手動開始フローでない場合は`flow_missing_or_inaccessible`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/sign_templates": { "get": { "operationId": "get_sign_templates", "summary": "Box Signテンプレートのリストを取得", "tags": [ "Signテンプレート" ], "x-box-tag": "sign_templates", "description": "ユーザーによって作成されたBox Signテンプレートを取得します。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } } ], "responses": { "200": { "description": "テンプレートのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignTemplates" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/sign_templates/{template_id}": { "get": { "operationId": "get_sign_templates_id", "summary": "IDを指定してBox Signテンプレートを取得", "tags": [ "Signテンプレート" ], "x-box-tag": "sign_templates", "description": "特定のBox Signテンプレートの詳細を取得します。", "parameters": [ { "name": "template_id", "description": "Box SignテンプレートのID。", "example": "123075213-7d117509-8f05-42e4-a5ef-5190a319d41d", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "テンプレートの詳細を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignTemplate" } } } }, "401": { "description": "`Authorization`ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "テンプレートが見つからない場合、または関連付けられたテンプレートへのアクセス権限がユーザーに与えられていない場合に返されます。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/integration_mappings/slack": { "get": { "operationId": "get_integration_mappings_slack", "summary": "Slack統合マッピングのリストを取得", "tags": [ "統合マッピング" ], "x-box-tag": "integration_mappings", "description": "ユーザーの企業内の[Slack統合マッピング](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack)のリストを取得します。\n\nこのエンドポイントを使用するには、管理者または共同管理者の役割が必要です。", "parameters": [ { "name": "marker", "description": "結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。\n\nこれを使用するには、`usemarker`を`true`に設定する必要があります。", "in": "query", "required": false, "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "schema": { "type": "string" } }, { "name": "limit", "description": "返す項目の1ページあたりの最大数。", "in": "query", "required": false, "example": 1000, "schema": { "type": "integer", "format": "int64", "maximum": 1000 } }, { "in": "query", "name": "partner_item_type", "schema": { "type": "string", "enum": [ "channel" ], "nullable": false }, "description": "マッピングが返される、マッピングされた項目タイプ", "example": "channel" }, { "in": "query", "name": "partner_item_id", "schema": { "type": "string", "nullable": false }, "description": "マッピングが返される、マッピングされた項目のID", "example": "12345" }, { "in": "query", "name": "box_item_id", "schema": { "type": "string", "nullable": false }, "description": "マッピングが返される、Box項目ID", "example": "12345" }, { "in": "query", "name": "box_item_type", "schema": { "nullable": false, "type": "string", "enum": [ "folder" ] }, "description": "マッピングが返される、Box項目タイプ", "example": "folder" }, { "in": "query", "name": "is_manually_created", "schema": { "type": "boolean", "nullable": false }, "description": "マッピングが手動で作成されたかどうか", "example": true } ], "responses": { "200": { "description": "統合マッピングのコレクションを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationMappings" } } } }, "400": { "description": "クライアントエラーが原因で、サーバーはリクエストを処理できないか、処理しません。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "統合マッピングが見つからなかった場合、`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "post": { "operationId": "post_integration_mappings_slack", "summary": "Slack統合マッピングを作成", "tags": [ "統合マッピング" ], "x-box-tag": "integration_mappings", "description": "SlackチャンネルをBox項目にマッピングすることで、[Slack統合マッピング](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack)を作成します。\n\nこのエンドポイントを使用するには、管理者または共同管理者の役割が必要です。", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationMappingSlackCreateRequest" } } } }, "responses": { "201": { "description": "作成された統合マッピングを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationMapping" } } } }, "400": { "description": "誤った`options`が指定された場合またはBoxフォルダをこの`partner_item_id`にマッピングできない場合に`bad_request`を返します。エラーコードは以下のとおりです。\n\n* `SERVICE_ACCOUNT_IS_NOT_A_COOWNER_OR_OWNER` - サービスアカウントに共同所有者のコラボレーションがないか、サービスアカウントが`box_item_id`の所有者ではありません。\n* `CHANNEL_ALREADY_MAPPED` - チャンネルがすでに別の`box_item_id`にマッピングされています。\n* `CHANNEL_NOT_FOUND` - チャンネルが見つかりませんでした。\n* `CHANNEL_NOT_SUITABLE_FOR_CFS` - コネクトチャンネルのため、SlackのコンテンツレイヤーとしてBoxを使用するのに適していません。\n* `BOX_ENTERPRISE_MISMATCH` - Boxフォルダは、BoxをSlackのコンテンツレイヤーとして使用するよう構成されている企業が所有している必要があります。\n* `CFS_DISABLED` - SlackのコンテンツレイヤーとしてのBoxの使用を、指定したSlackワークスペースまたはオーガナイゼーションに対して有効にする必要があります。\n* `BOX_FOLDER_EXTERNALLY_OWNED` - Boxフォルダは、管理者の企業内で所有されている必要があります。\n* `JWT_APP_NOT_AUTHORIZED` - JWT承認エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "統合マッピングが見つからなかった場合、`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } }, "/integration_mappings/slack/{integration_mapping_id}": { "put": { "operationId": "put_integration_mappings_slack_id", "summary": "Slack統合マッピングを更新", "tags": [ "統合マッピング" ], "x-box-tag": "integration_mappings", "description": "[Slack統合マッピング](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack)を更新します。BoxフォルダIDおよびオプションの更新をサポートします。\n\nこのエンドポイントを使用するには、管理者または共同管理者の役割が必要です。", "parameters": [ { "name": "integration_mapping_id", "description": "統合マッピングのID", "example": "11235432", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "box_item": { "nullable": false, "allOf": [ { "$ref": "#/components/schemas/IntegrationMappingBoxItemSlack" } ] }, "options": { "nullable": false, "allOf": [ { "$ref": "#/components/schemas/IntegrationMappingSlackOptions" } ] } } } } }, "description": "At least one of `box_item` and `options` must be provided." }, "responses": { "200": { "description": "更新された統合マッピングオブジェクトを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationMapping" } } } }, "400": { "description": "誤った`options`が指定された場合またはBoxフォルダをこの`partner_item`にマッピングできない場合に`bad_request`を返します。エラーコードは以下のとおりです。\n\n* `SERVICE_ACCOUNT_IS_NOT_A_COOWNER_OR_OWNER` - サービスアカウントに共同所有者のコラボレーションがないか、サービスアカウントが`box_item_id`の所有者ではありません。\n* `BOX_FOLDER_EXTERNALLY_OWNED` - Boxフォルダは、管理者の企業内で所有されている必要があります。\n* `JWT_APP_NOT_AUTHORIZED` - JWT承認エラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "404": { "description": "統合マッピングオブジェクトが見つからなかった場合は`not_found`を返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } }, "delete": { "operationId": "delete_integration_mappings_slack_id", "summary": "Slack統合マッピングを削除", "tags": [ "統合マッピング" ], "x-box-tag": "integration_mappings", "description": "[Slack統合マッピング](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack)を削除します。\n\nこのエンドポイントを使用するには、管理者または共同管理者の役割が必要です。", "parameters": [ { "name": "integration_mapping_id", "description": "統合マッピングのID", "example": "11235432", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "レスポンスの本文は空です。" }, "404": { "description": "統合マッピングが見つからなかった場合、`not_found`エラーを返します。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } }, "default": { "description": "予期しないクライアントエラー。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientError" } } } } } } } }, "components": { "securitySchemes": { "OAuth2Security": { "type": "oauth2", "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": "リーガルホールドの管理" } } } } }, "schemas": { "PostOAuth2Token": { "title": "トークンリクエスト", "type": "object", "description": "新しいOAuth 2.0トークンのリクエスト", "required": [ "grant_type" ], "properties": { "grant_type": { "type": "string", "format": "urn", "example": "authorization_code", "description": "クライアント側で取得される承認コード、更新トークン、JWTアサーション、クライアント資格情報許可、またはトークンのダウンスコープを目的とするその他のアクセストークンを使用して行われているリクエストのタイプ。", "enum": [ "authorization_code", "refresh_token", "client_credentials", "urn:ietf:params:oauth:grant-type:jwt-bearer", "urn:ietf:params:oauth:grant-type:token-exchange" ] }, "client_id": { "type": "string", "description": "アクセストークンをリクエストしているアプリケーションのクライアントID。\n\n`grant_type`に`authorization_code`、`client_credentials`、または`urn:ietf:params:oauth:grant-type:jwt-bearer`が指定されている場合に組み合わせて使用されます。", "example": "ly1nj6n11vionaie65emwzk575hnnmrk" }, "client_secret": { "type": "string", "description": "アクセストークンをリクエストしているアプリケーションのクライアントシークレット。\n\n`grant_type`に`authorization_code`、`client_credentials`、または`urn:ietf:params:oauth:grant-type:jwt-bearer`が指定されている場合に組み合わせて使用されます。", "example": "hOzsTeFlT6ko0dme22uGbQal04SBPYc1" }, "code": { "type": "string", "format": "token", "description": "ユーザーが自身の代わりにAPIコールを行う権限をアプリケーションに付与した後、ブラウザリダイレクト時にBoxからアプリケーションに渡されるクライアント側承認コード。\n\n`authorization_code`との組み合わせで`grant_type`として使用されます。", "example": "n22JPxrh18m4Y0wIZPIqYZK7VRrsMTWW" }, "refresh_token": { "type": "string", "format": "token", "description": "新しいアクセストークンを入手するために使用される更新トークン。\n\n`refresh_token`との組み合わせで`grant_type`として使用されます。", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ" }, "assertion": { "type": "string", "format": "jwt", "description": "新しいアクセストークンをリクエストするJWTアサーション。\n\n`urn:ietf:params:oauth:grant-type:jwt-bearer`との組み合わせで`grant_type`として使用されます。", "example": "xxxxx.yyyyy.zzzzz" }, "subject_token": { "type": "string", "format": "token", "description": "ダウンスコープされたトークンと交換するためのトークン。通常のアクセストークン、JWTアサーション、アプリトークンのいずれかを使用できます。\n\n`urn:ietf:params:oauth:grant-type:token-exchange`との組み合わせで`grant_type`として使用されます。", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ" }, "subject_token_type": { "type": "string", "example": "urn:ietf:params:oauth:token-type:access_token", "description": "渡される`subject_token`のタイプ。\n\n`urn:ietf:params:oauth:grant-type:token-exchange`との組み合わせで`grant_type`として使用されます。", "enum": [ "urn:ietf:params:oauth:token-type:access_token" ] }, "actor_token": { "type": "string", "format": "token", "description": "注釈トークンを作成するためのトークン。これはJWTアサーションです。\n\n`urn:ietf:params:oauth:grant-type:token-exchange`との組み合わせで`grant_type`として使用されます。", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ" }, "actor_token_type": { "type": "string", "format": "urn", "example": "urn:ietf:params:oauth:token-type:id_token", "description": "渡される`actor_token`のタイプ。\n\n`urn:ietf:params:oauth:grant-type:token-exchange`との組み合わせで`grant_type`として使用されます。", "enum": [ "urn:ietf:params:oauth:token-type:id_token" ] }, "scope": { "type": "string", "format": "space_delimited_list", "description": "新しいアクセストークンに割り当てるスコープのスペース区切りリスト。\n\n`subject_token`は、これらすべてのスコープを持っている必要があります。そうでない場合、この呼び出しを行うと、**401 Unauthorized**エラーになります。", "example": "item_upload item_preview base_explorer" }, "resource": { "type": "string", "format": "url", "description": "トークンを生成するファイルの完全なURL。", "example": "https://api.box.com/2.0/files/123456" }, "box_subject_type": { "type": "string", "example": "enterprise", "description": "`client_credentials`との組み合わせで`grant_type`として使用されます。", "enum": [ "enterprise", "user" ] }, "box_subject_id": { "type": "string", "example": "123456789", "description": "`grant_type`に`client_credentials`が指定されている場合に組み合わせて使用されます。値は`box_subject_type`によって決まります。`user`の場合はユーザーIDを使用し、`enterprise`の場合はEnterprise IDを使用します。" }, "box_shared_link": { "type": "string", "format": "url", "description": "トークンが生成されるファイルまたはフォルダの共有リンクの完全なURL。", "example": "https://cloud.box.com/s/123456" } } }, "PostOAuth2Token--RefreshAccessToken": { "title": "アクセストークンを更新", "type": "object", "description": "アクセストークンを更新するリクエスト。有効な更新トークンを使用して期限切れのアクセストークンを更新するには、このAPIを使用します。", "required": [ "grant_type", "client_id", "client_secret", "refresh_token" ], "properties": { "grant_type": { "type": "string", "format": "urn", "example": "refresh_token", "description": "行われているリクエストのタイプ (この場合は更新リクエスト)。", "enum": [ "refresh_token" ] }, "client_id": { "type": "string", "description": "トークンの更新をリクエストしているアプリケーションのクライアントID。", "example": "ly1nj6n11vionaie65emwzk575hnnmrk" }, "client_secret": { "type": "string", "description": "トークンの更新をリクエストしているアプリケーションのクライアントシークレット。", "example": "hOzsTeFlT6ko0dme22uGbQal04SBPYc1" }, "refresh_token": { "type": "string", "format": "token", "description": "更新する更新トークン。", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ" } } }, "PostOAuth2Revoke": { "title": "トークン無効化リクエスト", "type": "object", "description": "OAuth 2.0トークンを無効化するためのリクエスト", "required": [ "grant_type" ], "properties": { "client_id": { "type": "string", "description": "アクセストークンの無効化をリクエストしているアプリケーションのクライアントID。", "example": "ly1nj6n11vionaie65emwzk575hnnmrk" }, "client_secret": { "type": "string", "description": "アクセストークンの無効化をリクエストしているアプリケーションのクライアントシークレット。", "example": "hOzsTeFlT6ko0dme22uGbQal04SBPYc1" }, "token": { "type": "string", "format": "token", "description": "無効にするアクセストークン。", "example": "n22JPxrh18m4Y0wIZPIqYZK7VRrsMTWW" } } }, "ZipDownloadRequest": { "title": "`zip`アーカイブの作成", "type": "object", "description": "ダウンロードする`zip`アーカイブを作成するリクエスト", "required": [ "items" ], "properties": { "items": { "type": "array", "description": "`zip`アーカイブに追加する項目のリスト。項目にはファイルまたはフォルダを指定できます。", "items": { "type": "object", "description": "`zip`アーカイブに追加する項目。項目にはファイルまたはフォルダを指定できます。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "description": "アーカイブに追加する項目の種類。", "example": "file", "enum": [ "file", "folder" ] }, "id": { "type": "string", "description": "アーカイブに追加する項目の識別子。この項目がフォルダの場合、IDが`0`のルートフォルダを指定することはできません。", "example": "12345" } } } }, "download_file_name": { "type": "string", "description": "`zip`アーカイブの名前 (省略可)。この名前には、`January Financials.zip`のように、`.zip`というファイル拡張子が付加されます。", "example": "January Financials" } } }, "MetadataQuery": { "title": "メタデータクエリの検索リクエスト", "type": "object", "description": "SQLに似た構文で特定のメタデータと一致する項目を返す検索を作成します。", "required": [ "from", "ancestor_folder_id" ], "properties": { "from": { "type": "string", "description": "クエリで使用されるテンプレートを指定します。`scope.templateKey`形式にする必要があります。このフィールドですべてのテンプレートを使用できるとは限りません。最も注目すべきは、Boxが提供する組み込みの分類テンプレートはクエリで使用できないことです。", "example": "enterprise_123456.someTemplate" }, "query": { "type": "string", "description": "実行するクエリ。クエリは、SQLの`SELECT`ステートメントによく似た論理式です。検索クエリの値は、`query_param`引数リストで指定されたパラメータに変換できるため、クエリ文字列に検索値を手動で挿入する必要がなくなります。\n\nたとえば、`:amount`という値は、`query_params`オブジェクトの`amount`値を表します。", "example": "value >= :amount" }, "query_params": { "type": "object", "description": "`query`で指定されたパラメータに対応する引数のセット。`query_params`で使用されている各パラメータのタイプは、対応するメタデータテンプレートフィールドのタイプと一致する必要があります。", "example": { "amount": "100" }, "additionalProperties": { "type": "string", "description": "メタデータ検索で使用されている引数の値。\n\nこのパラメータのタイプは、対応するメタデータテンプレートフィールドのタイプと一致する必要があります。", "example": "100", "x-box-example-key": "amount" } }, "ancestor_folder_id": { "type": "string", "description": "クエリを制限しているフォルダのID。値が0の場合は、アクセスできるすべてのフォルダから結果が返されます。値が0以外の場合は、IDに対応するフォルダまたはそのサブフォルダで見つかった結果のみが返されます。", "example": "0" }, "order_by": { "type": "array", "description": "メタデータクエリの結果の並べ替えに使用するテンプレートフィールドと方向のリスト。\n\n並べ替えの`direction`は、配列内の各項目で同じにする必要があります。", "items": { "type": "object", "description": "メタデータクエリの結果の並べ替えに使用するメタデータテンプレートフィールドのいずれかを表すオブジェクト。", "properties": { "field_key": { "type": "string", "description": "並べ替えに使用するメタデータテンプレートフィールド。\n\n`field_key`は、検索対象のメタデータテンプレートのフィールドの`key`値を表します。", "example": "amount" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)。\n\n`ordering`の方向は、配列内の各項目で同じにする必要があります。", "example": "asc", "enum": [ "ASC", "DESC", "asc", "desc" ] } } } }, "limit": { "type": "integer", "description": "単一のリクエストに対して返す結果の最大数を示す0～100の値。これは、上限を示すだけで、返される結果の最小数を保証しません。", "default": 100, "minimum": 0, "maximum": 100, "example": 50 }, "marker": { "type": "string", "description": "次ページをリクエストするために使用するマーカー。", "example": "AAAAAmVYB1FWec8GH6yWu2nwmanfMh07IyYInaa7DZDYjgO1H4KoLW29vPlLY173OKsci6h6xGh61gG73gnaxoS+o0BbI1/h6le6cikjlupVhASwJ2Cj0tOD9wlnrUMHHw3/ISf+uuACzrOMhN6d5fYrbidPzS6MdhJOejuYlvsg4tcBYzjauP3+VU51p77HFAIuObnJT0ff" }, "fields": { "type": "array", "items": { "type": "string" }, "description": "デフォルトでは、このエンドポイントによって、クエリに一致する項目に関する最も基本的な情報のみが返されます。この属性を使用すると、任意の項目に対して返す追加の属性 (メタデータなど) のリストを指定できます。\n\nこの属性は、項目フィールド、メタデータテンプレート識別子、またはメタデータテンプレートフィールド識別子のリストを取得します。\n\n例:\n\n* `created_by`では、項目を作成したユーザーの詳細がレスポンスに追加されます。\n* `metadata..`では、`scope`と`templateKey`によって識別されたメタデータインスタンスのMini版の表示が返されます。\n* `metadata...`では、`scope`と`templateKey`によって識別されたメタデータインスタンスのMini版の表示に加え、`field`名で指定されたフィールドがすべて返されます。同じ`scope`および`templateKey`の複数のフィールドを定義できます。", "example": [ "extension", "created_at", "item_status", "metadata.enterprise_1234.contracts", "metadata.enterprise_1234.regions.location" ] } } }, "FileRequestUpdateRequest": { "title": "ファイルリクエスト (更新)", "type": "object", "description": "ファイルリクエストを更新するためのリクエスト本文。", "properties": { "title": { "type": "string", "description": "ファイルリクエストの新しいタイトル (省略可)。これを使用して、ファイルリクエストのタイトルを変更できます。\n\nデフォルトでは、既存のファイルリクエストの値になります。", "example": "Please upload required documents" }, "description": { "type": "string", "description": "ファイルリクエストの新しい説明 (省略可)。これを使用して、ファイルリクエストの説明を変更できます。\n\nデフォルトでは、既存のファイルリクエストの値になります。", "example": "Please upload required documents" }, "status": { "type": "string", "description": "ファイルリクエストの新しいステータス (省略可)。\n\nこのステータスを`inactive`に設定すると、ファイルリクエストでは新しい送信を受け付けなくなり、ファイルリクエストのURLにアクセスした場合は`HTTP 404`ステータスコードが返されます。\n\nデフォルトでは、既存のファイルリクエストの値になります。", "example": "active", "enum": [ "active", "inactive" ] }, "is_email_required": { "type": "boolean", "example": true, "description": "ファイルリクエストの送信者に、メールアドレスの指定を義務付けるかどうか。\n\nこれをtrueに設定すると、Box UIのファイルリクエストフォームにメールフィールドが表示されます。\n\nデフォルトでは、既存のファイルリクエストの値になります。" }, "is_description_required": { "type": "boolean", "example": true, "description": "ファイルリクエストの送信者に、送信するファイルの説明の指定を義務付けるかどうか。\n\nこれをtrueに設定すると、Box UIのファイルリクエストフォームに説明フィールドが表示されます。\n\nデフォルトでは、既存のファイルリクエストの値になります。" }, "expires_at": { "type": "string", "format": "date-time", "description": "ファイルリクエストが新しい送信を受け付けなくなる日付。\n\nこの日付を過ぎると、`status`は自動的に`inactive`に設定されます。\n\nデフォルトでは、既存のファイルリクエストの値になります。", "example": "2020-09-28T10:53:43-08:00" } } }, "FileRequestCopyRequest": { "title": "ファイルリクエスト (コピー)", "type": "object", "description": "ファイルリクエストをコピーするためのリクエスト本文。", "required": [ "folder" ], "allOf": [ { "$ref": "#/components/schemas/FileRequestUpdateRequest" }, { "properties": { "folder": { "type": "object", "description": "新しいファイルリクエストを関連付けるフォルダ。", "required": [ "id" ], "properties": { "type": { "type": "string", "example": "folder", "description": "`folder`", "enum": [ "folder" ] }, "id": { "type": "string", "example": "42037322", "description": "新しいファイルリクエストを関連付けるフォルダのID。" } } } } } ] }, "SignRequestCreateRequest": { "title": "署名リクエストを作成", "type": "object", "description": "署名リクエストオブジェクトを作成するリクエスト", "required": [ "signers" ], "allOf": [ { "$ref": "#/components/schemas/SignRequest--Base" }, { "properties": { "source_files": { "type": "array", "items": { "$ref": "#/components/schemas/File--Base" }, "description": "署名するドキュメントの作成元ファイルのリスト。現在は、10ファイルに制限されています。ファイルごとにIDフィールドとtypeフィールドのみが必要です。", "maxItems": 10, "nullable": true }, "signature_color": { "type": "string", "example": "blue", "description": "署名に特定の色 (青、黒、または赤) を強制します。", "enum": [ "blue", "black", "red" ], "nullable": true }, "signers": { "type": "array", "items": { "$ref": "#/components/schemas/SignRequestCreateSigner" }, "description": "署名リクエストの署名者の配列。許可されている署名者の最大数は35です。" }, "parent_folder": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "最終的な署名済みドキュメントと署名ログの保存先フォルダ。`ID`フィールドと`type`フィールドのみが必須です。ルートフォルダ (フォルダID `0`) は使用できず、nullにすることもできません。\n\n署名リクエストの作成時にこの値が渡されない場合は、デフォルトのフォルダを使用することになります。デフォルトのフォルダは、ペイロードの最初のソースファイルの親フォルダ (そのフォルダへのアップロード権限がある場合) または「My Sign Requests」という名前のフォルダになります。" } ] } } } ] }, "IntegrationMappingSlackCreateRequest": { "title": "統合マッピングリクエストを作成", "type": "object", "x-box-resource-id": "integration_mapping_slack_create_request", "description": "Slack統合マッピングオブジェクトを作成するリクエスト", "properties": { "partner_item": { "allOf": [ { "$ref": "#/components/schemas/IntegrationMappingPartnerItemSlack" } ], "nullable": false }, "box_item": { "allOf": [ { "$ref": "#/components/schemas/IntegrationMappingBoxItemSlack" } ], "nullable": false }, "options": { "allOf": [ { "$ref": "#/components/schemas/IntegrationMappingSlackOptions" } ], "nullable": false } }, "required": [ "partner_item", "box_item" ] }, "ClientError": { "title": "クライアントエラー", "type": "object", "x-box-resource-id": "client_error", "description": "一般的なエラー", "properties": { "type": { "description": "エラー", "example": "error", "type": "string", "enum": [ "error" ], "nullable": false }, "status": { "description": "レスポンスのHTTPステータス。", "example": 400, "type": "integer", "format": "int32", "nullable": false }, "code": { "description": "Box固有のエラーコード", "example": "item_name_invalid", "type": "string", "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": "エラーについての短い説明メッセージ。", "example": "Method Not Allowed", "type": "string", "nullable": false }, "context_info": { "description": "このエラーに関する追加コンテキストを含む自由形式のオブジェクト。使用できるフィールドは、エンドポイントごとに定義されています。`message`は唯一の例です。", "type": "object", "nullable": true, "properties": { "message": { "type": "string", "description": "エラーの詳細。", "example": "Something went wrong." } } }, "help_url": { "description": "このエラーの原因に関する詳細情報にリンクされたURL。", "example": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/", "type": "string", "nullable": false }, "request_id": { "description": "Boxサポートに連絡するときに使用できる、このレスポンスの一意の識別子。", "type": "string", "example": "abcdef123456", "nullable": false } } }, "ConflictError": { "title": "競合エラー", "type": "object", "x-box-resource-id": "conflict_error", "x-box-tag": "uploads", "description": "競合が原因でファイルを作成できなかったときに発生するエラー。", "allOf": [ { "$ref": "#/components/schemas/ClientError" }, { "properties": { "context_info": { "type": "object", "properties": { "conflicts": { "type": "array", "description": "このエラーの原因であるファイル競合のリスト。", "items": { "$ref": "#/components/schemas/FileConflict" } } } } } } ] }, "OAuth2Error": { "title": "OAuth 2.0エラー", "type": "object", "x-box-resource-id": "oauth2_error", "x-box-tag": "authorization", "description": "OAuth 2.0エラー", "properties": { "error": { "type": "string", "example": "invalid_client", "description": "返されるエラーのタイプ。" }, "error_description": { "type": "string", "example": "The client credentials are not valid", "description": "返されるエラーのタイプ。" } } }, "SkillInvocation": { "title": "スキルのWebhookペイロード", "type": "object", "x-box-resource-id": "skill_invocation", "x-box-tag": "skills", "description": "スキルの`invocation_url`に送信されるBoxスキルのペイロード。", "properties": { "type": { "type": "string", "description": "`skill_invocation`", "example": "skill_invocation", "enum": [ "skill_invocation" ] }, "id": { "type": "string", "description": "呼び出しリクエストの一意の識別子。", "example": "fd1d2e53-35f5-41fb-9c25-4ba326daf2f9_341016304" }, "skill": { "allOf": [ { "title": "スキル", "type": "object", "description": "スキルを表すオブジェクト", "properties": { "id": { "type": "string", "description": "このスキルの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`skill`", "example": "skill", "enum": [ "skill" ] }, "name": { "type": "string", "description": "スキルの名前", "example": "Hello World Skill" }, "api_key": { "type": "string", "description": "アプリケーションのクライアントID", "example": "hxel2s12wd2h9r8ne103c4gjbqefofih" } } }, { "description": "この呼び出しをトリガーしたスキル" } ] }, "token": { "type": "object", "description": "この項目の読み取り専用および読み取り/書き込みアクセス権限トークン", "properties": { "read": { "type": "object", "description": "アクセストークンの基本情報", "properties": { "access_token": { "type": "string", "format": "token", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ", "description": "リクエストされたアクセストークン。" }, "expires_in": { "type": "integer", "format": "int64", "example": 3600, "description": "このトークンが期限切れになるまでの秒数。" }, "token_type": { "type": "string", "enum": [ "bearer" ], "example": "bearer", "description": "返されるアクセストークンのタイプ。" }, "restricted_to": { "type": "string", "description": "このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。", "example": "[{\"scope\":\"gcm\"}, {\"scope\":\"item_upload\",\"object_id\":933941692081,\"object_type\":\"file\"}, {\"scope\":\"manage_skill_invocations\"}]" } } }, "write": { "type": "object", "description": "アクセストークンの基本情報", "properties": { "access_token": { "type": "string", "format": "token", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ", "description": "リクエストされたアクセストークン。" }, "expires_in": { "type": "integer", "format": "int64", "example": 3600, "description": "このトークンが期限切れになるまでの秒数。" }, "token_type": { "type": "string", "enum": [ "bearer" ], "example": "bearer", "description": "返されるアクセストークンのタイプ。" }, "restricted_to": { "type": "string", "description": "このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。", "example": "[{\"scope\":\"gcm\"}, {\"scope\":\"item_upload\",\"object_id\":933941692081,\"object_type\":\"file\"}, {\"scope\":\"manage_skill_invocations\"}]" } } } } }, "status": { "type": "object", "description": "このイベントの詳細のステータス。", "properties": { "state": { "type": "string", "example": "invoked", "description": "このイベントの状態。\n\n* `invoked` - ファイルへのスキルの適用を開始するためにイベント詳細を使用してスキルをトリガーしました。\n* `processing` - 現在処理中です。\n* `success` - 処理が正常に完了しました。\n* `transient_failure` - 再試行可能な問題が発生しました。\n* `permanent_failure` - 再試行しても解決できない永続的な問題が発生しました。", "enum": [ "invoked", "processing", "success", "transient_failure", "permanent_failure" ] }, "message": { "type": "string", "example": "Example", "description": "ステータス情報" }, "error_code": { "type": "string", "example": "400", "description": "エラーコード情報 (エラーが発生した場合)。" }, "additional_info": { "type": "string", "example": "Example", "description": "追加のステータス情報。" } } }, "created_at": { "type": "string", "format": "date-time", "description": "この呼び出しが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trigger": { "type": "string", "example": "FILE_CONTENT", "description": "呼び出しをトリガーしたアクション" }, "enterprise": { "allOf": [ { "title": "Enterprise", "type": "object", "description": "Boxに登録されている会社のレプリゼンテーション", "properties": { "id": { "type": "string", "description": "この会社の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "enum": [ "enterprise" ] }, "name": { "description": "会社の名前", "example": "Acme Inc.", "type": "string" } } }, { "description": "この呼び出しをトリガーする対象になった会社" } ] }, "source": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/File" }, { "$ref": "#/components/schemas/Folder" } ] }, { "description": "呼び出しがトリガーされる原因となった項目" } ] }, "event": { "allOf": [ { "$ref": "#/components/schemas/Event" }, { "description": "この呼び出しをトリガーしたイベント" } ] } } }, "WebhookInvocation": { "title": "Webhook (V2) ペイロード", "type": "object", "x-box-resource-id": "webhook_invocation", "x-box-tag": "webhooks", "description": "イベント発生時にWebhookアドレスに送信されるイベント。", "properties": { "id": { "type": "string", "description": "このWebhook呼び出しの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`webhook_event`", "example": "webhook_event", "enum": [ "webhook_event" ] }, "webhook": { "allOf": [ { "$ref": "#/components/schemas/Webhook" }, { "description": "このイベントをトリガーしたWebhookオブジェクト" } ] }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このイベントをトリガーしたユーザー" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "Webhookイベントがトリガーされた日時を示すタイムスタンプ。", "example": "2012-12-12T10:53:43-08:00" }, "trigger": { "allOf": [ { "title": "Webhookトリガー", "example": "FILE.UPLOADED", "type": "string", "description": "このWebhookをトリガーしたイベント名", "enum": [ "FILE.UPLOADED", "FILE.PREVIEWED", "FILE.DOWNLOADED", "FILE.TRASHED", "FILE.DELETED", "FILE.RESTORED", "FILE.COPIED", "FILE.MOVED", "FILE.LOCKED", "FILE.UNLOCKED", "FILE.RENAMED", "COMMENT.CREATED", "COMMENT.UPDATED", "COMMENT.DELETED", "TASK_ASSIGNMENT.CREATED", "TASK_ASSIGNMENT.UPDATED", "METADATA_INSTANCE.CREATED", "METADATA_INSTANCE.UPDATED", "METADATA_INSTANCE.DELETED", "FOLDER.CREATED", "FOLDER.RENAMED", "FOLDER.DOWNLOADED", "FOLDER.RESTORED", "FOLDER.DELETED", "FOLDER.COPIED", "FOLDER.MOVED", "FOLDER.TRASHED", "WEBHOOK.DELETED", "COLLABORATION.CREATED", "COLLABORATION.ACCEPTED", "COLLABORATION.REJECTED", "COLLABORATION.REMOVED", "COLLABORATION.UPDATED", "SHARED_LINK.DELETED", "SHARED_LINK.CREATED", "SHARED_LINK.UPDATED", "SIGN_REQUEST.COMPLETED", "SIGN_REQUEST.DECLINED", "SIGN_REQUEST.EXPIRED", "SIGN_REQUEST.SIGNER_EMAIL_BOUNCED" ] }, { "description": "このWebhookをトリガーしたイベント名" } ] }, "source": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/File" }, { "$ref": "#/components/schemas/Folder" } ] }, { "description": "イベントがトリガーされる原因となった項目" } ] } } }, "AccessToken": { "title": "アクセストークン", "type": "object", "x-box-resource-id": "access_token", "x-box-tag": "authorization", "description": "認証済みのAPIコールを行うために使用できるトークン。", "properties": { "access_token": { "type": "string", "format": "token", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ", "description": "リクエストされたアクセストークン。" }, "expires_in": { "type": "integer", "format": "int64", "example": 3600, "description": "このトークンが期限切れになるまでの秒数。" }, "token_type": { "type": "string", "enum": [ "bearer" ], "example": "bearer", "description": "返されるアクセストークンのタイプ。" }, "restricted_to": { "type": "array", "description": "このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。", "items": { "$ref": "#/components/schemas/FileOrFolderScope" } }, "refresh_token": { "type": "string", "format": "token", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ", "description": "このアクセストークンの更新トークン。現在のトークンの有効期限が切れて新しいアクセストークンをリクエストするときに使用できます。" }, "issued_token_type": { "type": "string", "format": "urn", "example": "urn:ietf:params:oauth:token-type:access_token", "enum": [ "urn:ietf:params:oauth:token-type:access_token" ], "description": "返されたダウンスコープ済みアクセストークンのタイプ。これは、アクセストークンがダウンスコープされている場合にのみ返されます。" } } }, "Classification": { "title": "分類", "type": "object", "x-box-resource-id": "classification", "x-box-tag": "classifications", "description": "ファイルまたはフォルダに適用される分類を含む、分類メタデータテンプレートのインスタンス。\n\n項目に適用される分類に関する詳細を取得するには、分類メタデータテンプレートをリクエストしてください。", "properties": { "Box__Security__Classification__Key": { "type": "string", "example": "Sensitive", "description": "項目に適用される分類の名前。" }, "$parent": { "type": "string", "example": "folder_59449484661,", "description": "このメタデータインスタンスが追加されている項目の識別子。これは、親の`type`と`id`を`{type}_{id}`という形式で組み合わせたものです。" }, "$template": { "type": "string", "example": "securityClassification-6VMVochwUWo", "description": "`securityClassification-6VMVochwUWo`", "enum": [ "securityClassification-6VMVochwUWo" ] }, "$scope": { "type": "string", "example": "enterprise_27335", "description": "この分類が適用されている会社のスコープ。\n\nこれは`enterprise_{enterprise_id}`形式になります。" }, "$version": { "type": "integer", "example": 1, "description": "メタデータインスタンスのバージョン。このバージョンは0から始まり、分類が更新されるたびに増加します。" }, "$type": { "type": "string", "example": "securityClassification-6VMVochwUWo-fd31537a-0f95-4d86-9f2b-5974a29978f8", "description": "この分類インスタンスの一意のID。これには、分類テンプレートの名前と一意のIDが含まれます。" }, "$typeVersion": { "type": "number", "example": 5, "description": "メタデータテンプレートのバージョン。このバージョンは0から始まり、テンプレートが更新されるたびに増加します。これはほとんどの場合、内部で使用されます。" }, "$canEdit": { "type": "boolean", "example": true, "description": "エンドユーザーが分類を変更できるかどうか。" } } }, "ClassificationTemplate": { "title": "分類テンプレート", "type": "object", "x-box-resource-id": "classification_template", "x-box-tag": "classifications", "description": "会社が定義したセキュリティ分類を保持するメタデータテンプレート。", "required": [ "id", "type", "scope", "displayName", "fields", "templateKey" ], "properties": { "id": { "type": "string", "example": "58063d82-4128-7b43-bba9-92f706befcdf", "description": "分類テンプレートのID。" }, "type": { "type": "string", "description": "`metadata_template`", "example": "metadata_template", "enum": [ "metadata_template" ], "nullable": false }, "scope": { "type": "string", "description": "分類テンプレートのスコープ。これは`enterprise_{id}`形式 (`id`はEnterprise ID) になります。", "example": "enterprise_123456" }, "templateKey": { "type": "string", "example": "securityClassification-6VMVochwUWo", "description": "`securityClassification-6VMVochwUWo`", "enum": [ "securityClassification-6VMVochwUWo" ] }, "displayName": { "type": "string", "example": "Classification", "description": "ウェブインターフェースおよびモバイルインターフェースに表示されるこのテンプレートの名前。", "enum": [ "Classification" ] }, "hidden": { "type": "boolean", "example": false, "description": "このテンプレートを常にウェブインターフェースおよびモバイルインターフェースで使用可能にするかどうかを決定します。" }, "copyInstanceOnItemCopy": { "type": "boolean", "example": true, "description": "ファイルまたはフォルダをコピーするときに分類もコピーするかどうかを決定します。" }, "fields": { "type": "array", "maxItems": 1, "minItems": 1, "description": "この分類テンプレートのフィールドのリスト。これには、`Box__Security__Classification__Key`というフィールドが1つだけ含まれています。これにより、この会社で使用できるさまざまな分類が定義されます。", "items": { "type": "object", "required": [ "id", "type", "key", "displayName", "options" ], "description": "使用可能な分類を表すメタデータテンプレートフィールド。", "properties": { "id": { "type": "string", "example": "822227e0-47a5-921b-88a8-494760b2e6d2", "description": "フィールドの一意のID。" }, "type": { "type": "string", "example": "enum", "description": "配列の項目のタイプ。", "enum": [ "enum" ] }, "key": { "type": "string", "example": "Box__Security__Classification__Key", "description": "企業で使用できる分類を定義します。", "enum": [ "Box__Security__Classification__Key" ] }, "displayName": { "type": "string", "example": "Classification", "description": "`Classification`", "enum": [ "Classification" ] }, "hidden": { "type": "boolean", "example": false, "description": "分類は常にウェブユーザーおよびモバイルユーザーに表示されます。" }, "options": { "type": "array", "description": "この会社で使用できる分類のリスト。", "minItems": 1, "items": { "required": [ "key", "id" ], "type": "object", "description": "この会社で使用できる1つの分類。", "properties": { "id": { "type": "string", "example": "46aea176-3483-4431-856c-6b5b13d1cc50", "description": "この分類の一意のID。" }, "key": { "type": "string", "example": "Sensitive", "description": "この分類の表示名とキー。" }, "staticConfig": { "type": "object", "description": "分類に関する追加情報。", "properties": { "classification": { "type": "object", "description": "分類に関する追加情報。\n\nこれはプロパティの唯一のリストではなく、より多くのオブジェクトフィールドが返される場合があります。これらのフィールドは内部のBox ShieldおよびBox Governanceの目的で使用されるため、これらのフィールドからさらなる値が派生しないようにしてください。", "properties": { "classificationDefinition": { "type": "string", "example": "Sensitive information", "description": "分類の詳しい説明。" }, "colorID": { "type": "integer", "format": "int64", "example": 4, "description": "分類ラベルに色を割り当てる際に使用される内部のBox識別子。\n\n`colorID`と色の間のマッピングは予告なしに変更される場合があります。現在、色のマッピングは以下のとおりです。\n\n* `0`: 黄\n* `1`: オレンジ\n* `2`: 赤\n* `3`: 紫\n* `4`: ライトブルー\n* `5`: ダークブルー\n* `6`: ライトグリーン\n* `7`: グレー" } } } } } } } } } } } } }, "Collaboration": { "title": "Collaboration", "type": "object", "x-box-resource-id": "collaboration", "x-box-tag": "user_collaborations", "description": "アクセス制御リストと同様に、コラボレーションではファイルとフォルダに 対するユーザーおよびグループのアクセス権限が定義されます。コラボレーションオブジェクトは、特定のロールによって定義される権限を含んだファイルまたはフォルダへのアクセス権限をユーザーまたはグループに付与します。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このコラボレーションの一意の識別子。", "example": "12345678" }, "type": { "type": "string", "description": "`collaboration`", "example": "collaboration", "enum": [ "collaboration" ] }, "item": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/File" }, { "$ref": "#/components/schemas/Folder" }, { "$ref": "#/components/schemas/WebLink" } ] }, { "description": "アクセスが許可されているファイルまたはフォルダ。コラボレーションの`status`が`pending`の場合、このフィールドは`null`です。" } ], "nullable": true }, "accessible_by": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/User--Collaborations" }, { "$ref": "#/components/schemas/Group--Mini" } ] }, { "description": "アクセス権限が付与されるユーザーまたはグループ。" } ] }, "invite_email": { "type": "string", "nullable": true, "example": "john@example.com", "description": "登録済みユーザーでない未登録コラボレータを招待するために使用されたメールアドレス。" }, "role": { "type": "string", "example": "editor", "enum": [ "editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner", "owner" ], "description": "付与されるアクセスレベル。" }, "expires_at": { "type": "string", "nullable": true, "format": "date-time", "example": "2012-12-26T10:53:43-08:00", "description": "コラボレーションの有効期限。有効期限が設定されていない場合は`null`。" }, "is_access_only": { "type": "boolean", "example": true, "description": "`true`に設定した場合、コラボレータは共有項目にアクセスできますが、これらの項目は \\[すべてのファイル] リストに表示されません。また、コラボレータには共有項目のルートフォルダのパスも表示されません。" }, "status": { "type": "string", "example": "accepted", "enum": [ "accepted", "pending", "rejected" ], "description": "コラボレーション招待のステータス。ステータスが`pending`の場合、`login`と`name`は空の文字列を返します。" }, "acknowledged_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:55:20-08:00", "description": "コラボレーションオブジェクトの`status`が`accepted`または`rejected`に変更された日時。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Collaborations" }, { "description": "コラボレーションオブジェクトを作成したユーザー。" }, { "example": [ { "id": 33224412 }, { "type": "user" }, { "login": "dylan@example.com" }, { "name": "Dylan Smith" } ] } ] }, "created_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "コラボレーションオブジェクトが作成された日時。" }, "modified_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "コラボレーションオブジェクトが最後に変更された日時。" }, "acceptance_requirements_status": { "type": "object", "properties": { "terms_of_service_requirement": { "type": "object", "properties": { "is_accepted": { "type": "boolean", "nullable": true, "example": true, "description": "サービス利用規約に同意済みかどうか。利用規約への同意が必要ない場合、このフィールドは`null`です。" }, "terms_of_service": { "allOf": [ { "$ref": "#/components/schemas/TermsOfService--Base" }, { "description": "コラボレーションが承認される前に同意する必要があるサービス利用規約。 利用規約への同意が必要ない場合、このフィールドは`null`です。" } ] } } }, "strong_password_requirement": { "type": "object", "properties": { "enterprise_has_strong_password_required_for_external_users": { "type": "boolean", "example": true, "description": "このコンテンツを所有する会社が、このコンテンツでコラボレーションを行うために強力なパスワードを必要とするかどうか。" }, "user_has_strong_password": { "type": "boolean", "nullable": true, "example": true, "description": "ユーザーが自分のアカウントに強力なパスワードを設定しているかどうか。強力なパスワードが必要ない場合、このフィールドは`null`です。" } } }, "two_factor_authentication_requirement": { "type": "object", "properties": { "enterprise_has_two_factor_auth_enabled": { "type": "boolean", "example": true, "description": "このコンテンツを所有する会社が、このコンテンツでのコラボレーションを行うために2要素認証を有効にする必要があるかどうか。" }, "user_has_two_factor_authentication_enabled": { "type": "boolean", "nullable": true, "example": true, "description": "ユーザーが2要素認証を有効にしているかどうか。2要素認証が必要ない場合、このフィールドは`null`です。" } } } } } } }, "Collaborations": { "title": "Collaborations", "type": "object", "x-box-resource-id": "collaborations", "x-box-tag": "user_collaborations", "description": "コラボレーションのリスト", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "コラボレーションのリスト", "items": { "$ref": "#/components/schemas/Collaboration" } } } } ] }, "CollaborationAllowlistEntry": { "title": "許可されたコラボレーションドメイン", "type": "object", "x-box-resource-id": "collaboration_allowlist_entry", "x-box-tag": "collaboration_allowlist_entries", "description": "ユーザーが社内のファイルやフォルダでコラボレーションできる (またはコラボレーションできない) 承認済みドメインを表すエントリ。", "properties": { "id": { "type": "string", "description": "このエントリの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`collaboration_whitelist_entry`", "example": "collaboration_whitelist_entry", "enum": [ "collaboration_whitelist_entry" ] }, "domain": { "type": "string", "example": "example.com", "description": "ホワイトリストに登録されるドメイン" }, "direction": { "type": "string", "example": "both", "description": "許可するコラボレーションの方向。", "enum": [ "inbound", "outbound", "both" ] }, "enterprise": { "allOf": [ { "title": "Enterprise", "type": "object", "description": "Boxに登録されている会社のレプリゼンテーション", "properties": { "id": { "type": "string", "description": "この会社の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "enum": [ "enterprise" ] }, "name": { "description": "会社の名前", "example": "Acme Inc.", "type": "string" } } }, { "description": "このリストが適用される会社" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "エントリが作成された日時", "example": "2012-12-12T10:53:43-08:00" } } }, "CollaborationAllowlistEntries": { "title": "許可されたコラボレーションドメイン", "type": "object", "x-box-resource-id": "collaboration_allowlist_entries", "x-box-tag": "collaboration_allowlist_entries", "description": "コラボレーションが許可されたドメインのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "許可されたコラボレーションドメインのリスト", "items": { "$ref": "#/components/schemas/CollaborationAllowlistEntry" } } } } ] }, "CollaborationAllowlistExemptTarget": { "title": "許可されたコラボレーションドメインからユーザーを除外", "type": "object", "x-box-resource-id": "collaboration_allowlist_exempt_target", "x-box-tag": "collaboration_allowlist_exempt_targets", "description": "この会社に許可されたコラボレーションドメインのリストによって課せられた制限から除外されるユーザー。", "properties": { "id": { "type": "string", "description": "この除外の一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`collaboration_whitelist_exempt_target`", "example": "collaboration_whitelist_exempt_target", "enum": [ "collaboration_whitelist_exempt_target" ] }, "enterprise": { "allOf": [ { "title": "Enterprise", "type": "object", "description": "Boxに登録されている会社のレプリゼンテーション", "properties": { "id": { "type": "string", "description": "この会社の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "enum": [ "enterprise" ] }, "name": { "description": "会社の名前", "example": "Acme Inc.", "type": "string" } } }, { "description": "このエントリが属する会社" } ] }, "user": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "除外されているユーザー" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "エントリが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "エントリが変更された日時", "example": "2012-12-12T10:53:43-08:00" } } }, "CollaborationAllowlistExemptTargets": { "title": "許可されたコラボレーションドメインからユーザーを除外", "type": "object", "x-box-resource-id": "collaboration_allowlist_exempt_targets", "x-box-tag": "collaboration_allowlist_exempt_targets", "description": "この企業に許可されたコラボレーションドメインのリストによって課せられた制限から除外されるユーザーのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "この企業に許可されたコラボレーションドメインのリストによって課せられた制限から除外されるユーザーのリスト。", "items": { "$ref": "#/components/schemas/CollaborationAllowlistExemptTarget" } } } } ] }, "Collection": { "title": "Collection", "type": "object", "x-box-resource-id": "collection", "x-box-tag": "collections", "description": "ファイルやフォルダなどの項目のコレクション。\n\n現時点で利用可能なコレクションは、`favorites`コレクションのみです。\n\nコレクションのコンテンツは、フォルダのコンテンツと同じ方法で調べることができます。", "properties": { "id": { "type": "string", "description": "このコレクションの一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`collection`", "example": "collection", "enum": [ "collection" ] }, "name": { "type": "string", "description": "コレクションの名前。", "enum": [ "Favorites" ], "example": "Favorites" }, "collection_type": { "type": "string", "description": "コレクションのタイプ。 これは、コレクションの視覚効果を適切に決定するために使用されます。", "enum": [ "favorites" ], "example": "favorites" } } }, "Collections": { "title": "Collections", "type": "object", "x-box-resource-id": "collections", "x-box-tag": "collections", "description": "コレクションのリスト", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "コレクションのリスト", "items": { "$ref": "#/components/schemas/Collection" } } } } ] }, "Comment": { "title": "Comment", "type": "object", "description": "コメントのStandard版の表示。", "x-box-resource-id": "comment", "x-box-variant": "standard", "allOf": [ { "$ref": "#/components/schemas/Comment--Base" }, { "properties": { "is_reply_comment": { "type": "boolean", "description": "このコメントが他のコメントへの返信かどうか", "example": true }, "message": { "type": "string", "example": "@Aaron Levie these tigers are cool!", "description": "ユーザーが入力したコメントのテキスト" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "コメント作成者をMini版のユーザオブジェクトで表示" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "このコメントが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このコメントが最後に変更された日時", "example": "2012-12-12T10:53:43-08:00" }, "item": { "allOf": [ { "title": "Reference", "description": "オブジェクトの最も基本的な参照", "type": "object", "properties": { "id": { "type": "string", "description": "このオブジェクトの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "このオブジェクトのタイプ", "example": "file" } } }, { "description": "このコメントが追加されたファイル" } ] } } } ] }, "Comments": { "title": "Comments", "type": "object", "x-box-resource-id": "comments", "x-box-tag": "comments", "description": "コメントのリスト", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "コメントのリスト", "items": { "$ref": "#/components/schemas/Comment--Full" } } } } ] }, "Comment--Base": { "title": "コメント (Base)", "type": "object", "x-box-resource-id": "comment--base", "x-box-sanitized": true, "x-box-tag": "comments", "x-box-variants": [ "base", "standard", "full" ], "x-box-variant": "base", "description": "コメントのBase版の表示。", "properties": { "id": { "type": "string", "description": "このコメントの一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`comment`", "example": "comment", "enum": [ "comment" ] } } }, "Comment--Full": { "title": "コメント (Full)", "type": "object", "x-box-resource-id": "comment--full", "x-box-variant": "full", "description": "コメントとは、ファイルに関して作成されるメッセージです。コメントは単独で作成することも、他のコメントへの返答として作成することもできます", "allOf": [ { "$ref": "#/components/schemas/Comment" }, { "properties": { "tagged_message": { "type": "string", "example": "@[1234567:Aaron Levie] these tigers are cool!", "description": "@メンションを含むコメントテキストを表す文字列。@メンションの形式は@\\[id:username] で、`id`はユーザーのBox ID、`username`はユーザーの表示名になります。" } } } ] }, "DevicePinner": { "title": "Device Pinner", "type": "object", "x-box-resource-id": "device_pinner", "x-box-tag": "device_pinners", "description": "デバイスピンを使用すると、どのデバイスでネイティブBoxアプリケーションの使用を許可するかを会社レベルで制御できます。", "properties": { "id": { "type": "string", "description": "このデバイスピンの一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`device_pinner`", "example": "device_pinner", "enum": [ "device_pinner" ] }, "owned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "デバイスピンが属するユーザー" } ] }, "product_name": { "type": "string", "description": "ピニングが設定されているデバイスのタイプ", "example": "iPad" } } }, "DevicePinners": { "title": "Device Pinner", "type": "object", "x-box-resource-id": "device_pinners", "x-box-tag": "device_pinners", "description": "デバイスピンのリスト", "properties": { "entries": { "type": "array", "description": "デバイスピンのリスト", "items": { "$ref": "#/components/schemas/DevicePinner" } }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。", "default": 100, "example": 200, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": 3000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "id", "enum": [ "id" ], "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "asc", "enum": [ "asc", "desc" ] } } } } } }, "EmailAlias": { "title": "メールエイリアス", "type": "object", "x-box-resource-id": "email_alias", "x-box-tag": "email_aliases", "description": "ユーザーのメールエイリアス。", "properties": { "id": { "type": "string", "description": "このオブジェクトの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`email_alias`", "example": "email_alias", "enum": [ "email_alias" ] }, "email": { "type": "string", "description": "メールアドレス", "example": "alias@example.com" }, "is_confirmed": { "type": "boolean", "description": "メールアドレスが確認済みかどうか", "example": true } } }, "EmailAliases": { "title": "メールエイリアス", "type": "object", "x-box-resource-id": "email_aliases", "x-box-tag": "email_aliases", "description": "メールエイリアスのリスト", "properties": { "total_count": { "description": "メールエイリアスの数。", "example": 5000, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "メールエイリアスのリスト", "items": { "$ref": "#/components/schemas/EmailAlias" } } } }, "Enterprise--Base": { "title": "企業 (Base)", "type": "object", "x-box-resource-id": "enterprise--base", "x-box-variants": [ "base", "mini", "standard", "full" ], "x-box-variant": "base", "description": "他のリソース内にネストされたときに使用される企業のMini版の表示。", "properties": { "id": { "type": "string", "description": "この企業の一意の識別子", "example": "1910967" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "nullable": false, "enum": [ "enterprise" ] } } }, "Event": { "title": "Event", "type": "object", "x-box-resource-id": "event", "x-box-tag": "events", "description": "Box内で発生したイベントの説明", "properties": { "type": { "description": "`event`", "type": "string", "example": "event" }, "created_at": { "type": "string", "format": "date-time", "description": "イベントオブジェクトが作成された日時", "example": "2022-12-12T10:53:43-08:00" }, "recorded_at": { "type": "string", "format": "date-time", "description": "イベントオブジェクトがデータベースに記録された日時", "example": "2022-12-12T10:54:43-08:00" }, "event_id": { "type": "string", "example": "f82c3ba03e41f7e8a7608363cc6c0390183c3f83", "description": "イベントオブジェクトのID。これは、重複したイベントの検出に使用できます" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "イベントが表すアクションを実行したユーザー。 イベントの中には、Boxにログインしていないユーザーによって実行されるものもあります。その場合は、オブジェクトの一部の属性が設定されず、イベントの実行者は不明なユーザー (`user_id = 2`) に設定されます" } ] }, "event_type": { "allOf": [ { "title": "イベントタイプ", "example": "FILE_MARKED_MALICIOUS", "type": "string", "description": "イベントをトリガーできるイベントタイプ", "enum": [ "ACCESS_GRANTED", "ACCESS_REVOKED", "ADD_DEVICE_ASSOCIATION", "ADD_LOGIN_ACTIVITY_DEVICE", "ADMIN_LOGIN", "APPLICATION_CREATED", "APPLICATION_PUBLIC_KEY_ADDED", "APPLICATION_PUBLIC_KEY_DELETED", "CHANGE_ADMIN_ROLE", "CHANGE_FOLDER_PERMISSION", "COLLABORATION_ACCEPT", "COLLABORATION_EXPIRATION", "COLLABORATION_INVITE", "COLLABORATION_REMOVE", "COLLABORATION_ROLE_CHANGE", "COLLAB_ADD_COLLABORATOR", "COLLAB_INVITE_COLLABORATOR", "COLLAB_REMOVE_COLLABORATOR", "COLLAB_ROLE_CHANGE", "COMMENT_CREATE", "COMMENT_DELETE", "CONTENT_ACCESS", "CONTENT_WORKFLOW_ABNORMAL_DOWNLOAD_ACTIVITY", "CONTENT_WORKFLOW_AUTOMATION_ADD", "CONTENT_WORKFLOW_AUTOMATION_DELETE", "CONTENT_WORKFLOW_POLICY_ADD", "CONTENT_WORKFLOW_SHARING_POLICY_VIOLATION", "CONTENT_WORKFLOW_UPLOAD_POLICY_VIOLATION", "COPY", "DATA_RETENTION_CREATE_RETENTION", "DATA_RETENTION_REMOVE_RETENTION", "DELETE", "DELETE_USER", "DEVICE_TRUST_CHECK_FAILED", "DOWNLOAD", "EDIT", "EDIT_USER", "EMAIL_ALIAS_CONFIRM", "EMAIL_ALIAS_REMOVE", "ENABLE_TWO_FACTOR_AUTH", "ENTERPRISE_APP_AUTHORIZATION_UPDATE", "FAILED_LOGIN", "FILE_MARKED_MALICIOUS", "FILE_WATERMARKED_DOWNLOAD", "GROUP_ADD_ITEM", "GROUP_ADD_USER", "GROUP_CREATION", "GROUP_DELETION", "GROUP_EDITED", "GROUP_REMOVE_ITEM", "GROUP_REMOVE_USER", "ITEM_COPY", "ITEM_CREATE", "ITEM_DOWNLOAD", "ITEM_MAKE_CURRENT_VERSION", "ITEM_MODIFY", "ITEM_MOVE", "ITEM_OPEN", "ITEM_PREVIEW", "ITEM_RENAME", "ITEM_SHARED", "ITEM_SHARED_CREATE", "ITEM_SHARED_UNSHARE", "ITEM_SHARED_UPDATE", "ITEM_SYNC", "ITEM_TRASH", "ITEM_UNDELETE_VIA_TRASH", "ITEM_UNSYNC", "ITEM_UPLOAD", "LEGAL_HOLD_ASSIGNMENT_CREATE", "LEGAL_HOLD_ASSIGNMENT_DELETE", "LEGAL_HOLD_POLICY_CREATE", "LEGAL_HOLD_POLICY_DELETE", "LEGAL_HOLD_POLICY_UPDATE", "LOCK", "LOCK_CREATE", "LOCK_DESTROY", "LOGIN", "MASTER_INVITE_ACCEPT", "MASTER_INVITE_REJECT", "METADATA_INSTANCE_CREATE", "METADATA_INSTANCE_DELETE", "METADATA_INSTANCE_UPDATE", "METADATA_TEMPLATE_CREATE", "METADATA_TEMPLATE_DELETE", "METADATA_TEMPLATE_UPDATE", "MOVE", "NEW_USER", "PREVIEW", "REMOVE_DEVICE_ASSOCIATION", "REMOVE_LOGIN_ACTIVITY_DEVICE", "RENAME", "RETENTION_POLICY_ASSIGNMENT_ADD", "SHARE", "SHARE_EXPIRATION", "SHIELD_ALERT", "SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED", "SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED_MISSING_JUSTIFICATION", "SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED", "SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED_MISSING_JUSTIFICATION", "SHIELD_JUSTIFICATION_APPROVAL", "SHIELD_SHARED_LINK_ACCESS_BLOCKED", "SHIELD_SHARED_LINK_STATUS_RESTRICTED_ON_CREATE", "SHIELD_SHARED_LINK_STATUS_RESTRICTED_ON_UPDATE", "SIGN_DOCUMENT_ASSIGNED", "SIGN_DOCUMENT_CANCELLED", "SIGN_DOCUMENT_COMPLETED", "SIGN_DOCUMENT_CONVERTED", "SIGN_DOCUMENT_CREATED", "SIGN_DOCUMENT_DECLINED", "SIGN_DOCUMENT_EXPIRED", "SIGN_DOCUMENT_SIGNED", "SIGN_DOCUMENT_VIEWED_BY_SIGNED", "SIGNER_DOWNLOADED", "SIGNER_FORWARDED", "STORAGE_EXPIRATION", "TAG_ITEM_CREATE", "TASK_ASSIGNMENT_CREATE", "TASK_ASSIGNMENT_DELETE", "TASK_ASSIGNMENT_UPDATE", "TASK_CREATE", "TASK_UPDATE", "TERMS_OF_SERVICE_ACCEPT", "TERMS_OF_SERVICE_REJECT", "UNDELETE", "UNLOCK", "UNSHARE", "UPDATE_COLLABORATION_EXPIRATION", "UPDATE_SHARE_EXPIRATION", "UPLOAD", "USER_AUTHENTICATE_OAUTH2_ACCESS_TOKEN_CREATE", "WATERMARK_LABEL_CREATE", "WATERMARK_LABEL_DELETE" ] }, { "description": "このイベントをトリガーしたイベントタイプ" } ] }, "session_id": { "type": "string", "example": "70090280850c8d2a1933c1", "description": "アクションを実行したユーザーのセッション。この属性にすべてのイベントが入るわけではありません。" }, "source": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/User" }, { "$ref": "#/components/schemas/EventSource" }, { "$ref": "#/components/schemas/File" }, { "$ref": "#/components/schemas/Folder" }, { "$ref": "#/components/schemas/GenericSource" } ] }, { "description": "このイベントをトリガーしたリソース。詳細については、イベントトリガーに関するガイドを確認してください。" } ] }, "additional_details": { "type": "object", "example": { "key": "value" }, "description": "このオブジェクトは、イベントに関する追加情報を提供します (利用可能な場合)。\n\nこれには、ユーザーがイベントを実行した方法に加え、イベントを外部のKeySafeログに関連付けるための追加情報が含まれます。すべてのイベントに`additional_details`オブジェクトがあるわけではありません。このオブジェクトは、Enterprise Eventのみに存在します。" } } }, "Events": { "title": "Events", "type": "object", "x-box-resource-id": "events", "x-box-tag": "events", "description": "イベントオブジェクトのリスト", "properties": { "chunk_size": { "description": "このレスポンスで返されるイベントの数。", "example": 2, "type": "integer", "format": "int64" }, "next_stream_position": { "description": "次のイベントページ (チャンク) のストリーム開始位置。", "example": "1152922976252290886", "type": "string" }, "entries": { "type": "array", "description": "イベントのリスト", "items": { "$ref": "#/components/schemas/Event" } } } }, "File": { "title": "File", "type": "object", "x-box-resource-id": "file", "x-box-variant": "standard", "description": "任意のファイルAPIエンドポイントからデフォルトで返されるファイルのStandard版の表示。", "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "properties": { "description": { "type": "string", "nullable": false, "description": "このファイルの説明 (省略可)", "maxLength": 256, "example": "Contract for Q1 renewal" }, "size": { "type": "integer", "nullable": false, "description": "ファイルサイズ (バイト単位)。この整数を解析する際には、非常に大きな数値となって整数オーバーフローになる可能性があるため、注意が必要です。", "example": 629644 }, "path_collection": { "allOf": [ { "title": "パスのコレクション", "description": "項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "type": "array", "description": "この項目の親フォルダ", "nullable": false, "items": { "$ref": "#/components/schemas/Folder--Mini" } } } }, { "description": "ルートフォルダを起点にした、このファイルを含むフォルダツリー。" }, { "nullable": false } ] }, "created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Box上でこのファイルが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Boxでこのファイルが最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trashed_at": { "type": "string", "format": "date-time", "description": "このファイルがごみ箱に移動された日時。", "example": "2012-12-12T10:53:43-08:00", "nullable": true }, "purged_at": { "type": "string", "format": "date-time", "description": "このファイルがごみ箱から削除される予定日時。", "example": "2012-12-12T10:53:43-08:00", "nullable": true }, "content_created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最初に作成された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "content_modified_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最後に更新された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "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上のファイルやフォルダに対する読み取り専用アクセスを直接実行できます。\n\nアクセスレベルがopenに設定されている共有リンクの場合は、URLを知っているすべてのユーザーが項目にアクセスでき、アクセスレベルがcompanyまたはcollaboratorsに設定されている共有リンクの場合は、適切に認証されたBoxユーザーのみが項目にアクセスできます。", "type": "object", "required": [ "url", "accessed", "effective_access", "effective_permission", "is_password_enabled", "download_count", "preview_count" ], "properties": { "url": { "type": "string", "format": "url", "description": "Box上の項目にアクセスするために使用できるURL。\n\nこのURLに移動すると、BoxのプレビューUIに項目が表示され、許可されている場合は、このUIからファイルをダウンロードできます。\n\nこのURLは、この共有リンクに対してカスタムの`vanity_url`が 設定されている場合でも動作します。", "example": "https://www.box.com/s/vspke7y05sb214wjokpk", "nullable": false }, "download_url": { "type": "string", "format": "url", "x-box-premium-feature": true, "description": "ファイルをダウンロードするために使用できるURL。このURLをブラウザで使用すると、ファイルをダウンロードできます。このURLには、ファイルを正しいファイルタイプで保存できるように、ファイル拡張子が含まれます。\n\nフォルダの場合、このプロパティは`null`になります。", "example": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg", "nullable": true }, "vanity_url": { "type": "string", "format": "url", "description": "Boxで項目をプレビューする目的にも使用できる「カスタムURL」。カスタムURLの作成と変更は、Boxウェブアプリケーションでのみ行えます。", "example": "https://acme.app.box.com/v/my_url/", "nullable": true }, "vanity_name": { "type": "string", "description": "`vanity_url`フィールドで使用される、共有リンクのカスタム名。", "example": "my_url", "nullable": true }, "access": { "type": "string", "description": "この共有リンクのアクセスレベル\n\n* `open` - このリンクを知っている全員にこの項目へのアクセスを許可します\n* `company` - 同じ会社のユーザーにのみこの項目へのアクセスを許可します\n* `collaborators` - この項目のコラボレータとなっているユーザーに対してのみこの項目へのアクセスを許可します\n\n共有リンクの作成時にこのフィールドを省略した場合は、Enterprise管理者によって指定されたデフォルトのアクセスレベルに設定されます。", "enum": [ "open", "company", "collaborators" ], "example": "open", "nullable": false }, "effective_access": { "type": "string", "description": "共有リンクの実際のアクセスレベル。許可されるアクセスレベルが会社の設定で制限されている場合は、`access`フィールドの値よりも低いアクセスレベルになることがあります。", "enum": [ "open", "company", "collaborators" ], "example": "company", "nullable": false }, "effective_permission": { "type": "string", "description": "この共有リンクの実際の権限。これらにより、共有リンクの権限と、管理者、所有者、任意の先祖項目 (フォルダなど) によって設定される項目の権限の組み合わせの制限が厳しくなります。", "enum": [ "can_edit", "can_download", "can_preview", "no_access" ], "example": "can_download", "nullable": false }, "unshared_at": { "type": "string", "format": "date-time", "description": "このリンクが共有解除される日時。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。", "example": "2018-04-13T13:53:23-07:00", "nullable": true }, "is_password_enabled": { "type": "boolean", "description": "共有リンクを通じて項目にアクセスする際にパスワードを要求するかどうかを定義します。", "example": true, "nullable": false }, "permissions": { "type": "object", "description": "このリンクを通じてユーザーが項目のプレビュー、編集、およびダウンロードを行うことを許可するかどうかを定義します。これらの権限は、共有リンクのみに適用され、その項目自体に適用される権限より優先されることはありません。", "required": [ "can_download", "can_preview", "can_edit" ], "properties": { "can_download": { "type": "boolean", "example": true, "nullable": false, "description": "共有リンクを通じて項目をダウンロードすることを許可するかどうかを定義します。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。\n\n実際のアクセスレベルが`collaborators`ではなく、`open`または`company`に設定されている場合は、この値を`true`に設定できます。" }, "can_preview": { "type": "boolean", "example": true, "nullable": false, "description": "共有リンクを通じて項目をプレビューすることを許可するかどうかを定義します。\n\nこの値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": false, "nullable": false, "description": "共有リンクからの項目の編集を許可するかどうかを定義します。\n\n`can_download`が`true`で、項目のタイプが`file`の場合のみ、この値も`true`に設定できます。" } } }, "download_count": { "type": "integer", "example": 3, "description": "この項目がダウンロードされた回数。", "nullable": false }, "preview_count": { "type": "integer", "example": 3, "description": "この項目がプレビューされた回数。", "nullable": false } } }, { "description": "このファイルの共有リンク。このファイルに対してまだ共有リンクが作成されていない場合は、`null`になります。" }, { "nullable": true } ] }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このファイルが配置されているフォルダ。" } ], "nullable": true }, "item_status": { "type": "string", "description": "この項目が削除されたかどうかを定義します。\n\n* `active` - 項目がごみ箱に移動されていない場合。\n* `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。\n* `deleted` - 項目がすでに完全に削除されている場合。", "enum": [ "active", "trashed", "deleted" ], "nullable": false, "example": "active" } } } ] }, "FileConflict": { "title": "ファイル (競合)", "type": "object", "x-box-sanitized": true, "x-box-resource-id": "file_conflict", "x-box-tag": null, "description": "以前出力されていたファイルの表示。", "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "properties": { "sha1": { "type": "string", "example": "85136C79CBF9FE36BB9D05D0639C70C265C18D37", "description": "ファイルのSHA1ハッシュ。" }, "file_version": { "$ref": "#/components/schemas/FileVersion--Mini" } } } ] }, "Files": { "title": "Files", "type": "object", "x-box-resource-id": "files", "x-box-tag": "files", "description": "ファイルのリスト", "properties": { "total_count": { "description": "ファイルの数。", "example": 1, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "ファイルのリスト", "items": { "$ref": "#/components/schemas/File--Full" } } } }, "File--Full": { "title": "ファイル (Full)", "type": "object", "x-box-resource-id": "file--full", "x-box-variant": "full", "description": "任意のファイルAPIエンドポイントからデフォルトで返される可能性があるファイルのFull版の表示。", "allOf": [ { "$ref": "#/components/schemas/File" }, { "properties": { "version_number": { "type": "string", "example": "1", "description": "このファイルのバージョン番号" }, "comment_count": { "type": "integer", "example": 10, "description": "このファイルに関するコメントの数" }, "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": { "type": "boolean", "description": "現在のユーザーがこの項目を削除できるかどうかを指定します。", "example": true, "nullable": false }, "can_download": { "type": "boolean", "description": "現在のユーザーがこの項目をダウンロードできるかどうかを指定します。", "example": true, "nullable": false }, "can_invite_collaborator": { "type": "boolean", "description": "現在のユーザーがこの項目でのコラボレーションに新しいユーザーを招待できるかどうかと、この項目ですでにコラボレーションしているユーザーのロールを更新できるかどうかを指定します。", "example": true, "nullable": false }, "can_rename": { "type": "boolean", "description": "ユーザーがこの項目の名前を変更できるかどうかを指定します。", "example": true, "nullable": false }, "can_set_share_access": { "type": "boolean", "description": "ユーザーがこの項目の既存の共有リンクのアクセスレベルを変更できるかどうかを指定します。", "example": true, "nullable": false }, "can_share": { "type": "boolean", "description": "ユーザーがこの項目の共有リンクを作成できるかどうかを指定します。", "example": true, "nullable": false } } }, { "properties": { "can_annotate": { "type": "boolean", "description": "ユーザーがこのファイルに注釈を付けられるかどうかを指定します。", "example": true, "nullable": false }, "can_comment": { "type": "boolean", "description": "ユーザーがこのファイルにコメントを追加できるかどうかを指定します。", "example": true, "nullable": false }, "can_preview": { "type": "boolean", "description": "ユーザーがこのファイルをプレビューできるかどうかを指定します。", "example": true, "nullable": false }, "can_upload": { "type": "boolean", "description": "ユーザーがこのファイルの新しいバージョンをアップロードできるかどうかを指定します。", "example": true, "nullable": false }, "can_view_annotations_all": { "type": "boolean", "description": "ユーザーに対してこのファイルに付けられたすべての注釈を表示するかどうかを指定します", "example": true, "nullable": false }, "can_view_annotations_self": { "type": "boolean", "description": "ユーザーに対して自分が付けた注釈を表示するかどうかを指定します", "example": true, "nullable": false } } } ] }, { "description": "このファイルに対して現在のユーザーが持っている権限について説明します。" }, { "nullable": false } ] }, "tags": { "allOf": [ { "type": "array", "example": [ "approved" ], "items": { "type": "string" }, "minItems": 1, "maxItems": 100, "description": "この項目のタグ。これらのタグはBoxウェブアプリおよびモバイルアプリで項目の横に表示されます。\n\nタグを追加または削除するには、項目の現在のタグを取得して変更してから、このフィールドを更新します。\n\nタグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに制限されます。" }, { "nullable": false } ] }, "lock": { "allOf": [ { "title": "Lock", "type": "object", "description": "ファイルで保持されているロック。ロックにより、ロックを作成したユーザー以外は、ファイルを移動、名前変更、および変更できません。", "properties": { "id": { "type": "string", "description": "このロックの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`lock`", "example": "lock", "enum": [ "lock" ] }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "ロックを作成したユーザー。" } ] }, "created_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "このロックが作成された日時。" }, "expired_at": { "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00", "description": "このロックが期限切れになる日時。過去の日時になる場合もあります。" }, "is_download_prevented": { "type": "boolean", "example": true, "description": "ロック中でもファイルのダウンロードを許可するかどうか。" }, "app_type": { "type": "string", "description": "ロックを管理しているのがユーザーではなくアプリケーションの場合、このフィールドは、ロックを保持しているアプリケーションの種類を示します。これはオープンな列挙型で、今後、値の追加により拡張される可能性があります。", "enum": [ "gsuite", "office_wopi", "office_wopiplus", "other" ], "example": "office_wopiplus", "nullable": true } } }, { "description": "このファイルで保持されているロック。ロックが存在しない場合は`null`になるか、過去のタイムスタンプになります。" } ], "nullable": true }, "extension": { "type": "string", "example": "pdf", "description": "このファイルのファイル拡張子 (省略可) を示します。デフォルトでは、空の文字列に設定されます。" }, "is_package": { "type": "boolean", "example": true, "description": "ファイルがパッケージかどうかを示します。パッケージはMacアプリケーションで一般的に使用され、iWorkファイルを含めることができます。" }, "expiring_embed_link": { "allOf": [ { "title": "有効期限付き埋め込みリンク", "type": "object", "description": "有効期限付きのBox Embedリンク。", "allOf": [ { "type": "object", "description": "アクセストークンの基本情報", "properties": { "access_token": { "type": "string", "format": "token", "example": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ", "description": "リクエストされたアクセストークン。" }, "expires_in": { "type": "integer", "format": "int64", "example": 3600, "description": "このトークンが期限切れになるまでの秒数。" }, "token_type": { "type": "string", "enum": [ "bearer" ], "example": "bearer", "description": "返されるアクセストークンのタイプ。" }, "restricted_to": { "type": "array", "description": "このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。", "items": { "$ref": "#/components/schemas/FileOrFolderScope" } } } }, { "properties": { "url": { "type": "string", "format": "url", "example": "https://cloud.app.box.com/preview/expiring_embed/...", "description": "このファイルの実際の有効期限付き埋め込みURL。このオブジェクトで指定されたファイルIDとアクセストークンから作成されます。" } } } ] }, { "description": "このフィールドをリクエストすると、`iframe`に埋め込まれたプレビューセッション用の有効期限付きBox Embed URLが作成されます。\n\nこのURLは60秒後に有効期限切れとなり、セッションはその60分後に有効期限切れとなります。\n\n一部のファイルタイプは、これらの埋め込みURLでサポートされていません。Box Embedはモバイルブラウザ向けに最適化されていないため、モバイルデバイス用に設計されたウェブエクスペリエンスでは使用しないでください。多くのUI Element (**ダウンロード**オプションや**印刷**オプションなど) はモバイルブラウザに表示されない可能性があります。" } ] }, "watermark_info": { "allOf": [ { "type": "object", "description": "この項目に適用された電子すかしに関する詳細", "properties": { "is_watermarked": { "type": "boolean", "description": "この項目に電子すかしが適用されているかどうかを指定します。", "example": true, "nullable": false } } }, { "description": "このファイルに適用された電子すかしに関する詳細" } ] }, "is_accessible_via_shared_link": { "type": "boolean", "description": "直接共有リンクまたは親フォルダへの共有リンクを使用してファイルにアクセスできるかどうかを指定します。", "example": true, "enum": [ true, false ] }, "allowed_invitee_roles": { "type": "array", "example": [ "editor" ], "nullable": false, "description": "このファイルを共有するときに招待できるユーザーの役割タイプのリスト。", "items": { "type": "string", "enum": [ "editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner" ] } }, "is_externally_owned": { "type": "boolean", "example": true, "nullable": false, "description": "このファイルが認証済みの会社以外のユーザーによって所有されているかどうかを指定します。" }, "has_collaborations": { "type": "boolean", "example": true, "nullable": false, "description": "このファイルに他のコラボレータが存在するかどうかを指定します。" }, "metadata": { "allOf": [ { "title": "項目メタデータインスタンス", "type": "object", "description": "`scope`および`templateKey`のキー/値ペア内にネストされている、メタデータインスタンスのリスト。\n\nファイルまたはフォルダのメタデータにアクセスするには、最初にメタデータエンドポイントを使用して、会社で使用できるメタデータテンプレートを特定します。\n\nその後、`fields`クエリパラメータを指定して`GET /files/:id`または`GET /folder/:id`エンドポイントを使用すると、IDを指定してメタデータを取得できます。\n\n特定の`scope`および`templateKey`のメタデータインスタンスをリクエストするには、`fields`パラメータに次の形式を使用してください。 `metadata..`\n\nたとえば、`?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" } } }, { "description": "このファイルに追加されたメタデータインスタンスを含むオブジェクト。\n\n各メタデータインスタンスは、その`scope`と`templateKey`によって一意に識別されます。各ファイルに追加されるメタデータテンプレートのインスタンスは1つだけです。各メタデータインスタンスは、キーとして`templateKey`が指定されているオブジェクト内にネストされ、さらにそのオブジェクト自体もキーとして`scope`が指定されているオブジェクト内にネストされます。" } ] }, "expires_at": { "type": "string", "format": "date-time", "nullable": true, "description": "ファイルが自動的に削除される日時", "example": "2012-12-12T10:53:43-08:00" }, "representations": { "allOf": [ { "title": "Representations", "description": "ファイル表示のリスト。", "type": "object", "properties": { "entries": { "type": "array", "description": "ファイルのリスト", "items": { "type": "object", "description": "ファイル表示。", "properties": { "content": { "type": "object", "description": "レプリゼンテーションを実際に取得するために使用できるURLを含むオブジェクト。", "properties": { "url_template": { "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", "description": "レプリゼンテーションを取得するために使用できるダウンロードURL。このエンドポイントに対しては必ず認証済みAPIコールを行ってください。\n\nこのURLはテンプレートであるため、`{+asset_path}`を実際のパスに置き換える必要があります。通常、ページ付けが行われていないレプリゼンテーションの場合は、空の文字列に置き換えることができます。\n\nページ割りされたレプリゼンテーションの場合は、`1.pdf`など、リクエストするページにファイル拡張子を付けた文字列で`{+asset_path}`を置き換えます。\n\nダウンロードURLをリクエストする際には、以下の追加クエリパラメータを渡すことができます。\n\n* `set_content_disposition_type` - 配置タイプとして`inline`または`attachment`のいずれかを指定してAPIレスポンスの`Content-Disposition`ヘッダーを設定します。このパラメータを指定しない場合、レスポンスに`Content-Disposition`ヘッダーは含まれません。\n\n* `set_content_disposition_filename` - `Content-Disposition`ヘッダーで使用するレプリゼンテーションのファイル名をアプリケーションで定義できます。定義しない場合は、Boxのソースファイル名から派生したファイル名とレプリゼンテーション拡張子の組み合わせがファイル名になります。" } } }, "info": { "type": "object", "description": "このレプリゼンテーションの詳細を取得するために使用できるURLを含むオブジェクト。", "properties": { "url": { "type": "string", "example": "https://api.box.com/2.0/internal_files/123/versions/345/representations/png_paged_2048x2048", "description": "このファイルレプリゼンテーションの詳細を取得するために使用できるAPI URL。このエンドポイントに対しては必ず認証済みAPIコールを行ってください。" } } }, "properties": { "type": "object", "description": "このプレゼンテーションのサイズとタイプを含むオブジェクト。", "properties": { "dimensions": { "type": "string", "format": "x", "example": "2048x2048", "description": "このレプリゼンテーションの幅と高さ。" }, "paged": { "type": "boolean", "example": true, "description": "レプリゼンテーションが複数のページで構成されているかどうかを示します。" }, "thumb": { "type": "boolean", "example": true, "description": "そのレプリゼンテーションをファイルのサムネイルとして使用できるかどうかを示します。" } } }, "representation": { "type": "string", "example": "png", "description": "返されたレプリゼンテーションのファイルタイプを示します。" }, "status": { "type": "object", "description": "このレプリゼンテーションのステータスを含むオブジェクト。", "properties": { "state": { "type": "string", "example": "success", "enum": [ "success", "viewable", "pending", "none" ], "description": "レプリゼンテーションのステータス。\n\n* `success`はそのレプリゼンテーションが表示可能な状態であることを示します。\n* `viewable`は視聴可能な動画であることを示します。\n* `pending`はそのレプリゼンテーションがこれから生成されることを示します。ステータスを再確認するにはこのエンドポイントを再試行します。\n* `none`はリクエストされたときにレプリゼンテーションが再作成されることを示します。この生成をトリガーするには、`info`オブジェクトで定義されたURLをリクエストします。" } } } } } } } }, { "description": "アプリケーション内でファイルのプレースホルダを表示するために使用できるレプリゼンテーションのリスト。デフォルトでは、すべてのレプリゼンテーションが返されるため、`x-rep-hints`ヘッダーを使用して目的のレプリゼンテーションをさらにカスタマイズすることをお勧めします。" } ] }, "classification": { "allOf": [ { "type": "object", "description": "項目に適用される分類", "properties": { "name": { "type": "string", "example": "Top Secret", "description": "分類の名前" }, "definition": { "type": "string", "example": "Content that should not be shared outside the company.", "description": "この分類の意味の説明。" }, "color": { "type": "string", "example": "#FF0000", "description": "ユーザーインターフェースでの分類ラベルの表示に使用される色。色は、Boxウェブアプリで分類を作成した管理者または共同管理者によって定義されます。" } } }, { "description": "このファイルに適用された分類に関する詳細" }, { "nullable": true } ] }, "uploader_display_name": { "allOf": [ { "title": "アップローダーの表示名", "type": "string", "example": "Ellis Wiggins", "nullable": false, "description": "ファイルをアップロードしたユーザーの表示名。ほとんどの場合、これはアップロード時点でログインしているユーザーの名前です。\n\nこのファイルのアップロードに、ユーザーに対してメールアドレスの入力を要求するファイルリクエストフォームが使用された場合、このフィールドにはそのメールアドレスが設定されます。メールアドレスがファイルリクエストフォームで要求されなかった場合、このフィールドは、`File Request`という値を返すように設定されます。\n\nメールアドレスが指定されなかったその他すべての匿名のケースでは、このフィールドの値がデフォルトで`Someone`になります。" } ] }, "disposition_at": { "type": "string", "format": "date-time", "nullable": true, "description": "特定のファイルのリテンションの有効期限のタイムスタンプ", "example": "2012-12-12T10:53:43-08:00" }, "shared_link_permission_options": { "type": "array", "example": [ "can_preview" ], "nullable": true, "description": "このファイルを共有するときに招待できるユーザーの役割タイプのリスト。", "items": { "type": "string", "enum": [ "can_preview", "can_download", "can_edit" ] } } } } ] }, "File--Mini": { "title": "ファイル (Mini)", "type": "object", "x-box-resource-id": "file--mini", "x-box-variant": "mini", "description": "他のリソースの下にネストされたときに使用されるファイルのMini版の表示。", "nullable": true, "allOf": [ { "$ref": "#/components/schemas/File--Base" }, { "properties": { "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "ファイルの名前", "example": "Contract.pdf" }, "sha1": { "type": "string", "format": "digest", "nullable": false, "example": "85136C79CBF9FE36BB9D05D0639C70C265C18D37", "description": "ファイルのSHA1ハッシュ。Box上のファイルとローカルファイルの内容を比較する目的に使用できます。" }, "file_version": { "allOf": [ { "$ref": "#/components/schemas/FileVersion--Mini" }, { "description": "ファイルの現在のバージョンに関する情報。" } ] } } } ] }, "File--Base": { "title": "ファイル (Base)", "type": "object", "x-box-resource-id": "file--base", "x-box-sanitized": true, "x-box-tag": "files", "x-box-variants": [ "base", "mini", "standard", "full" ], "x-box-variant": "base", "nullable": true, "description": "最も基本的なファイルのBase版の表示。`fields`クエリパラメータを使用すると、最小限の数のフィールドが返されます。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "nullable": false, "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "12345" }, "etag": { "type": "string", "example": "1", "nullable": true, "description": "このファイルのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にファイルに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。" }, "type": { "type": "string", "description": "`file`", "example": "file", "enum": [ "file" ], "nullable": false } } }, "FileRequest": { "title": "ファイルリクエスト", "type": "object", "x-box-resource-id": "file_request", "x-box-tag": "file_requests", "description": "任意のファイルリクエストAPIエンドポイントからデフォルトで返されるファイルリクエストのStandard版の表示。", "required": [ "id", "type", "folder", "created_at", "updated_at" ], "properties": { "id": { "type": "string", "description": "このファイルリクエストの一意の識別子。", "readOnly": true, "example": "42037322" }, "type": { "type": "string", "description": "`file_request`", "example": "file_request", "enum": [ "file_request" ], "readOnly": true }, "title": { "type": "string", "description": "ファイルリクエストのタイトル。これは、Box UIで、ファイルをアップロードしているユーザーに表示されます。\n\nデフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストのタイトルになります。", "example": "Please upload documents" }, "description": { "type": "string", "nullable": true, "description": "このファイルリクエストの説明 (省略可)。これは、Box UIで、ファイルをアップロードしているユーザーに表示されます。\n\nデフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストの説明になります。", "example": "Following documents are requested for your process" }, "status": { "type": "string", "example": "active", "description": "ファイルリクエストのステータス。デフォルトでは`active`になります。\n\nこのステータスを`inactive`に設定すると、ファイルリクエストでは新しい送信を受け付けなくなり、ファイルリクエストのURLにアクセスした場合は`HTTP 404`ステータスコードが返されます。\n\nデフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストのステータスになります。", "enum": [ "active", "inactive" ] }, "is_email_required": { "type": "boolean", "example": true, "description": "ファイルリクエストの送信者に、メールアドレスの指定を義務付けるかどうか。\n\nこれをtrueに設定すると、Box UIのファイルリクエストフォームにメールフィールドが表示されます。\n\nデフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストの設定になります。" }, "is_description_required": { "type": "boolean", "example": true, "description": "ファイルリクエストの送信者に、送信するファイルの説明の指定を義務付けるかどうか。\n\nこれをtrueに設定すると、Box UIのファイルリクエストフォームに説明フィールドが表示されます。\n\nデフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストの設定になります。" }, "expires_at": { "type": "string", "format": "date-time", "description": "ファイルリクエストが新しい送信を受け付けなくなる日付。\n\nこの日付を過ぎると、`status`は自動的に`inactive`に設定されます。", "example": "2020-09-28T10:53:43-08:00" }, "folder": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このファイルリクエストが関連付けられているフォルダ。\n\nファイルリクエストフォームを使用して送信されたファイルは、このフォルダにアップロードされます。" } ], "nullable": false }, "url": { "type": "string", "description": "このファイルリクエストに対して生成されたURL。このURLをユーザーと共有すると、ユーザーが関連付けられたフォルダにファイルをアップロードできるようになります。", "example": "/f/19e57f40ace247278a8e3d336678c64a", "readOnly": true }, "etag": { "type": "string", "example": "1", "nullable": true, "description": "このファイルのHTTP `etag`。これは、ファイルリクエストの更新時に`If-Match`ヘッダーと組み合わせて使用できます。そのヘッダーを指定すると、`If-Match`ヘッダーで指定された`etag`とファイルリクエストの`etag`がまだ一致している場合のみ、ファイルリクエストが変更されます。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このファイルリクエストを作成したユーザー。" } ] }, "created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "ファイルリクエストが作成された日時。", "example": "2020-09-28T10:53:43-08:00" }, "updated_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このファイルリクエストを最後に変更したユーザー。" }, { "nullable": false } ] }, "updated_at": { "type": "string", "format": "date-time", "nullable": false, "description": "ファイルリクエストが最後に更新された日時。", "example": "2020-09-28T10:53:43-08:00" } } }, "FilesUnderRetention": { "title": "リテンションの対象となるファイル", "type": "object", "x-box-resource-id": "files_under_retention", "x-box-tag": "retention_policy_assignments", "description": "リテンションの対象となるファイルのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "ファイルのリスト", "items": { "$ref": "#/components/schemas/File--Mini" } } } } ] }, "FileVersion": { "title": "ファイルバージョン", "type": "object", "x-box-resource-id": "file_version", "x-box-variant": "standard", "description": "ファイルバージョンのStandard版の表示。", "allOf": [ { "$ref": "#/components/schemas/FileVersion--Mini" }, { "properties": { "name": { "type": "string", "description": "ファイルバージョンの名前", "example": "tigers.jpeg" }, "size": { "type": "integer", "format": "int64", "description": "ファイルバージョンのサイズ (バイト単位)", "example": 629644 }, "created_at": { "type": "string", "format": "date-time", "description": "ファイルバージョンオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "ファイルバージョンオブジェクトが最後に更新された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "ファイルバージョンを最後に更新したユーザー" } ] }, "trashed_at": { "type": "string", "description": "ファイルバージョンオブジェクトがごみ箱に移動された日時。", "format": "date-time", "nullable": true, "example": "2012-12-12T10:53:43-08:00" }, "trashed_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "ファイルバージョンをごみ箱に移動したユーザー" } ] }, "restored_at": { "type": "string", "description": "ファイルバージョンがごみ箱から復元された日時。", "format": "date-time", "nullable": true, "example": "2012-12-12T10:53:43-08:00" }, "restored_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "ごみ箱からファイルバージョンを復元したユーザー。" } ] }, "purged_at": { "type": "string", "description": "ファイルバージョンオブジェクトが完全に削除される日時。", "format": "date-time", "nullable": true, "example": "2012-12-12T10:53:43-08:00" }, "uploader_display_name": { "allOf": [ { "title": "アップローダーの表示名", "type": "string", "example": "Ellis Wiggins", "nullable": false, "description": "ファイルをアップロードしたユーザーの表示名。ほとんどの場合、これはアップロード時点でログインしているユーザーの名前です。\n\nこのファイルのアップロードに、ユーザーに対してメールアドレスの入力を要求するファイルリクエストフォームが使用された場合、このフィールドにはそのメールアドレスが設定されます。メールアドレスがファイルリクエストフォームで要求されなかった場合、このフィールドは、`File Request`という値を返すように設定されます。\n\nメールアドレスが指定されなかったその他すべての匿名のケースでは、このフィールドの値がデフォルトで`Someone`になります。" } ] } } } ] }, "FileVersion--Mini": { "title": "ファイルバージョン (Mini)", "type": "object", "x-box-resource-id": "file_version--mini", "x-box-variant": "mini", "description": "他のリソース内にネストされたときに使用されるファイルバージョンのMini版の表示。", "allOf": [ { "$ref": "#/components/schemas/FileVersion--Base" }, { "properties": { "sha1": { "type": "string", "description": "ファイルの現在のバージョンのSHA1ハッシュ。", "example": "134b65991ed521fcfe4724b7d814ab8ded5185dc" } } } ] }, "FileVersion--Base": { "title": "ファイルバージョン (Base)", "type": "object", "x-box-resource-id": "file_version--base", "x-box-sanitized": true, "x-box-variants": [ "base", "mini", "standard", "full" ], "x-box-variant": "base", "description": "最も基本的なファイルバージョンのBase版の表示。`fields`クエリパラメータを使用すると、最小限の数のフィールドが返されます。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "nullable": false, "description": "ファイルバージョンを表す一意の識別子。", "example": "12345" }, "type": { "type": "string", "description": "`file_version`", "example": "file_version", "enum": [ "file_version" ], "nullable": false } } }, "FileVersion--Full": { "title": "ファイルバージョン (Full)", "type": "object", "x-box-resource-id": "file_version--full", "x-box-variant": "full", "description": "任意のファイルバージョンAPIエンドポイントからデフォルトで返される可能性がある、ファイルバージョンのFull版の表示。", "allOf": [ { "$ref": "#/components/schemas/FileVersion" }, { "properties": { "version_number": { "type": "string", "example": "1", "description": "このファイルバージョンのバージョン番号" } } } ] }, "FileVersions": { "title": "ファイルバージョン", "type": "object", "x-box-resource-id": "file_versions", "x-box-tag": "file_versions", "description": "ファイルバージョンのリスト", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "ファイルバージョンのリスト", "items": { "$ref": "#/components/schemas/FileVersion--Full" } } } } ] }, "FileVersionLegalHold": { "title": "ファイルバージョンのリーガルホールド", "type": "object", "x-box-resource-id": "file_version_legal_hold", "x-box-tag": "file_version_legal_holds", "description": "File-Version-Legal-Holdは、ファイルバージョンのすべてのリテンションを表すエンティティです。", "properties": { "id": { "type": "string", "description": "このファイルバージョンリーガルホールドの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`file_version_legal_hold`", "example": "file_version_legal_hold", "enum": [ "file_version_legal_hold" ] }, "file_version": { "allOf": [ { "$ref": "#/components/schemas/FileVersion--Mini" }, { "description": "保持されているファイルバージョン" } ] }, "file": { "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "description": "保持されているファイルバージョンのファイル。常にそのファイルの最新バージョンが保持されるとは限りません。" } ] }, "legal_hold_policy_assignments": { "description": "このホールドに貢献する割り当てのリスト。", "type": "array", "items": { "$ref": "#/components/schemas/LegalHoldPolicyAssignment" } }, "deleted_at": { "type": "string", "format": "date-time", "description": "このFile-Version-Legal-Holdが削除された日時。", "example": "2012-12-12T10:53:43-08:00" } } }, "FileVersionLegalHolds": { "title": "ファイルバージョンのリーガルホールド", "type": "object", "x-box-resource-id": "file_version_legal_holds", "x-box-tag": "file_version_legal_holds", "description": "ファイルバージョンのリーガルホールドのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "ファイルバージョンのリーガルホールドのリスト", "items": { "$ref": "#/components/schemas/FileVersionLegalHold" } } } } ] }, "FileVersionRetention": { "title": "ファイルバージョンリテンション", "type": "object", "x-box-resource-id": "file_version_retention", "x-box-tag": "file_version_retentions", "description": "リテンションポリシーは、指定した期間にわたってコンテンツが完全に消去されるのを防止します。管理者はポリシーを特定のフォルダや会社全体に適用できます。ファイルバージョンリテンションとは、保持されているファイルバージョンのレコードです。この機能を使用するには、アプリケーション管理コンソールから、APIキーに対して \\[リテンションポリシーを管理する] スコープを有効にする必要があります。リテンションポリシーについて詳しくは、Boxのヘルプドキュメントをご覧ください。", "properties": { "id": { "type": "string", "description": "このファイルバージョンリテンションの一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`file_version_retention`", "example": "file_version_retention", "enum": [ "file_version_retention" ] }, "file_version": { "allOf": [ { "$ref": "#/components/schemas/FileVersion--Mini" }, { "description": "このファイルバージョンリテンションが適用されたファイルバージョン" } ] }, "file": { "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "description": "このファイルバージョンリテンションが適用されたファイル" } ] }, "applied_at": { "type": "string", "format": "date-time", "description": "このファイルバージョンリテンションオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "disposition_at": { "type": "string", "format": "date-time", "description": "このファイルバージョンリテンションのリテンションが終了する日時", "example": "2012-12-12T10:53:43-08:00" }, "winning_retention_policy": { "allOf": [ { "$ref": "#/components/schemas/RetentionPolicy--Mini" }, { "description": "このファイルバージョンリテンションに適用されている、優先度が最も高いリテンションポリシー。ファイルバージョンには複数のリテンションポリシーが適用されている場合があります。" } ] } } }, "FileVersionRetentions": { "title": "ファイルバージョンリテンション", "type": "object", "x-box-resource-id": "file_version_retentions", "x-box-tag": "file_version_retentions", "description": "ファイルバージョンリテンションのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "ファイルバージョンリテンションのリスト", "items": { "$ref": "#/components/schemas/FileVersionRetention" } } } } ] }, "Folder": { "title": "Folder", "type": "object", "x-box-resource-id": "folder", "x-box-variant": "standard", "description": "任意のフォルダAPIエンドポイントからデフォルトで返されるフォルダのStandard版の表示。", "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "properties": { "created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが作成された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このフォルダが最後に更新された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。", "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": { "type": "integer", "format": "int64", "description": "フォルダサイズ (バイト単位)。\n\nこの整数を解析する際には、値が非常に大きくなることがあるため注意が必要です。", "example": 629644, "nullable": false }, "path_collection": { "allOf": [ { "title": "パスのコレクション", "description": "項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "type": "array", "description": "この項目の親フォルダ", "nullable": false, "items": { "$ref": "#/components/schemas/Folder--Mini" } } } }, { "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": { "type": "string", "format": "date-time", "description": "このフォルダがごみ箱に移動された日時。", "example": "2012-12-12T10:53:43-08:00", "nullable": true }, "purged_at": { "type": "string", "format": "date-time", "description": "このフォルダがごみ箱から削除される予定日時。", "example": "2012-12-12T10:53:43-08:00", "nullable": true }, "content_created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが最初に作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "content_modified_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "owned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このフォルダを所有するユーザー。" }, { "nullable": false } ] }, "shared_link": { "allOf": [ { "title": "共有リンク", "description": "共有リンクを作成すると、Box上のファイルやフォルダに対する読み取り専用アクセスを直接実行できます。\n\nアクセスレベルがopenに設定されている共有リンクの場合は、URLを知っているすべてのユーザーが項目にアクセスでき、アクセスレベルがcompanyまたはcollaboratorsに設定されている共有リンクの場合は、適切に認証されたBoxユーザーのみが項目にアクセスできます。", "type": "object", "required": [ "url", "accessed", "effective_access", "effective_permission", "is_password_enabled", "download_count", "preview_count" ], "properties": { "url": { "type": "string", "format": "url", "description": "Box上の項目にアクセスするために使用できるURL。\n\nこのURLに移動すると、BoxのプレビューUIに項目が表示され、許可されている場合は、このUIからファイルをダウンロードできます。\n\nこのURLは、この共有リンクに対してカスタムの`vanity_url`が 設定されている場合でも動作します。", "example": "https://www.box.com/s/vspke7y05sb214wjokpk", "nullable": false }, "download_url": { "type": "string", "format": "url", "x-box-premium-feature": true, "description": "ファイルをダウンロードするために使用できるURL。このURLをブラウザで使用すると、ファイルをダウンロードできます。このURLには、ファイルを正しいファイルタイプで保存できるように、ファイル拡張子が含まれます。\n\nフォルダの場合、このプロパティは`null`になります。", "example": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg", "nullable": true }, "vanity_url": { "type": "string", "format": "url", "description": "Boxで項目をプレビューする目的にも使用できる「カスタムURL」。カスタムURLの作成と変更は、Boxウェブアプリケーションでのみ行えます。", "example": "https://acme.app.box.com/v/my_url/", "nullable": true }, "vanity_name": { "type": "string", "description": "`vanity_url`フィールドで使用される、共有リンクのカスタム名。", "example": "my_url", "nullable": true }, "access": { "type": "string", "description": "この共有リンクのアクセスレベル\n\n* `open` - このリンクを知っている全員にこの項目へのアクセスを許可します\n* `company` - 同じ会社のユーザーにのみこの項目へのアクセスを許可します\n* `collaborators` - この項目のコラボレータとなっているユーザーに対してのみこの項目へのアクセスを許可します\n\n共有リンクの作成時にこのフィールドを省略した場合は、Enterprise管理者によって指定されたデフォルトのアクセスレベルに設定されます。", "enum": [ "open", "company", "collaborators" ], "example": "open", "nullable": false }, "effective_access": { "type": "string", "description": "共有リンクの実際のアクセスレベル。許可されるアクセスレベルが会社の設定で制限されている場合は、`access`フィールドの値よりも低いアクセスレベルになることがあります。", "enum": [ "open", "company", "collaborators" ], "example": "company", "nullable": false }, "effective_permission": { "type": "string", "description": "この共有リンクの実際の権限。これらにより、共有リンクの権限と、管理者、所有者、任意の先祖項目 (フォルダなど) によって設定される項目の権限の組み合わせの制限が厳しくなります。", "enum": [ "can_edit", "can_download", "can_preview", "no_access" ], "example": "can_download", "nullable": false }, "unshared_at": { "type": "string", "format": "date-time", "description": "このリンクが共有解除される日時。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。", "example": "2018-04-13T13:53:23-07:00", "nullable": true }, "is_password_enabled": { "type": "boolean", "description": "共有リンクを通じて項目にアクセスする際にパスワードを要求するかどうかを定義します。", "example": true, "nullable": false }, "permissions": { "type": "object", "description": "このリンクを通じてユーザーが項目のプレビュー、編集、およびダウンロードを行うことを許可するかどうかを定義します。これらの権限は、共有リンクのみに適用され、その項目自体に適用される権限より優先されることはありません。", "required": [ "can_download", "can_preview", "can_edit" ], "properties": { "can_download": { "type": "boolean", "example": true, "nullable": false, "description": "共有リンクを通じて項目をダウンロードすることを許可するかどうかを定義します。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。\n\n実際のアクセスレベルが`collaborators`ではなく、`open`または`company`に設定されている場合は、この値を`true`に設定できます。" }, "can_preview": { "type": "boolean", "example": true, "nullable": false, "description": "共有リンクを通じて項目をプレビューすることを許可するかどうかを定義します。\n\nこの値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": false, "nullable": false, "description": "共有リンクからの項目の編集を許可するかどうかを定義します。\n\n`can_download`が`true`で、項目のタイプが`file`の場合のみ、この値も`true`に設定できます。" } } }, "download_count": { "type": "integer", "example": 3, "description": "この項目がダウンロードされた回数。", "nullable": false }, "preview_count": { "type": "integer", "example": 3, "description": "この項目がプレビューされた回数。", "nullable": false } } }, { "description": "このフォルダの共有リンク。このフォルダに対してまだ共有リンクが作成されていない場合は、`null`になります。" } ], "nullable": true }, "folder_upload_email": { "type": "object", "nullable": true, "properties": { "access": { "type": "string", "example": "open", "nullable": false, "enum": [ "open", "collaborators" ], "description": "このパラメータが設定されている場合、ユーザーは、このフォルダに対して自動的に作成されたメールアドレスに メールでファイルを送信できます。\n\nメールアドレスを作成するには、フォルダを作成するとき、または更新するときにこのプロパティを設定します。\n\n`collaborators`に設定すると、コラボレータの登録済み メールアドレスからのメールのみが受け入れられます。これには、ユーザーが登録しているすべてのメールエイリアスも含まれます。\n\n`open`に設定すると、どのメールアドレスからのメールでも受け入れられます。" }, "email": { "description": "このフォルダのアップロードメールアドレス (省略可)。", "type": "string", "format": "email", "example": "upload.Contracts.asd7asd@u.box.com", "nullable": false } } }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このフォルダが配置されているフォルダ (省略可)\n\nルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になることがあります。" } ], "nullable": true }, "item_status": { "type": "string", "description": "この項目が削除されたかどうかを定義します。\n\n* `active` - 項目がごみ箱に移動されていない場合。\n* `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。\n* `deleted` - 項目がすでに完全に削除されている場合。", "enum": [ "active", "trashed", "deleted" ], "nullable": false, "example": "active" }, "item_collection": { "allOf": [ { "$ref": "#/components/schemas/Items" }, { "description": "フォルダ内の項目のページ。\n\nこのフィールドをリクエストできるのは、フォルダの情報をクエリで照会するときのみで、フォルダの項目をクエリで照会するときにはリクエストできません。" }, { "nullable": false } ] } } } ] }, "Folder--Full": { "title": "フォルダ (Full)", "type": "object", "x-box-resource-id": "folder--full", "x-box-variant": "full", "description": "任意のフォルダAPIエンドポイントからデフォルトで返される可能性があるフォルダのFull版の表示。", "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": { "type": "boolean", "example": true, "nullable": false, "description": "このフォルダに他のコラボレータが存在するかどうかを指定します。" }, "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": { "type": "boolean", "description": "現在のユーザーがこの項目を削除できるかどうかを指定します。", "example": true, "nullable": false }, "can_download": { "type": "boolean", "description": "現在のユーザーがこの項目をダウンロードできるかどうかを指定します。", "example": true, "nullable": false }, "can_invite_collaborator": { "type": "boolean", "description": "現在のユーザーがこの項目でのコラボレーションに新しいユーザーを招待できるかどうかと、この項目ですでにコラボレーションしているユーザーのロールを更新できるかどうかを指定します。", "example": true, "nullable": false }, "can_rename": { "type": "boolean", "description": "ユーザーがこの項目の名前を変更できるかどうかを指定します。", "example": true, "nullable": false }, "can_set_share_access": { "type": "boolean", "description": "ユーザーがこの項目の既存の共有リンクのアクセスレベルを変更できるかどうかを指定します。", "example": true, "nullable": false }, "can_share": { "type": "boolean", "description": "ユーザーがこの項目の共有リンクを作成できるかどうかを指定します。", "example": true, "nullable": false } } }, { "properties": { "can_upload": { "type": "boolean", "description": "ユーザーがこのフォルダにアップロードできるかどうかを指定します。", "example": true, "nullable": false } } } ] }, { "description": "このフォルダに対して現在のユーザーが持っている権限について説明します。" }, { "nullable": false } ] }, "tags": { "allOf": [ { "type": "array", "example": [ "approved" ], "items": { "type": "string" }, "minItems": 1, "maxItems": 100, "description": "この項目のタグ。これらのタグはBoxウェブアプリおよびモバイルアプリで項目の横に表示されます。\n\nタグを追加または削除するには、項目の現在のタグを取得して変更してから、このフィールドを更新します。\n\nタグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに制限されます。" }, { "nullable": false } ] }, "can_non_owners_invite": { "allOf": [ { "type": "boolean", "example": true, "description": "フォルダの所有者ではないユーザーがそのフォルダに新しいコラボレータを招待できるかどうかを指定します。" }, { "nullable": false } ] }, "is_externally_owned": { "type": "boolean", "example": true, "nullable": false, "description": "このフォルダが認証済みの会社以外のユーザーによって所有されているかどうかを指定します。" }, "metadata": { "allOf": [ { "title": "項目メタデータインスタンス", "type": "object", "description": "`scope`および`templateKey`のキー/値ペア内にネストされている、メタデータインスタンスのリスト。\n\nファイルまたはフォルダのメタデータにアクセスするには、最初にメタデータエンドポイントを使用して、会社で使用できるメタデータテンプレートを特定します。\n\nその後、`fields`クエリパラメータを指定して`GET /files/:id`または`GET /folder/:id`エンドポイントを使用すると、IDを指定してメタデータを取得できます。\n\n特定の`scope`および`templateKey`のメタデータインスタンスをリクエストするには、`fields`パラメータに次の形式を使用してください。 `metadata..`\n\nたとえば、`?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" } } }, { "description": "このフォルダに追加されたメタデータインスタンスを含むオブジェクト。\n\n各メタデータインスタンスは、その`scope`と`templateKey`によって一意に識別されます。各フォルダに追加されるメタデータテンプレートのインスタンスは1つだけです。各メタデータインスタンスは、キーとして`templateKey`が指定されているオブジェクト内にネストされ、さらにそのオブジェクト自体もキーとして`scope`が指定されているオブジェクト内にネストされます。" } ] }, "is_collaboration_restricted_to_enterprise": { "allOf": [ { "type": "boolean", "example": true, "description": "このフォルダへの招待を社内のユーザーのみに限定するかどうかを指定します。既存のコラボレーションには影響しません。" }, { "nullable": false } ] }, "allowed_shared_link_access_levels": { "type": "array", "example": [ "open" ], "items": { "type": "string", "enum": [ "open", "company", "collaborators" ] }, "nullable": false, "description": "このフォルダで使用できるアクセスレベルのリスト。\n\nルートフォルダなどの一部のフォルダでは共有が許可されていないため、このリストは常に空になります。" }, "allowed_invitee_roles": { "type": "array", "example": [ "editor" ], "nullable": false, "description": "このフォルダを共有するときに招待できるユーザーの役割タイプのリスト。", "items": { "type": "string", "enum": [ "editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner" ] } }, "watermark_info": { "allOf": [ { "type": "object", "description": "この項目に適用された電子すかしに関する詳細", "properties": { "is_watermarked": { "type": "boolean", "description": "この項目に電子すかしが適用されているかどうかを指定します。", "example": true, "nullable": false } } }, { "description": "このフォルダに適用された電子すかしに関する詳細" }, { "nullable": false } ] }, "is_accessible_via_shared_link": { "type": "boolean", "description": "直接共有リンクまたは親フォルダへの共有リンクを使用してフォルダにアクセスできるかどうかを指定します。", "example": true, "enum": [ true, false ] }, "can_non_owners_view_collaborators": { "type": "boolean", "example": true, "description": "このフォルダの所有者ではないコラボレータがこのフォルダの他のコラボレータを表示できないように制限するかどうかを指定します。\n\nこの制限を有効にした場合は、所有者ではないユーザーが新しいコラボレータを招待することも制限されます。" }, "classification": { "allOf": [ { "type": "object", "description": "項目に適用される分類", "properties": { "name": { "type": "string", "example": "Top Secret", "description": "分類の名前" }, "definition": { "type": "string", "example": "Content that should not be shared outside the company.", "description": "この分類の意味の説明。" }, "color": { "type": "string", "example": "#FF0000", "description": "ユーザーインターフェースでの分類ラベルの表示に使用される色。色は、Boxウェブアプリで分類を作成した管理者または共同管理者によって定義されます。" } } }, { "description": "このフォルダに適用された分類に関する詳細。" }, { "nullable": true } ] } } } ] }, "Folder--Mini": { "title": "フォルダ (Mini)", "type": "object", "x-box-resource-id": "folder--mini", "x-box-variant": "mini", "description": "他のリソースの下にネストされたときに使用されるファイルバージョンのMini版の表示。", "allOf": [ { "$ref": "#/components/schemas/Folder--Base" }, { "properties": { "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "フォルダの名前。", "example": "Contracts", "nullable": false } } } ] }, "Folder--Base": { "title": "フォルダ (Base)", "type": "object", "x-box-resource-id": "folder--base", "x-box-sanitized": true, "x-box-tag": "folders", "x-box-variants": [ "base", "mini", "standard", "full" ], "x-box-variant": "base", "description": "最も基本的なフォルダのBase版の表示。`fields`クエリパラメータを使用すると、最小限の数のフィールドが返されます。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "nullable": false, "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folders/123`の場合、`folder_id`は`123`です。", "example": "12345" }, "etag": { "type": "string", "nullable": true, "example": "1", "description": "このフォルダのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にフォルダに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。" }, "type": { "type": "string", "description": "`folder`", "example": "folder", "enum": [ "folder" ], "nullable": false } } }, "FolderLock": { "title": "フォルダロック", "type": "object", "x-box-resource-id": "folder_lock", "x-box-tag": "folder_locks", "description": "フォルダロックでは、特定のフォルダが移動または削除されないように、フォルダ所有者によって設定されるアクセス制限を定義します。", "properties": { "folder": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "ロックが適用されるフォルダ。" } ] }, "id": { "type": "string", "description": "このフォルダロックの一意の識別子。", "example": "12345678" }, "type": { "type": "string", "description": "オブジェクトタイプ (常に`folder_lock`)。", "example": "folder_lock" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "ロックを作成したユーザーまたはグループ。" } ] }, "created_at": { "type": "string", "format": "date-time", "example": "2020-09-14T23:12:53Z", "description": "フォルダロックオブジェクトが作成された日時。" }, "locked_operations": { "type": "object", "description": "ロックされている操作。現在、`move`操作と`delete`操作を別々にロックすることはできません。両方とも`true`に設定する必要があります。", "required": [ "move", "delete" ], "properties": { "move": { "type": "boolean", "description": "フォルダの移動が制限されるかどうか。", "nullable": false, "example": true }, "delete": { "type": "boolean", "description": "フォルダの削除が制限されるかどうか。", "nullable": false, "example": true } } }, "lock_type": { "type": "string", "description": "ロックの種類 (常に`freeze`)。", "example": "freeze" } } }, "FolderLocks": { "title": "フォルダロック", "type": "object", "x-box-resource-id": "folder_locks", "x-box-tag": "folder_locks", "description": "フォルダロックのリスト", "properties": { "entries": { "type": "array", "description": "フォルダロックのリスト", "items": { "$ref": "#/components/schemas/FolderLock" } }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": "1000", "type": "string" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, "GenericSource": { "title": "汎用的なソース", "type": "object", "x-box-resource-id": "generic_source", "description": "汎用的なイベントソースタイプ。", "additionalProperties": { "allOf": [ {}, { "description": "汎用的なイベントソースオブジェクトの定義。パラメータのセットは、オブジェクトタイプによって異なります。たとえば、Box Shieldのイベントソースでは、以下のパラメータのセットが使用されます。\n\n```yaml\n{\n\"barrier_id\": 123456,\n\"barrier_status\": \"ENABLED\",\n\"barrier_segments\": [\n {\n \"name\": \"8\",\n \"member_count\": 1\n },\n {\n \"name\": \"9\",\n \"member_count\": 1\n }\n ]\n} \n\n```" } ] } }, "IntegrationMapping": { "title": "統合マッピング", "type": "object", "x-box-resource-id": "integration_mapping", "x-box-tag": "integration_mappings", "x-box-variant": "standard", "description": "統合マッピングオブジェクトのStandard版の表示。", "allOf": [ { "$ref": "#/components/schemas/IntegrationMapping--Base" }, { "properties": { "type": { "type": "string", "example": "integration_mapping", "enum": [ "integration_mapping" ], "description": "マッピングタイプ", "nullable": false }, "partner_item": { "oneOf": [ { "$ref": "#/components/schemas/IntegrationMappingPartnerItemSlack" } ], "nullable": false, "description": "Slack用にマッピングされた項目オブジェクト" }, "box_item": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" } ], "description": "パートナーアプリのドメインのオブジェクト (`partner_item_id`で参照) のマッピング先であるBoxフォルダ", "nullable": false }, "is_manually_created": { "type": "boolean", "example": true, "description": "マッピングが (自動作成されたのではなく) 手動で設定されているかどうかを示します", "nullable": false }, "options": { "type": "object", "nullable": false, "example": {}, "description": "Slack用の統合マッピングオプション", "anyOf": [ { "$ref": "#/components/schemas/IntegrationMappingSlackOptions" } ] }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/UserIntegrationMappings" } ], "description": "統合マッピングを作成したユーザーを表すオブジェクト", "nullable": false }, "modified_by": { "allOf": [ { "$ref": "#/components/schemas/UserIntegrationMappings" } ], "description": "統合マッピングを最後に変更したユーザー", "nullable": false }, "created_at": { "type": "string", "format": "date-time", "description": "統合マッピングオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00", "nullable": false }, "modified_at": { "type": "string", "format": "date-time", "description": "統合マッピングオブジェクトが最後に変更された日時", "example": "2012-12-12T10:53:43-08:00", "nullable": false } } } ], "required": [ "type", "partner_item", "box_item" ] }, "IntegrationMapping--Base": { "title": "統合マッピング (Base)", "type": "object", "x-box-resource-id": "integration_mapping--base", "x-box-tag": "integration_mappings", "x-box-variant": "base", "x-box-variants": [ "base", "standard", "mini" ], "description": "統合マッピングオブジェクトのBase版の表示。", "properties": { "id": { "type": "string", "nullable": false, "example": "12345", "description": "フォルダマッピングの一意の識別子 (`integration_type`とともに複合キーの一部)" }, "integration_type": { "type": "string", "nullable": false, "description": "マッピングが関連付けられているBoxパートナーアプリを示します。現在サポートされているのはSlackのみです (`id`とともに複合キーの一部)。", "example": "slack", "enum": [ "slack" ] } } }, "IntegrationMapping--Mini": { "title": "統合マッピング (Mini)", "type": "object", "x-box-resource-id": "integration_mapping--mini", "x-box-tag": "integration_mappings", "x-box-variant": "mini", "description": "統合マッピングオブジェクトのMini版の表示。", "allOf": [ { "$ref": "#/components/schemas/IntegrationMapping--Base" }, { "properties": { "partner_item_id": { "type": "string", "example": "C12351346", "description": "マッピングされたパートナー項目のID", "nullable": false }, "partner_item_type": { "type": "string", "example": "channel", "enum": [ "channel" ], "description": "マッピングされたパートナー項目のドメイン固有のタイプ", "nullable": false }, "box_item_id": { "type": "string", "example": "123124351", "description": "`partner_item_id`で参照されるオブジェクトにマッピングされたBox項目のID", "nullable": false }, "box_item_type": { "type": "string", "example": "folder", "enum": [ "folder" ], "description": "`box_item_id`で参照されるBoxオブジェクトのタイプ", "nullable": false } } } ] }, "IntegrationMappings": { "title": "統合マッピング", "type": "object", "x-box-resource-id": "integration_mappings", "x-box-tag": "integration_mappings", "description": "統合マッピングオブジェクトのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "統合マッピングのリスト", "items": { "$ref": "#/components/schemas/IntegrationMapping" } } } } ] }, "Group": { "title": "Group", "type": "object", "x-box-resource-id": "group", "x-box-variant": "standard", "description": "任意のグループAPIエンドポイントからデフォルトで返されるグループのStandard版の表示。", "allOf": [ { "$ref": "#/components/schemas/Group--Mini" }, { "properties": { "created_at": { "type": "string", "format": "date-time", "description": "グループオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "グループオブジェクトが最後に変更された日時", "example": "2012-12-12T10:53:43-08:00" } } } ] }, "Groups": { "title": "Groups", "type": "object", "x-box-resource-id": "groups", "x-box-tag": "groups", "description": "グループのリスト。", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "グループのリスト", "items": { "$ref": "#/components/schemas/Group--Full" } } } } ] }, "Group--Base": { "title": "グループ (Base)", "type": "object", "x-box-resource-id": "group--base", "x-box-sanitized": true, "x-box-tag": "groups", "x-box-variants": [ "base", "mini", "standard", "full" ], "x-box-variant": "base", "description": "グループのBase版の表示。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このオブジェクトの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`group`", "example": "group", "enum": [ "group" ] } } }, "Group--Full": { "title": "グループ (Full)", "type": "object", "x-box-resource-id": "group--full", "x-box-variant": "full", "description": "グループは複数のユーザーを含み、グループを使用するとコラボレーションなどの一部の操作をユーザーの代わりに実行できます。", "allOf": [ { "$ref": "#/components/schemas/Group" }, { "properties": { "provenance": { "type": "string", "description": "このグループの元になっている外部ソース (\"Active Directory\"、\"Google Groups\"、\"Facebook Groups\"など) を追跡します。また、これを設定すると、Box管理者がBoxウェブアプリケーションからグループ名やメンバーを直接編集できなくなります。", "maxLength": 255, "example": "Active Directory" }, "external_sync_identifier": { "type": "string", "description": "このBoxグループを外部グループにリンクするために外部のグループ同期ツールで使用できる任意の識別子。このフィールドの値には、Active DirectoryオブジェクトIDやGoogleグループIDなどを使用できます。Boxまたは外部システム内でグループ名が更新されたときの問題を回避するために、このフィールドを使用することをお勧めします。", "example": "AD:123456" }, "description": { "type": "string", "description": "グループについての人間が判読できる説明。", "maxLength": 255, "example": "Support Group - as imported from Active Directory" }, "invitability_level": { "type": "string", "example": "admins_only", "description": "項目でのコラボレーションにグループを招待できるユーザーを指定します。\n\n`admins_only`に設定すると、会社の管理者、共同管理者、およびグループ管理者がグループを招待できるようになります。\n\n`admins_and_members`に設定すると、上記すべての管理者に加えて、グループのメンバーもグループを招待できるようになります。\n\n`all_managed_users`に設定すると、社内のすべての管理対象ユーザーがグループを招待できるようになります。", "enum": [ "admins_only", "admins_and_members", "all_managed_users" ] }, "member_viewability_level": { "type": "string", "example": "admins_only", "description": "グループのメンバーを表示できるユーザーを指定します (グループのメンバーを取得)。\n\n* `admins_only` - 企業の管理者、共同管理者、グループのグループ管理者\n* `admins_and_members` - すべての管理者とグループメンバー\n* `all_managed_users` - 企業のすべての管理対象ユーザー", "enum": [ "admins_only", "admins_and_members", "all_managed_users" ] }, "permissions": { "allOf": [ { "type": "object", "description": "グループに対して認証済みユーザーが持っている権限。", "properties": { "can_invite_as_collaborator": { "type": "boolean", "description": "ユーザーが項目でのコラボレーションにグループを招待できるかどうかを指定します。", "example": true } } }, { "description": "このグループに対して現在のユーザーが持っている権限について説明します。" } ] } } } ] }, "Group--Mini": { "title": "グループ (Mini)", "type": "object", "x-box-resource-id": "group--mini", "x-box-variant": "mini", "description": "グループのIDや名前を含むグループのMini版の表示。", "allOf": [ { "$ref": "#/components/schemas/Group--Base" }, { "properties": { "name": { "type": "string", "description": "グループの名前", "example": "Support" }, "group_type": { "type": "string", "description": "グループのタイプ。", "example": "managed_group", "enum": [ "managed_group", "all_users_group" ] } } } ] }, "GroupMembership": { "title": "グループメンバーシップ", "type": "object", "x-box-resource-id": "group_membership", "x-box-tag": "memberships", "description": "メンバーシップは、ユーザーがグループに属していることを示すために使用されます。", "properties": { "id": { "type": "string", "description": "このグループメンバーシップの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`group_membership`", "example": "group_membership", "enum": [ "group_membership" ] }, "user": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "メンバーシップが適用されるユーザー" } ] }, "group": { "allOf": [ { "$ref": "#/components/schemas/Group--Mini" }, { "description": "メンバーシップが適用されるグループ" } ] }, "role": { "type": "string", "example": "member", "description": "グループ内のユーザーのロール。", "enum": [ "member", "admin" ] }, "created_at": { "type": "string", "format": "date-time", "description": "このメンバーシップが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このメンバーシップが最後に変更された日時。", "example": "2012-12-12T10:53:43-08:00" } } }, "GroupMemberships": { "title": "グループメンバーシップ", "type": "object", "x-box-resource-id": "group_memberships", "x-box-tag": "memberships", "description": "グループメンバーシップのリスト。", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "グループメンバーシップのリスト", "items": { "$ref": "#/components/schemas/GroupMembership" } } } } ] }, "Invite": { "title": "Invite", "type": "object", "x-box-resource-id": "invite", "x-box-tag": "invites", "description": "会社へのユーザーの招待。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "この招待の一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`invite`", "example": "invite", "enum": [ "invite" ] }, "invited_to": { "title": "Enterprise", "type": "object", "description": "Boxに登録されている会社のレプリゼンテーション", "properties": { "id": { "type": "string", "description": "この会社の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "enum": [ "enterprise" ] }, "name": { "description": "会社の名前", "example": "Acme Inc.", "type": "string" } } }, "actionable_by": { "$ref": "#/components/schemas/User--Mini" }, "invited_by": { "$ref": "#/components/schemas/User--Mini" }, "status": { "description": "招待のステータス", "type": "string", "example": "pending" }, "created_at": { "type": "string", "format": "date-time", "description": "招待が作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "招待が変更された日時。", "example": "2012-12-12T10:53:43-08:00" } } }, "Items": { "title": "Items", "type": "object", "x-box-resource-id": "items", "x-box-tag": "folders", "description": "Mini版の表示に含まれるファイル、フォルダ、ウェブリンクのリスト。", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "description": "このコレクション内の項目。", "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/File--Full" }, { "$ref": "#/components/schemas/Folder--Mini" }, { "$ref": "#/components/schemas/WebLink" } ] } } } } ] }, "LegalHoldPolicy": { "title": "リーガルホールドポリシー", "type": "object", "x-box-resource-id": "legal_hold_policy", "x-box-variant": "standard", "description": "リーガルホールドポリシー情報には、名前、説明、フィルタ日付など、ポリシーの基本的な特性が記載されています。", "allOf": [ { "$ref": "#/components/schemas/LegalHoldPolicy--Mini" }, { "properties": { "policy_name": { "type": "string", "example": "Policy 4", "description": "リーガルホールドポリシーの名前。", "maxLength": 254 }, "description": { "type": "string", "description": "リーガルホールドポリシーの説明。これは省略可能なプロパティで、最大500文字まで入力できます。", "maxLength": 500, "example": "Postman created policy" }, "status": { "type": "string", "example": "active", "enum": [ "active", "applying", "releasing", "released" ], "description": "* 「active」 - ポリシーは遷移中の状態ではありません\n* 「applying」 - ポリシーの適用中です\n* 「releasing」 - 解除処理を行っています\n* 「released」 - ポリシーがアクティブでなくなりました" }, "assignment_counts": { "type": "object", "description": "このリーガルホールド内の項目タイプごとの割り当て数", "properties": { "user": { "type": "integer", "format": "int64", "description": "このポリシーが割り当てられているユーザーの数", "example": 1 }, "folder": { "type": "integer", "format": "int64", "description": "このポリシーを適用するフォルダの数", "example": 2 }, "file": { "type": "integer", "format": "int64", "description": "このポリシーが適用されるファイルの数", "example": 3 }, "file_version": { "type": "integer", "format": "int64", "description": "このポリシーが適用されるファイルバージョンの数", "example": 4 } } }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "リーガルホールドポリシーオブジェクトを作成したユーザー" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "リーガルホールドポリシーオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "リーガルホールドポリシーオブジェクトが変更された日時。割り当てが追加または削除されたときには更新されません。", "example": "2012-12-12T10:53:43-08:00" }, "deleted_at": { "type": "string", "format": "date-time", "description": "ポリシー解除リクエストが送信された日時 (ポリシーが完全に削除されるまでに時間がかかる場合があるため、この日時はポリシーが完全に削除された日時と一致しない場合があります)。\n\n`null`の場合、ポリシーは削除されていません。", "example": "2012-12-12T10:53:43-08:00" }, "filter_started_at": { "type": "string", "format": "date-time", "description": "カストディアン割り当てのみに適用されるユーザー指定の日付フィルタ (省略可)", "example": "2012-12-12T10:53:43-08:00" }, "filter_ended_at": { "type": "string", "format": "date-time", "description": "カストディアン割り当てのみに適用されるユーザー指定の日付フィルタ (省略可)", "example": "2012-12-12T10:53:43-08:00" }, "release_notes": { "type": "string", "example": "Example", "description": "ポリシーが作成された理由に関するメモ (省略可)。", "maxLength": 500 } } } ] }, "LegalHoldPolicies": { "title": "リーガルホールドポリシー", "type": "object", "x-box-resource-id": "legal_hold_policies", "x-box-tag": "legal_hold_policies", "description": "リーガルホールドポリシーのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "リーガルホールドポリシーのリスト", "items": { "$ref": "#/components/schemas/LegalHoldPolicy" } } } } ] }, "LegalHoldPolicy--Mini": { "title": "リーガルホールドポリシー (Mini)", "type": "object", "x-box-resource-id": "legal_hold_policy--mini", "x-box-tag": "legal_hold_policies", "x-box-variants": [ "mini", "standard" ], "x-box-variant": "mini", "description": "Mini版のリーガルホールドポリシー", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このリーガルホールドポリシーの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`legal_hold_policy`", "example": "legal_hold_policy", "enum": [ "legal_hold_policy" ] } } }, "LegalHoldPolicyAssignment": { "title": "リーガルホールドポリシー割り当て", "type": "object", "x-box-resource-id": "legal_hold_policy_assignment", "x-box-tag": "legal_hold_policy_assignments", "description": "リーガルホールド割り当ては、ユーザー、フォルダ、ファイル、またはファイルバージョンにリーガルホールドポリシーを割り当てる目的に使用されます。\n\nリーガルホールド割り当てを作成すると、その割り当ての「apply-to」エンティティに属するファイルバージョンにホールドが適用されます。", "allOf": [ { "$ref": "#/components/schemas/LegalHoldPolicyAssignment--Base" }, { "properties": { "legal_hold_policy": { "allOf": [ { "$ref": "#/components/schemas/LegalHoldPolicy--Mini" }, { "description": "そのリーガルホールドポリシー割り当てを含むポリシー" } ] }, "assigned_to": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/File" }, { "$ref": "#/components/schemas/Folder" }, { "$ref": "#/components/schemas/WebLink" } ] }, { "description": "リーガルホールドポリシーを割り当てる項目。タイプとIDを含みます。" } ] }, "assigned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "リーガルホールドポリシー割り当てを作成したユーザー" } ] }, "assigned_at": { "type": "string", "format": "date-time", "description": "リーガルホールドポリシー割り当てオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "deleted_at": { "type": "string", "format": "date-time", "description": "割り当て解除リクエストが送信された日時 (割り当てが完全に削除されるまでに時間がかかる場合があるため、この日時は割り当てが完全に削除された日時と一致しない場合があります)。nullの場合、割り当ては削除されていません。", "example": "2012-12-12T10:53:43-08:00" } } } ] }, "LegalHoldPolicyAssignment--Base": { "title": "リーガルホールドポリシー割り当て (Base)", "type": "object", "x-box-resource-id": "legal_hold_policy_assignment--base", "x-box-sanitized": true, "x-box-tag": "legal_hold_policy_assignments", "x-box-variants": [ "base", "standard" ], "x-box-variant": "base", "description": "リーガルホールド割り当ては、ユーザー、フォルダ、ファイル、またはファイルバージョンにリーガルホールドポリシーを割り当てる目的に使用されます。\n\nリーガルホールド割り当てを作成すると、その割り当ての「apply-to」エンティティに属するファイルバージョンにホールドが適用されます。", "properties": { "id": { "type": "string", "description": "このリーガルホールド割り当ての一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`legal_hold_policy_assignment`", "example": "legal_hold_policy_assignment", "enum": [ "legal_hold_policy_assignment" ] } } }, "LegalHoldPolicyAssignments": { "title": "リーガルホールドポリシー割り当て", "type": "object", "x-box-resource-id": "legal_hold_policy_assignments", "x-box-tag": "legal_hold_policy_assignments", "description": "リーガルホールドポリシー割り当てのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "リーガルホールドポリシー割り当てのリスト", "items": { "$ref": "#/components/schemas/LegalHoldPolicyAssignment" } } } } ] }, "Metadata": { "title": "メタデータインスタンス", "type": "object", "x-box-resource-id": "metadata", "x-box-tag": "file_metadata", "x-box-variant": "standard", "description": "ファイルまたはフォルダに適用された、メタデータテンプレートのインスタンス。", "allOf": [ { "$ref": "#/components/schemas/Metadata--Base" } ] }, "Metadata--Full": { "title": "メタデータインスタンス (Full)", "type": "object", "x-box-resource-id": "metadata--full", "x-box-variant": "full", "description": "ファイルまたはフォルダに適用された、メタデータテンプレートのインスタンス。", "allOf": [ { "$ref": "#/components/schemas/Metadata" }, { "properties": { "$canEdit": { "type": "boolean", "example": true, "description": "このメタデータインスタンスをユーザーが編集できるかどうか。" }, "$id": { "type": "string", "format": "uuid", "example": "01234500-12f1-1234-aa12-b1d234cb567e", "maxLength": 36, "description": "メタデータインスタンスを識別するためのUUID。" }, "$type": { "type": "string", "example": "properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0", "description": "このインスタンスの「タイプ」に対応する一意の識別子。これは内部システムプロパティであるため、クライアントアプリケーションでは使用しないでください。" }, "$typeVersion": { "type": "integer", "example": 2, "description": "オブジェクトテンプレートの既知の最新バージョン。これは内部システムプロパティであるため、クライアントアプリケーションでは使用しないでください。" } } }, { "additionalProperties": { "allOf": [ {}, { "example": "Aaron Levie" }, { "description": "メタデータテンプレートに存在する各フィールドの値。`global.properties`テンプレートの場合、汎用的なキー/値ペアをテンプレートに保存できるため、0個以上のフィールドのリストにすることができます。" } ], "x-box-example-key": "name" } } ] }, "Metadata--Base": { "title": "メタデータインスタンス (Base)", "type": "object", "x-box-resource-id": "metadata--base", "x-box-sanitized": true, "x-box-tag": "file_metadata", "x-box-variants": [ "base", "standard", "full" ], "x-box-variant": "base", "description": "メタデータインスタンスのBase版の表示。", "properties": { "$parent": { "type": "string", "example": "folder_59449484661,", "description": "このメタデータインスタンスが追加されている項目の識別子。これは、親の`type`と`id`を`{type}_{id}`という形式で組み合わせたものです。" }, "$template": { "type": "string", "example": "marketingCollateral", "description": "テンプレートの名前" }, "$scope": { "type": "string", "example": "enterprise_27335", "description": "このテンプレートが適用されているスコープのID。これは、この会社で使用するために定義されたテンプレートの場合は`enterprise_{enterprise_id}`、Boxを使用するすべての会社が利用できる一般的なテンプレートの場合は`global`になります。" }, "$version": { "type": "integer", "example": 1, "description": "メタデータインスタンスのバージョン。このバージョンは0から始まり、ユーザー定義プロパティが変更されるたびに増加します。" } } }, "Metadatas": { "title": "メタデータインスタンス", "type": "object", "x-box-resource-id": "metadatas", "x-box-tag": "file_metadata", "description": "ファイルまたはフォルダに適用されているメタデータインスタンスのリスト。", "properties": { "entries": { "type": "array", "description": "このファイルまたはフォルダに適用されるメタデータインスタンスのリスト。", "items": { "$ref": "#/components/schemas/Metadata" } }, "limit": { "description": "結果の現在のページに使用された制限。", "example": 100, "type": "integer" } } }, "MetadataCascadePolicy": { "title": "メタデータカスケードポリシー", "type": "object", "x-box-resource-id": "metadata_cascade_policy", "x-box-tag": "metadata_cascade_policies", "description": "メタデータカスケードポリシーにより、メタデータテンプレートインスタンスが自動的にターゲットフォルダ内のすべてのファイルとフォルダに適用されます。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "example": "6fd4ff89-8fc1-42cf-8b29-1890dedd26d7", "description": "メタデータカスケードポリシーオブジェクトのID" }, "type": { "type": "string", "description": "`metadata_cascade_policy`", "example": "metadata_cascade_policy", "enum": [ "metadata_cascade_policy" ] }, "owner_enterprise": { "type": "object", "description": "このポリシーを所有する会社。", "properties": { "type": { "type": "string", "example": "enterprise", "description": "`enterprise`", "enum": [ "enterprise" ] }, "id": { "type": "string", "example": "690678", "description": "ポリシーを所有する会社のID。" } } }, "parent": { "type": "object", "description": "ポリシーが適用されるフォルダを表します。", "properties": { "type": { "type": "string", "example": "folder", "description": "`folder`", "enum": [ "folder" ] }, "id": { "type": "string", "example": "1234567", "description": "ポリシーが適用されるフォルダのID。" } } }, "scope": { "type": "string", "description": "メタデータカスケードポリシーのスコープは、`global`または`enterprise_*`のいずれかになります。`global`スコープは、任意のBox Enterpriseで利用できるポリシーに使用されます。`enterprise_*`スコープは、特定のEnterprise内で作成されたポリシーを表します (`*`はそのEnterpriseのID)。", "example": "enterprise_123456" }, "templateKey": { "type": "string", "example": "productInfo", "description": "フォルダの子にカスケードされるテンプレートのキー。\n\n多くの場合、テンプレートキーはその表示名から自動的に派生します。たとえば、`Contract Template`の場合は`contractTemplate`となります。場合によっては、テンプレートの作成者が独自のテンプレートキーを指定することもあります。\n\nテンプレートのキーを調べるには、[会社のテンプレートのリストを取得する][list]か、[ファイル][file]または[フォルダ][folder]上のすべてのインスタンスを取得してください。\n\n[list]: e://get-metadata-templates-enterprise\n\n[file]: e://get-files-id-metadata\n\n[folder]: e://get-folders-id-metadata" } } }, "MetadataCascadePolicies": { "title": "メタデータカスケードポリシー", "type": "object", "x-box-resource-id": "metadata_cascade_policies", "x-box-tag": "metadata_cascade_policies", "description": "メタデータカスケードポリシーのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "メタデータカスケードポリシーのリスト", "items": { "$ref": "#/components/schemas/MetadataCascadePolicy" } } } } ] }, "MetadataQueryIndex": { "title": "Metadata query index", "type": "object", "x-box-resource-id": "metadata_query_index", "x-box-tag": "search", "description": "メタデータクエリインデックス", "required": [ "type", "status" ], "properties": { "id": { "type": "string", "example": "-9876", "description": "メタデータクエリインデックスのID。" }, "type": { "type": "string", "description": "値は常に`metadata_query_index`", "example": "metadata_query_index", "nullable": false }, "status": { "type": "string", "description": "メタデータクエリインデックスのステータス", "example": "active", "enum": [ "building", "active", "disabled" ], "nullable": false }, "fields": { "type": "array", "description": "インデックスを構成するテンプレートフィールドのリスト。", "items": { "type": "object", "description": "インデックスを構成するフィールド。", "allOf": [ { "properties": { "key": { "type": "string", "example": "vendor name", "description": "メタデータテンプレートのフィールドキー。" }, "sort_direction": { "type": "string", "example": "asc", "description": "フィールドの並べ替え方向。", "enum": [ "asc", "desc" ] } } } ] } } } }, "MetadataQueryResults": { "title": "メタデータクエリの検索結果", "type": "object", "x-box-tag": "search", "x-box-resource-id": "metadata_query_results", "description": "メタデータクエリと一致したファイルおよびフォルダのページ。", "properties": { "entries": { "description": "検索語と一致するファイルやフォルダのMini版の表示。\n\nデフォルトでは、このエンドポイントによって、項目に関する最も基本的な情報のみが返されます。各項目のその他のフィールド (メタデータのいずれかを含む) を取得するには、クエリで`fields`属性を使用します。", "type": "array", "x-box-resource-variant": 1, "items": { "oneOf": [ { "$ref": "#/components/schemas/File" }, { "$ref": "#/components/schemas/Folder" } ] } }, "limit": { "description": "この検索で使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。", "default": 100, "example": 100, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "0!-M7487OpVfBTNBV-XsQjU50gQFlbFFu5nArMWD7Ck61GH_Qo40M1S2xN5zWZPBzEjaQS1SOjJiQoo5BsXEl1bCVLRZ2pTqo4SKp9tyqzWQK2L51KR_nC1EgF5I_TJSFw7uO2Bx4HweGETOjh5_2oPSWw5iMkM-OvGApeR0lGFO48FDKoyzJyLgz5aogxoKd8VE09CesOOnTnmZvrW0puylDc-hFjY5YLmWFBKox3SOWiSDwKFkmZGNHyjEzza1nSwbZg6CYsAdGsDwGJhuCeTNsFzP5Mo5qx9wMloS0lSPuf2CcBInbIJzl2CKlXF3FvqhANttpm2nzdBTQRSoJyJnjVBpf4Q_HjV2eb4KIZBBlLy067UCVdv2AAWQFd5E2i6s1YiGRTtgMEZntOSUYD4IYLMWWm5Ra7ke_SP32SL3GSjbBQYIyCVQ..", "type": "string" } } }, "MetadataTemplate": { "title": "メタデータテンプレート", "type": "object", "x-box-resource-id": "metadata_template", "x-box-tag": "metadata_templates", "description": "ファイルやフォルダに適用可能なメタデータのテンプレート", "required": [ "type", "id" ], "properties": { "id": { "type": "string", "example": "58063d82-4128-7b43-bba9-92f706befcdf", "description": "メタデータテンプレートのID。" }, "type": { "type": "string", "description": "`metadata_template`", "example": "metadata_template", "enum": [ "metadata_template" ], "nullable": false }, "scope": { "type": "string", "description": "メタデータテンプレートのスコープは、`global`または`enterprise_*`のいずれかになります。`global`スコープは、Boxを使用するすべての会社が利用できるテンプレートに使用されます。`enterprise_*`スコープは、特定の会社内で作成されたテンプレートを表します (`*`はその会社のID)。", "example": "enterprise_123456" }, "templateKey": { "type": "string", "example": "productInfo", "description": "テンプレートの一意の識別子。この識別子は、メタデータテンプレートが適用される会社の`scope`全体で一意ですが、会社を越えて一意であるとは限りません。", "maxLength": 64, "pattern": "^[a-zA-Z_][-a-zA-Z0-9_]*$" }, "displayName": { "type": "string", "description": "テンプレートの表示名。Boxウェブアプリとモバイルアプリに表示されます。", "maxLength": 4096, "example": "Product Info" }, "hidden": { "type": "boolean", "example": true, "description": "このテンプレートをBoxウェブアプリのUIに表示するか、APIを介した使用のみを目的とするかを定義します。" }, "fields": { "type": "array", "description": "テンプレートに含まれるテンプレートフィールドの並べ替えられたリスト。各フィールドは、通常のテキストフィールド、日付フィールド、数値フィールド、単一または複数選択リストのいずれかになります。", "items": { "type": "object", "description": "メタデータテンプレート内のフィールド。フィールドは、基本のテキスト、日付、または数値フィールドか、オプションのリストのいずれかになります。", "allOf": [ { "title": "メタデータフィールド (読み取り)", "description": "メタデータテンプレート内のフィールド。フィールドは、基本のテキスト、日付、または数値フィールドか、オプションのリストのいずれかになります。", "required": [ "type", "key", "displayName" ], "type": "object", "properties": { "type": { "type": "string", "example": "string", "description": "フィールドのタイプ。基本のフィールドは、テキストを表す`string`フィールド、数値を表す`float`フィールド、およびユーザーに日時選択機能を表示するための`date`フィールドです。\n\nさらに、メタデータテンプレートは、基本の項目リストを表す`enum`フィールドのほか、ユーザーが複数の値を選択できる同様の項目リストを表す` multiSelect`フィールドをサポートしています。\n\n**注**: `integer`値は非推奨です。レスポンスにはまだ存在していても、POSTリクエストでは使用できません。", "enum": [ "string", "float", "date", "enum", "multiSelect", "integer" ] }, "key": { "type": "string", "example": "category", "description": "フィールドの一意の識別子。この識別子は、そのフィールドが属するテンプレート内で一意である必要があります。", "maxLength": 256 }, "displayName": { "type": "string", "example": "Category", "description": "ウェブアプリおよびモバイルアプリでユーザーに表示されるフィールドの表示名。", "maxLength": 4096 }, "description": { "type": "string", "example": "The category", "description": "フィールドの説明。ユーザーには表示されません。", "maxLength": 4096 }, "hidden": { "type": "boolean", "example": true, "description": "このフィールドをUI上でユーザーに対して非表示にし、代わりにAPIを介してのみ設定できるようにするかどうか。" }, "options": { "description": "このフィールドのオプションのリスト。`enum`および`multiSelect`フィールドタイプと組み合わせて使用します。", "type": "array", "items": { "title": "メタデータオプション (書き込み)", "type": "object", "description": "メタデータテンプレートフィールドのオプション。\n\nオプションは、`enum`タイプおよび`multiSelect`タイプのフィールドのみに指定する必要があります。 オプションは、ユーザーがUIまたはAPIを介してそのフィールドに選択できる値を表します。", "required": [ "key" ], "properties": { "key": { "description": "オプションのテキスト値。オプションの表示名と、テンプレートの更新時に使用される内部キーの両方を表します。", "example": "Category 1", "type": "string" } } } } } }, { "properties": { "id": { "type": "string", "example": "822227e0-47a5-921b-88a8-494760b2e6d2", "description": "メタデータテンプレートフィールドの一意のID。" }, "options": { "description": "このフィールドのオプションのリスト。`enum`および`multiSelect`フィールドタイプと組み合わせて使用します。", "type": "array", "items": { "type": "object", "description": "メタデータテンプレートフィールドのオプション。\n\nオプションは、`enum`タイプおよび`multiSelect`タイプのフィールドにのみ存在します。オプションは、ユーザーがUIまたはAPIを介してそのフィールドに選択できる値を表します。", "allOf": [ { "title": "メタデータオプション (書き込み)", "type": "object", "description": "メタデータテンプレートフィールドのオプション。\n\nオプションは、`enum`タイプおよび`multiSelect`タイプのフィールドのみに指定する必要があります。 オプションは、ユーザーがUIまたはAPIを介してそのフィールドに選択できる値を表します。", "required": [ "key" ], "properties": { "key": { "description": "オプションのテキスト値。オプションの表示名と、テンプレートの更新時に使用される内部キーの両方を表します。", "example": "Category 1", "type": "string" } } }, { "properties": { "id": { "type": "string", "example": "45dc2849-a4a7-40a9-a751-4a699a589190", "description": "オプションの内部的な一意の識別子。" } } } ] } } } } ] } }, "copyInstanceOnItemCopy": { "type": "boolean", "description": "ファイルまたはフォルダのコピー時にメタデータを含めるかどうか。", "example": true } } }, "MetadataTemplates": { "title": "メタデータテンプレート", "type": "object", "x-box-resource-id": "metadata_templates", "x-box-tag": "metadata_templates", "description": "メタデータテンプレートのリスト", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "メタデータテンプレートのリスト", "items": { "$ref": "#/components/schemas/MetadataTemplate" } } } } ] }, "RealtimeServer": { "title": "リアルタイムサーバー", "type": "object", "x-box-resource-id": "realtime_server", "description": "Long polling User Eventに使用できるリアルタイムサーバー", "properties": { "type": { "description": "`realtime_server`", "type": "string", "example": "realtime_server" }, "url": { "type": "string", "example": "http://2.realtime.services.box.net/subscribe?channel=cc807c9c4869ffb1c81a&stream_type=all", "description": "サーバーのURL。" }, "ttl": { "description": "このサーバーが利用可能な時間 (分)", "type": "integer", "example": 10 }, "max_retries": { "description": "このサーバーが[サーバーの新しいリスト](#options-events)を取得して新しいLong pollingを開始するまでに実行可能な再試行回数の上限。", "type": "integer", "example": 10 }, "retry_timeout": { "description": "Long polling接続を再試行するまでのレスポンスがない時間の最大秒数。\n\nこれは、Long pollingが機能しているようではあるものの、パッケージが届かない場合に、ネットワーク関連の問題を解決するのに役立ちます。", "type": "integer", "example": 610 } } }, "RealtimeServers": { "title": "リアルタイムサーバー", "type": "object", "x-box-resource-id": "realtime_servers", "description": "Long pollingに使用できるリアルタイムサーバーのリスト。", "x-box-tag": "events", "properties": { "chunk_size": { "description": "このレスポンス内の項目の数。", "example": 1, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "リアルタイムサーバーのリスト", "items": { "$ref": "#/components/schemas/RealtimeServer" } } } }, "RecentItem": { "title": "最近使用した項目", "type": "object", "x-box-resource-id": "recent_item", "description": "ユーザーが最近アクセスした項目。", "x-box-tag": "recent_items", "properties": { "type": { "type": "string", "description": "`recent_item`", "example": "recent_item" }, "item": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/File--Full" }, { "$ref": "#/components/schemas/Folder--Full" }, { "$ref": "#/components/schemas/WebLink" } ] }, { "description": "最近アクセスされた項目。" } ] }, "interaction_type": { "type": "string", "example": "item_preview", "description": "ユーザーがこの項目に対して最近実行したアクセスのタイプ。", "enum": [ "item_preview", "item_upload", "item_comment", "item_open", "item_modify" ] }, "interacted_at": { "type": "string", "format": "date-time", "description": "直近のやり取りの日時。", "example": "2018-04-13T13:53:23-07:00" }, "interaction_shared_link": { "type": "string", "example": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg", "description": "項目へのアクセスが共有リンクを通じて行われた場合は、その共有リンクがここに入り、そうでない場合はnullになります。" } } }, "RecentItems": { "title": "最近使用した項目", "type": "object", "x-box-resource-id": "recent_items", "description": "最近使用した項目のリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "最近使用した項目のリスト", "items": { "$ref": "#/components/schemas/RecentItem" } } } } ] }, "RetentionPolicies": { "title": "リテンションポリシー", "type": "object", "x-box-resource-id": "retention_policies", "x-box-tag": "retention_policies", "description": "リテンションポリシーのリスト。", "allOf": [ { "properties": { "entries": { "description": "各エントリがリテンションポリシーオブジェクトを表しているリスト。", "type": "array", "items": { "$ref": "#/components/schemas/RetentionPolicy" } } } }, { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } } ] }, "RetentionPolicy": { "title": "リテンションポリシー", "type": "object", "x-box-resource-id": "retention_policy", "x-box-tag": "retention_policies", "x-box-variant": "standard", "description": "リテンションポリシーは、指定した期間にわたってコンテンツが完全に削除されるのを防止します。管理者はリテンションポリシーを作成して特定のフォルダ、メタデータテンプレート、または企業全体に割り当てることができます。この機能を使用するには、アプリケーション管理コンソールから、APIキーに対して \\[リテンションポリシーを管理する] スコープを有効にする必要があります。", "allOf": [ { "$ref": "#/components/schemas/RetentionPolicy--Mini" }, { "properties": { "description": { "type": "string", "example": "Policy to retain all reports for at least one month", "description": "リテンションポリシーのテキストによる追加の説明。" }, "policy_type": { "type": "string", "example": "finite", "description": "リテンションポリシーのタイプ。リテンションポリシーのタイプは、`finite` (コンテンツを保持する期間が事前にわかっている場合)、または`indefinite` (コンテンツを保持する期間が不明な場合) のいずれかになります。", "enum": [ "finite", "indefinite" ] }, "retention_type": { "type": "string", "example": "non_modifiable", "description": "以下のリテンションの種類を指定します。\n\n* `modifiable`: リテンションポリシーを変更できます。たとえば、フォルダの追加と削除、ポリシー期間の短縮と延長、または割り当ての削除を行うことができます。リテンションポリシーが規制目的に関連していない場合はこの種類を使用してください。\n\n* `non-modifiable`: フォルダの追加、期間の延長、ポリシーの撤回、廃棄アクションまたは通知設定の変更という限られた方法でしかリテンションポリシーを変更できません。割り当ての削除やポリシー期間の短縮など、その他の操作は実行できません。規制に関するリテンションポリシーを確実に遵守する場合はこの種類を使用してください。", "enum": [ "modifiable", "non_modifiable" ] }, "status": { "type": "string", "example": "active", "description": "リテンションポリシーのステータス。ポリシーのステータスは、管理者が明示的に撤回しない限り、`active`になります (撤回されたポリシーのステータスは`retired`になります)。一度廃止したポリシーを再度アクティブにすることはできません。", "enum": [ "active", "retired" ] }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "リテンションポリシーを作成したユーザーをMini版のユーザーオブジェクトで表示。" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "リテンションポリシーオブジェクトが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "リテンションポリシーオブジェクトが最後に変更された日時。", "example": "2012-12-12T10:53:43-08:00" }, "can_owner_extend_retention": { "type": "boolean", "description": "元のリテンション期間が終了に近づいたときに、ポリシーが適用されている項目の所有者がリテンションを延長できるかどうかを決定します。", "example": false }, "are_owners_notified": { "type": "boolean", "description": "リテンション期間が終了に近づいたときに、ポリシーが適用されている項目の所有者と共同所有者に通知するかどうかを決定します。", "example": false }, "custom_notification_recipients": { "type": "array", "description": "リテンションポリシーの期間が終了に近づいたときに通知されるユーザーのリスト。", "items": { "$ref": "#/components/schemas/User--Mini" } }, "assignment_counts": { "type": "object", "description": "項目タイプごとに、リテンションポリシーによる割り当て数をカウントします。", "properties": { "enterprise": { "description": "このポリシーでの企業の割り当て数。最大値は1です。", "format": "int64", "type": "integer", "example": 1 }, "folder": { "description": "このポリシーでのフォルダの割り当て数。", "format": "int64", "type": "integer", "example": 1 }, "metadata_template": { "description": "このポリシーでのメタデータテンプレートの割り当て数。", "format": "int64", "type": "integer", "example": 1 } } } } } ] }, "RetentionPolicy--Mini": { "title": "リテンションポリシー (Mini)", "type": "object", "x-box-resource-id": "retention_policy--mini", "x-box-variant": "mini", "description": "他のリソース内にネストされたときに使用されるリテンションポリシーのMini版の表示。", "allOf": [ { "$ref": "#/components/schemas/RetentionPolicy--Base" }, { "properties": { "policy_name": { "type": "string", "description": "リテンションポリシーの名前。", "example": "Some Policy Name" }, "retention_length": { "type": "string", "format": "int32", "example": "365", "minimum": 1, "description": "リテンションポリシーの期間。この値はリテンションポリシーがコンテンツに割り当てられた後、有効である日数を示します。ポリシーの`policy_type`が`indefinite`である場合は、`retention_length`も`indefinite`になります。" }, "disposition_action": { "type": "string", "example": "permanently_delete", "description": "リテンションポリシーの廃棄アクション。このアクションを`permanently_delete`に設定すると、ポリシーによって保持されているコンテンツが完全に削除されます。`remove_retention`に設定すると、コンテンツへのリテンションポリシーの適用が解除され、リテンションポリシーの有効期限が切れた後は、ユーザーがコンテンツを削除できるようになります。", "enum": [ "permanently_delete", "remove_retention" ] } } } ] }, "RetentionPolicy--Base": { "title": "リテンションポリシー (Base)", "type": "object", "x-box-resource-id": "retention_policy--base", "x-box-tag": "retention_policies", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "base", "description": "リテンションポリシーのBase版の表示。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "nullable": false, "description": "リテンションポリシーを表す一意の識別子。", "example": "12345" }, "type": { "type": "string", "description": "`retention_policy`", "example": "retention_policy", "enum": [ "retention_policy" ], "nullable": false } } }, "RetentionPolicyAssignment--Base": { "title": "リテンションポリシー割り当て (Base)", "type": "object", "x-box-resource-id": "retention_policy_assignment--base", "x-box-tag": "retention_policy_assignments", "x-box-variants": [ "base", "standard" ], "x-box-variant": "base", "description": "リテンションポリシー割り当てのBase版の表示。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "nullable": false, "description": "ファイルバージョンを表す一意の識別子。", "example": "12345" }, "type": { "type": "string", "description": "`retention_policy_assignment`", "example": "retention_policy_assignment", "enum": [ "retention_policy_assignment" ], "nullable": false } } }, "RetentionPolicyAssignment": { "title": "リテンションポリシー割り当て", "type": "object", "x-box-resource-id": "retention_policy_assignment", "x-box-tag": "retention_policy_assignments", "description": "リテンションの割り当ては、リテンションポリシーで保持されるファイルを指定するルールを表します。割り当てにより、フォルダまたはメタデータに基づいてファイルを保持したり、企業内のすべてのファイルを保持したりできます。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "リテンションポリシー割り当ての一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`retention_policy_assignment`", "example": "retention_policy_assignment", "enum": [ "retention_policy_assignment" ] }, "retention_policy": { "allOf": [ { "$ref": "#/components/schemas/RetentionPolicy--Mini" }, { "description": "コンテンツに割り当てられたリテンションポリシーオブジェクトのMini版の表示。" } ] }, "assigned_to": { "type": "object", "description": "リテンションの対象となるコンテンツの`type`と`id`。`type`は、`folder`、`enterprise`、`metadata_template`のいずれかになります。", "properties": { "id": { "type": "string", "nullable": true, "example": "a983f69f-e85f-4ph4-9f46-4afdf9c1af65", "description": "ポリシーが割り当てられるフォルダ、企業、またはメタデータテンプレートのID。タイプが企業に設定されている場合は、nullに設定するか省略します。" }, "type": { "type": "string", "example": "metadata_template", "description": "ポリシーが割り当てられるリソースのタイプ。", "enum": [ "folder", "enterprise", "metadata_template" ] } } }, "filter_fields": { "type": "array", "nullable": true, "description": "フィールドオブジェクトの配列。値が返されるのは、`assigned_to`のタイプが`metadata_template`の場合のみです。それ以外の場合、配列は空です。", "items": { "type": "object", "nullable": true, "properties": { "field": { "type": "string", "nullable": true, "description": "メタデータ属性キーID。", "example": "a0f4ee4e-1dc1-4h90-a8a9-aef55fc681d4" }, "value": { "type": "string", "nullable": true, "description": "メタデータ属性フィールドID。値については、列挙型とmultiselect型のみがサポートされています。", "example": "0c27b756-0p87-4fe0-a43a-59fb661ccc4e" } } } }, "assigned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "リテンションポリシー割り当てを作成したユーザーをMini版のユーザーオブジェクトで表示。" } ] }, "assigned_at": { "type": "string", "format": "date-time", "description": "リテンションポリシー割り当てオブジェクトが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "start_date_field": { "type": "string", "description": "リテンションポリシー割り当ての開始日。`assigned_to`のタイプが`metadata_template`の場合、このフィールドには、日付フィールドのメタデータ属性キーIDを指定できます。", "example": "upload_date" } } }, "RetentionPolicyAssignments": { "title": "リテンションポリシー割り当て", "type": "object", "x-box-resource-id": "retention_policy_assignments", "x-box-tag": "retention_policy_assignments", "description": "リテンションポリシー割り当てのリスト。", "allOf": [ { "properties": { "entries": { "type": "array", "description": "リテンションポリシー割り当てのリスト", "items": { "$ref": "#/components/schemas/RetentionPolicyAssignment" } } } }, { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } } ] }, "ShieldInformationBarrier": { "title": "Shield情報バリア", "type": "object", "x-box-resource-id": "shield_information_barrier", "x-box-tag": "shield_information_barriers", "x-box-variants": [ "base", "standard" ], "x-box-variant": "standard", "description": "Shield情報バリアオブジェクトのStandard版の表示", "properties": { "id": { "type": "string", "example": "11446498", "description": "Shield情報バリアの一意の識別子" }, "type": { "type": "string", "description": "Shield情報バリアのタイプ", "example": "shield_information_barrier", "enum": [ "shield_information_barrier" ] }, "enterprise": { "allOf": [ { "$ref": "#/components/schemas/Enterprise--Base" } ], "description": "このバリアが配置されている企業の`type`と`id`。" }, "status": { "type": "string", "enum": [ "draft", "pending", "disabled", "enabled", "invalid" ], "description": "Shield情報バリアのステータス", "example": "draft" }, "created_at": { "type": "string", "format": "date-time", "example": "2020-06-26T18:44:45.869Z", "description": "このShield情報バリアオブジェクトが作成された日時を示すISO日時文字列。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" } ], "description": "このShield情報バリアを作成したユーザー。" }, "updated_at": { "type": "string", "format": "date-time", "example": "2020-07-26T18:44:45.869Z", "description": "このShield情報バリアが更新された日時を示すISO日時文字列。" }, "updated_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" } ], "description": "このShield情報バリアを更新したユーザー。" }, "enabled_at": { "type": "string", "format": "date-time", "example": "2020-07-26T18:44:45.869Z", "description": "このShield情報バリアが有効化された日時を示すISO日時文字列。" }, "enabled_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアを有効化したユーザー。" } ] } } }, "ShieldInformationBarrier--Base": { "title": "Shield情報バリア (Base)", "type": "object", "x-box-resource-id": "shield_information_barrier--base", "x-box-tag": "shield_information_barriers", "x-box-variants": [ "base", "standard" ], "x-box-variant": "base", "description": "Shield情報バリアオブジェクトのBase版の表示", "properties": { "id": { "type": "string", "example": "11446498", "description": "Shield情報バリアの一意の識別子" }, "type": { "type": "string", "description": "Shield情報バリアのタイプ", "example": "shield_information_barrier", "enum": [ "shield_information_barrier" ] } } }, "ShieldInformationBarriers": { "title": "Shield情報バリアのリスト", "type": "object", "x-box-resource-id": "shield_information_barriers", "x-box-tag": "shield_information_barriers", "description": "Shield情報バリアオブジェクトのリスト", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "Shield情報バリアオブジェクトのリスト", "items": { "$ref": "#/components/schemas/ShieldInformationBarrier" } } } } ] }, "ShieldInformationBarrierReport": { "title": "Shield情報バリアレポート", "type": "object", "x-box-resource-id": "shield_information_barrier_report", "x-box-tag": "shield_information_barrier_reports", "x-box-variants": [ "base", "standard" ], "x-box-variant": "standard", "description": "Shield情報バリアレポートオブジェクトのStandard版の表示", "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierReport--Base" }, { "properties": { "shield_information_barrier": { "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierReference" } ] }, "status": { "type": "string", "enum": [ "pending", "error", "done", "cancelled" ], "description": "Shield情報バリアレポートのステータス", "example": "pending" }, "details": { "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierReportDetails" } ] }, "created_at": { "type": "string", "format": "date-time", "example": "2020-06-26T18:44:45.869Z", "description": "このShield情報バリアレポートオブジェクトが作成された日時を示すISO日時文字列。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアレポートを作成したユーザー。" } ] }, "updated_at": { "type": "string", "format": "date-time", "example": "2020-07-26T18:44:45.869Z", "description": "このShield情報バリアレポートが更新された日時を示すISO日時文字列。" } } } ] }, "ShieldInformationBarrierReport--Base": { "title": "Shield情報バリアレポート (Base)", "type": "object", "x-box-resource-id": "shield_information_barrier_report--base", "x-box-tag": "shield_information_barrier_reports", "x-box-variants": [ "base", "standard" ], "x-box-variant": "base", "description": "Shield情報バリアレポートオブジェクトのBase版の表示", "properties": { "id": { "type": "string", "example": "11446498", "description": "Shield情報バリアレポートの一意の識別子" }, "type": { "type": "string", "description": "Shield情報バリアレポートのタイプ", "example": "shield_information_barrier_report", "enum": [ "shield_information_barrier_report" ] } } }, "ShieldInformationBarrierReports": { "title": "Shield情報バリアレポートのリスト", "type": "object", "x-box-resource-id": "shield_information_barrier_reports", "x-box-tag": "shield_information_barrier_reports", "description": "Shieldバリアレポートのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "Shield情報バリアレポートのリスト。", "items": { "$ref": "#/components/schemas/ShieldInformationBarrierReport" } } } } ] }, "ShieldInformationBarrierSegment": { "title": "Shield情報バリアのセグメント", "type": "object", "x-box-resource-id": "shield_information_barrier_segment", "x-box-tag": "shield_information_barrier_segments", "description": "Shield情報バリアのセグメントオブジェクト", "properties": { "id": { "type": "string", "example": "11446498", "description": "Shield情報バリアのセグメントの一意の識別子" }, "type": { "type": "string", "description": "Shield情報バリアのセグメントのタイプ", "example": "shield_information_barrier_segment", "enum": [ "shield_information_barrier_segment" ] }, "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" }, "name": { "type": "string", "example": "Investment Banking", "description": "Shield情報バリアのセグメントの名前" }, "description": { "type": "string", "example": "'Corporate division that engages in advisory_based financial\n transactions on behalf of individuals, corporations, and governments.'", "description": "Shield情報バリアのセグメントの説明" }, "created_at": { "type": "string", "format": "date-time", "example": "2020-06-26T18:44:45.869Z", "description": "このShield情報バリアオブジェクトが作成された日時を示すISO日時文字列。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアのセグメントを作成したユーザー。" } ] }, "updated_at": { "type": "string", "format": "date-time", "example": "2020-07-26T18:44:45.869Z", "description": "このShield情報バリアのセグメントが更新された日時を示すISO日時文字列。" }, "updated_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアのセグメントを更新したユーザー。" } ] } } }, "ShieldInformationBarrierSegments": { "title": "Shield情報バリアのセグメントのリスト", "type": "object", "x-box-resource-id": "shield_information_barrier_segments", "x-box-tag": "shield_information_barrier_segments", "description": "Shield情報バリアのセグメントオブジェクトのリスト", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "Shield情報バリアのセグメントのリスト", "items": { "$ref": "#/components/schemas/ShieldInformationBarrierSegment" } } } } ] }, "ShieldInformationBarrierSegmentMember": { "title": "Shield情報バリアのセグメントメンバー", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_member", "x-box-tag": "shield_information_barrier_segment_members", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "standard", "description": "Shield情報バリアのセグメントメンバーオブジェクトのStandard版の表示", "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentMember--Mini" }, { "properties": { "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" }, "shield_information_barrier_segment": { "type": "object", "properties": { "id": { "type": "string", "example": "432554", "description": "リクエストしているShield情報バリアのセグメントのID参照。" }, "type": { "type": "string", "example": "shield_information_barrier_segment", "description": "Shield情報バリアのセグメントのタイプ", "enum": [ "shield_information_barrier_segment" ] } }, "description": "リクエストされたShield情報バリアのセグメントの`type`と`id`。" }, "user": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "リクエストされたShield情報バリアのセグメントメンバーの`type`と`id`。" } ] }, "created_at": { "type": "string", "format": "date-time", "example": "2020-06-26T18:44:45.869Z", "description": "このShield情報バリアオブジェクトが作成された日時を示すISO日時文字列。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアのセグメントメンバーを作成したユーザー。" } ] }, "updated_at": { "type": "string", "format": "date-time", "example": "2020-07-26T18:44:45.869Z", "description": "このShield情報バリアのセグメントメンバーが更新された日時を示すISO日時文字列。" }, "updated_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアのセグメントメンバーを更新したユーザー。" } ] } } } ] }, "ShieldInformationBarrierSegmentMember--Base": { "title": "Shield情報バリアのセグメントメンバー (Base)", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_member--base", "x-box-tag": "shield_information_barrier_segment_members", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "base", "description": "Shield情報バリアのセグメントメンバーオブジェクトのBase版の表示", "properties": { "id": { "type": "string", "example": "11446498", "description": "Shield情報バリアのセグメントメンバーの一意の識別子" }, "type": { "type": "string", "description": "Shield情報バリアのセグメントメンバーのタイプ", "example": "shield_information_barrier_segment_member", "enum": [ "shield_information_barrier_segment_member" ] } } }, "ShieldInformationBarrierSegmentMember--Mini": { "title": "Shield情報バリアのセグメントメンバー (Mini)", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_member--mini", "x-box-tag": "shield_information_barrier_segment_members", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "mini", "description": "Shield情報バリアのセグメントメンバーオブジェクトのMini版の表示", "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentMember--Base" }, { "properties": { "user": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "リクエストされたShield情報バリアのセグメントメンバーの`type`と`id`。" } ] } } } ] }, "ShieldInformationBarrierSegmentMembers": { "title": "Shield情報バリアのセグメントメンバーのリスト", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_members", "x-box-tag": "shield_information_barrier_segment_members", "description": "Shield情報バリアのメンバーオブジェクトのリスト", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "Shield情報バリアのセグメントメンバーのリスト", "items": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentMember" } } } } ] }, "ShieldInformationBarrierSegmentRestriction": { "title": "Shield情報バリアのセグメント制限", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_restriction", "x-box-tag": "shield_information_barrier_segment_restrictions", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "standard", "description": "Shield情報バリアオブジェクトのセグメント制限のStandard版の表示", "required": [ "shield_information_barrier_segment", "restricted_segment" ], "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentRestriction--Mini" }, { "properties": { "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" }, "created_at": { "type": "string", "format": "date-time", "example": "2020-06-26T18:44:45.869Z", "description": "このShield情報バリアのセグメント制限オブジェクトが作成された日時を示すISO日時文字列。" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアのセグメント制限を作成したユーザー。" } ] }, "updated_at": { "type": "string", "format": "date-time", "example": "2020-07-26T18:44:45.869Z", "description": "このShield情報バリアのセグメント制限が更新された日時を示すISO日時文字列。" }, "updated_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このShield情報バリアのセグメント制限を更新したユーザー。" } ] } } } ] }, "ShieldInformationBarrierSegmentRestriction--Base": { "title": "Shield情報バリアのセグメント制限 (Base)", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_restriction--base", "x-box-tag": "shield_information_barrier_segment_restrictions", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "base", "description": "Shield情報バリアのセグメント制限オブジェクトのBase版の表示", "required": [ "shield_information_barrier_segment", "restricted_segment" ], "properties": { "type": { "type": "string", "description": "Shield情報バリアのセグメント制限", "example": "shield_information_barrier_segment_restriction", "enum": [ "shield_information_barrier_segment_restriction" ] }, "id": { "type": "string", "example": "11446498", "description": "Shield情報バリアのセグメント制限の一意の識別子。" } } }, "ShieldInformationBarrierSegmentRestriction--Mini": { "title": "Shield情報バリアのセグメント制限 (Mini)", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_restriction--mini", "x-box-tag": "shield_information_barrier_segment_restrictions", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "mini", "description": "Shield情報バリアのセグメント制限オブジェクトのMini版の表示", "required": [ "shield_information_barrier_segment", "restricted_segment" ], "allOf": [ { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentRestriction--Base" }, { "properties": { "shield_information_barrier_segment": { "type": "object", "properties": { "id": { "type": "string", "example": "1910967", "description": "リクエストしているShield情報バリアのセグメントのID参照。" }, "type": { "type": "string", "description": "Shield情報バリアのセグメントのタイプ", "example": "shield_information_barrier_segment", "enum": [ "shield_information_barrier_segment" ] } }, "description": "リクエストされたShield情報バリアのセグメントの`type`と`id`。" }, "restricted_segment": { "type": "object", "properties": { "id": { "type": "string", "example": "1910967", "description": "制限されたShield情報バリアのセグメントのID参照。" }, "type": { "type": "string", "description": "Shield情報セグメントのタイプ", "example": "shield_information_barrier_segment", "enum": [ "shield_information_barrier_segment" ] } }, "description": "制限されたShield情報バリアのセグメントの`type`と`id`。" } } } ] }, "ShieldInformationBarrierSegmentRestrictions": { "title": "Shield情報バリアのセグメント制限のリスト", "type": "object", "x-box-resource-id": "shield_information_barrier_segment_restrictions", "x-box-tag": "shield_information_barrier_segment_restrictions", "description": "Shield情報バリアのセグメント制限オブジェクトのリスト", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "Shield情報バリアのセグメント制限オブジェクトのリスト", "items": { "$ref": "#/components/schemas/ShieldInformationBarrierSegmentRestriction" } } } } ] }, "SearchResults": { "title": "検索結果", "type": "object", "x-box-resource-id": "search_results", "x-box-tag": "search", "description": "検索クエリに一致するファイル、フォルダ、およびウェブリンクのリスト。", "required": [ "type" ], "allOf": [ { "type": "object", "properties": { "total_count": { "description": "検索結果の最後のエントリのオフセットに1を加算した値。 コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "この検索で使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータを使用した場合と同じになります。", "example": 2000, "type": "integer", "format": "int64" } } }, { "properties": { "type": { "description": "共有リンクを含まない検索結果項目としてレスポンスを指定します", "type": "string", "example": "search_results_items", "enum": [ "search_results_items" ], "nullable": false }, "entries": { "description": "指定されたクエリの検索結果。", "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/File--Full" }, { "$ref": "#/components/schemas/Folder--Full" }, { "$ref": "#/components/schemas/WebLink" } ] } } } } ] }, "SearchResultsWithSharedLinks": { "title": "検索結果 (複数の共有リンクを含む)", "type": "object", "x-box-resource-id": "search_results_with_shared_links", "x-box-tag": "search", "description": "検索クエリと一致したファイル、フォルダ、ウェブリンクのリスト (項目がユーザーと共有されたときに使用されたすべての共有リンクに関する追加情報を含む)。\n\nこのレスポンス形式は、`include_recent_shared_links`クエリパラメータが`true`に設定されている場合にのみ返されます。", "required": [ "type" ], "allOf": [ { "type": "object", "properties": { "total_count": { "description": "検索結果の最後のエントリのオフセットに1を加算した値。 コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "この検索で使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータを使用した場合と同じになります。", "example": 2000, "type": "integer", "format": "int64" } } }, { "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" } } } } ] }, "SearchResultWithSharedLink": { "title": "検索結果 (共有リンクを含む)", "type": "object", "x-box-resource-id": "search_result_with_shared_link", "x-box-tag": "search", "description": "検索クエリと一致したファイル、フォルダ、ウェブリンクの単一リスト (項目がユーザーと共有されたときに使用された共有リンクに関する追加情報を含む)。\n\nこのレスポンス形式は、`include_recent_shared_links`クエリパラメータが`true`に設定されている場合にのみ返されます。", "properties": { "accessible_via_shared_link": { "description": "ユーザーがこの項目にアクセスする際に使用する共有リンク (省略可)。この値は、ユーザーが最近共有リンクを介してファイルにアクセスした項目のみに返されます。その他すべての項目には、`null`が返されます。", "example": "https://www.box.com/s/vspke7y05sb214wjokpk", "type": "string", "format": "url" }, "item": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/File--Full" }, { "$ref": "#/components/schemas/Folder--Full" }, { "$ref": "#/components/schemas/WebLink" } ] }, { "description": "検索クエリと一致したファイル、フォルダ、またはウェブリンク。" } ] }, "type": { "description": "結果の種類。値は常に`search_result`になります。", "example": "search_result", "type": "string" } } }, "SessionTerminationMessage": { "title": "セッション終了メッセージ", "type": "object", "x-box-resource-id": "session_termination", "x-box-tag": "session_termination", "description": "終了ジョブステータスについて通知するメッセージ", "properties": { "message": { "type": "string", "description": "終了ジョブステータスの一意の識別子", "example": "Request is successful, please check the admin\nevents for the status of the job" } } }, "SkillCardsMetadata": { "title": "Skillsメタデータインスタンス", "type": "object", "x-box-resource-id": "skill_cards_metadata", "x-box-tag": "skills", "description": "Boxスキルの使用に割り当てられたメタデータ。", "properties": { "$canEdit": { "type": "boolean", "example": true, "description": "このメタデータをユーザーが編集できるかどうか" }, "$id": { "type": "string", "format": "uuid", "example": "01234500-12f1-1234-aa12-b1d234cb567e", "maxLength": 36, "description": "メタデータオブジェクトを識別するためのUUID" }, "$parent": { "type": "string", "example": "folder_59449484661,", "description": "親フォルダのID" }, "$scope": { "type": "string", "example": "enterprise_27335", "description": "このテンプレートが適用されているスコープのID" }, "$template": { "type": "string", "example": "properties", "description": "テンプレートの名前" }, "$type": { "type": "string", "example": "properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0", "description": "このインスタンスの「タイプ」に対応する一意の識別子。これは内部システムプロパティであるため、クライアントアプリケーションでは使用しないでください。" }, "$typeVersion": { "type": "integer", "example": 2, "description": "オブジェクトテンプレートの既知の最新バージョン。これは内部システムプロパティであるため、クライアントアプリケーションでは使用しないでください。" }, "$version": { "type": "integer", "example": 1, "description": "メタデータオブジェクトのバージョン。0から始まり、ユーザー定義プロパティが変更されるたびに増加します。" }, "cards": { "type": "array", "description": "このファイルに適用されているBox Skillカードのリスト。", "items": { "oneOf": [ { "$ref": "#/components/schemas/KeywordSkillCard" }, { "$ref": "#/components/schemas/TimelineSkillCard" }, { "$ref": "#/components/schemas/TranscriptSkillCard" }, { "$ref": "#/components/schemas/StatusSkillCard" } ] } } } }, "StoragePolicy": { "title": "ストレージポリシー", "type": "object", "x-box-resource-id": "storage_policy", "x-box-variant": "standard", "description": "ストレージゾーンを示すストレージポリシーオブジェクト。", "allOf": [ { "$ref": "#/components/schemas/StoragePolicy--Mini" }, { "properties": { "name": { "description": "地域のわかりやすい名前", "type": "string", "example": "Montreal / Dublin" } } } ] }, "StoragePolicies": { "title": "ストレージポリシー", "type": "object", "x-box-resource-id": "storage_policies", "x-box-tag": "storage_policies", "description": "ストレージポリシーのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "ストレージポリシーのリスト", "items": { "$ref": "#/components/schemas/StoragePolicy" } } } } ] }, "StoragePolicy--Mini": { "title": "ストレージポリシー (Mini)", "type": "object", "x-box-resource-id": "storage_policy--mini", "x-box-tag": "storage_policies", "x-box-variants": [ "standard", "mini" ], "x-box-variant": "mini", "description": "ストレージポリシーオブジェクトのMini版の説明", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このストレージポリシーの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`storage_policy`", "example": "storage_policy", "enum": [ "storage_policy" ] } } }, "StoragePolicyAssignment": { "title": "ストレージポリシー割り当て", "type": "object", "x-box-resource-id": "storage_policy_assignment", "x-box-tag": "storage_policy_assignments", "description": "ユーザーまたは会社へのストレージポリシーの割り当て", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "ストレージポリシー割り当ての一意の識別子。", "example": "ZW50ZXJwcmlzZV8xMjM0NTY3ODkw" }, "type": { "type": "string", "description": "`storage_policy_assignment`", "example": "storage_policy_assignment", "enum": [ "storage_policy_assignment" ] }, "storage_policy": { "allOf": [ { "$ref": "#/components/schemas/StoragePolicy--Mini" }, { "description": "割り当てられたストレージポリシー" } ] }, "assigned_to": { "allOf": [ { "title": "Reference", "description": "オブジェクトの最も基本的な参照", "type": "object", "properties": { "id": { "type": "string", "description": "このオブジェクトの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "このオブジェクトのタイプ", "example": "file" } } }, { "description": "そのポリシーが割り当てられる会社またはユーザー" } ] } } }, "StoragePolicyAssignments": { "title": "ストレージポリシー割り当て", "type": "object", "x-box-resource-id": "storage_policy_assignments", "x-box-tag": "storage_policy_assignments", "description": "ストレージポリシー割り当てのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "ストレージポリシー割り当てのリスト", "items": { "$ref": "#/components/schemas/StoragePolicyAssignment" } } } } ] }, "Task": { "title": "Task", "type": "object", "x-box-resource-id": "task", "x-box-tag": "tasks", "description": "タスクを使用すると、Boxでファイル中心のワークフローを実現できます。ユーザーはファイルに関連するタスクを作成し、タスクを完了するために他のユーザーに割り当てることができます。", "properties": { "id": { "type": "string", "description": "このタスクの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`task`", "example": "task", "enum": [ "task" ] }, "item": { "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "description": "タスクに関連付けられたファイル" } ] }, "due_at": { "type": "string", "format": "date-time", "description": "タスクの期限", "example": "2012-12-12T10:53:43-08:00" }, "action": { "type": "string", "example": "review", "description": "タスク担当者が実行するように求められるタスクのタイプ。", "enum": [ "review", "complete" ] }, "message": { "type": "string", "description": "タスクに含めるメッセージ", "example": "Legal review" }, "task_assignment_collection": { "allOf": [ { "$ref": "#/components/schemas/TaskAssignments" }, { "description": "タスクに関連付けられたタスク割り当てオブジェクトのコレクション" } ] }, "is_completed": { "type": "boolean", "description": "タスクが完了しているかどうか", "example": true }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "タスクを作成したユーザー" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "タスクオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "completion_rule": { "type": "string", "description": "タスクが完了と見なされる前にそのタスクを完了する必要がある担当者を定義します。\n\n* `all_assignees` - タスクが完了と見なされるには、すべての担当者がそのタスクをレビューまたは承認する必要があります。\n* `any_assignee` - いずれか1人の担当者がタスクをレビューまたは承認すれば、タスクが完了と見なされます。", "example": "all_assignees", "enum": [ "all_assignees", "any_assignee" ] } } }, "Tasks": { "title": "Tasks", "type": "object", "x-box-resource-id": "tasks", "x-box-tag": "tasks", "description": "タスクのリスト", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。", "example": 5000, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "タスクのリスト", "items": { "$ref": "#/components/schemas/Task" } } } }, "TaskAssignment": { "title": "タスク割り当て", "type": "object", "x-box-resource-id": "task_assignment", "x-box-tag": "task_assignments", "description": "タスク割り当てでは、完了するためにどのタスクをどのユーザーに割り当てるかを定義します。", "properties": { "id": { "type": "string", "description": "このタスク割り当ての一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`task_assignment`", "example": "task_assignment", "enum": [ "task_assignment" ] }, "item": { "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "description": "タスクが割り当てられているファイル。" } ] }, "assigned_to": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "タスクが割り当てられているユーザー。" } ] }, "message": { "type": "string", "example": "Please review", "description": "タスク割り当てに含められるメッセージ。これは、ウェブおよびモバイルUIで、タスクが割り当てられたユーザーに表示されます。" }, "completed_at": { "type": "string", "format": "date-time", "description": "このタスク割り当てが完了した日。タスクがまだ完了していない場合は`null`になります。", "example": "2012-12-12T10:53:43-08:00" }, "assigned_at": { "type": "string", "format": "date-time", "description": "このタスクがユーザーに割り当てられた日。", "example": "2012-12-12T10:53:43-08:00" }, "reminded_at": { "type": "string", "format": "date-time", "description": "タスクが割り当てられたユーザーに、このタスク割り当てがリマインドされた日。", "example": "2012-12-12T10:53:43-08:00" }, "resolution_state": { "type": "string", "description": "割り当ての現在の状態。使用可能な状態は、タスクオブジェクトの`action`値によって異なります。", "example": "incomplete", "enum": [ "completed", "incomplete", "approved", "rejected" ] }, "assigned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このタスクを割り当てたユーザー。" } ] } } }, "TaskAssignments": { "title": "タスク割り当て", "type": "object", "x-box-resource-id": "task_assignments", "x-box-tag": "task_assignments", "description": "タスク割り当てのリスト", "properties": { "total_count": { "description": "このコレクション内の項目の合計数。", "example": 100, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "タスク割り当てのリスト", "items": { "$ref": "#/components/schemas/TaskAssignment" } } } }, "TermsOfService": { "title": "サービス利用規約", "type": "object", "x-box-resource-id": "terms_of_service", "x-box-variant": "standard", "description": "1つのサービス利用規約に該当するとみなされるルートレベルのレコード。", "allOf": [ { "$ref": "#/components/schemas/TermsOfService--Base" }, { "properties": { "status": { "description": "これらの条件が有効になっているかどうか", "type": "string", "example": "enabled", "enum": [ "enabled", "disabled" ] }, "enterprise": { "allOf": [ { "title": "Enterprise", "type": "object", "description": "Boxに登録されている会社のレプリゼンテーション", "properties": { "id": { "type": "string", "description": "この会社の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "enum": [ "enterprise" ] }, "name": { "description": "会社の名前", "example": "Acme Inc.", "type": "string" } } }, { "description": "これらの利用規約が適用される会社" } ] }, "tos_type": { "description": "これらの利用規約を管理対象ユーザーに適用するか、外部ユーザーに適用するか", "type": "string", "example": "managed", "enum": [ "managed", "external" ] }, "text": { "description": "利用規約のテキスト。`status`が`disabled`に設定されている場合は、このテキストが空になることがあります。", "type": "string", "example": "By using this service, you agree to ..." }, "created_at": { "type": "string", "format": "date-time", "description": "リーガル項目が作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "リーガル項目が変更された日時。", "example": "2012-12-12T10:53:43-08:00" } } } ] }, "TermsOfServices": { "title": "サービス利用規約", "type": "object", "x-box-resource-id": "terms_of_services", "x-box-tag": "terms_of_services", "description": "サービス利用規約のリスト", "properties": { "total_count": { "description": "オブジェクトの合計数。", "example": 2, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "サービス利用規約オブジェクトのリスト", "items": { "$ref": "#/components/schemas/TermsOfService" } } } }, "TermsOfService--Base": { "title": "サービス利用規約 (Base)", "type": "object", "x-box-resource-id": "terms_of_service--base", "x-box-tag": "terms_of_services", "x-box-variants": [ "base", "standard" ], "x-box-variant": "base", "description": "1つのサービス利用規約に該当するとみなされるルートレベルのレコード。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このサービス利用規約の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`terms_of_service`", "example": "terms_of_service", "enum": [ "terms_of_service" ] } } }, "TermsOfServiceUserStatus": { "title": "サービス利用規約のユーザーステータス", "type": "object", "x-box-resource-id": "terms_of_service_user_status", "x-box-tag": "terms_of_service_user_statuses", "description": "サービス利用規約とユーザーの関連付け", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このサービス利用規約のユーザーステータスの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`terms_of_service_user_status`", "example": "terms_of_service_user_status", "enum": [ "terms_of_service_user_status" ] }, "tos": { "allOf": [ { "$ref": "#/components/schemas/TermsOfService--Base" }, { "description": "サービス利用規約" } ] }, "user": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "ユーザー" } ] }, "is_accepted": { "type": "boolean", "example": true, "description": "ユーザーがサービス利用規約に同意したかどうか" }, "created_at": { "type": "string", "format": "date-time", "description": "リーガル項目が作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "リーガル項目が変更された日時。", "example": "2012-12-12T10:53:43-08:00" } } }, "TermsOfServiceUserStatuses": { "title": "サービス利用規約のユーザーステータス", "type": "object", "x-box-resource-id": "terms_of_services_user_statuses", "x-box-tag": "terms_of_service_user_statuses", "description": "サービス利用規約のユーザーステータスのリスト", "properties": { "total_count": { "description": "オブジェクトの合計数。", "example": 2, "type": "integer", "format": "int64" }, "entries": { "type": "array", "description": "サービス利用規約のユーザーステータスのリスト", "items": { "$ref": "#/components/schemas/TermsOfServiceUserStatus" } } } }, "SignTemplate": { "title": "Box Signテンプレート", "type": "object", "x-box-resource-id": "sign_template", "x-box-tag": "sign_templates", "description": "Box Signテンプレートオブジェクト", "allOf": [ { "properties": { "type": { "type": "string", "example": "sign-template", "enum": [ "sign-template" ], "description": "オブジェクトタイプ" }, "id": { "type": "string", "example": "4206996024-14944f75-c34b-478a-95a1-264b1ff80d35", "description": "テンプレートの識別子。" }, "name": { "type": "string", "nullable": true, "example": "Official contract", "description": "テンプレートの名前。" }, "email_subject": { "type": "string", "example": "Sign Request from Acme", "description": "署名リクエストメールの件名。これは、署名リクエストによって消去されます。このフィールドを渡さない場合は、デフォルトの件名が使用されます。", "nullable": true }, "email_message": { "type": "string", "example": "Hello! Please sign the document below", "description": "署名リクエストメールに含めるメッセージ。このフィールドは、特定の文字のサニタイズによって消去されます。ただし、一部のHTMLタグは使用できます。また、このメッセージに含まれているリンクはメールではハイパーリンクに変換されます。 このメッセージには、HTMLタグ`a`、`abbr`、`acronym`、`b`、`blockquote`、`code`、`em`、`i`、`ul`、`li`、`ol`、`strong`を含めることができます。HTMLに対するテキストの比率が大きすぎると、メールがスパムフィルタに入る可能性があることに注意してください。これらのタグにカスタムスタイルを適用することはできません。このフィールドを渡さない場合は、デフォルトのメッセージが使用されます。", "nullable": true }, "days_valid": { "type": "integer", "description": "作成した署名リクエストが完了しなかった場合に自動的に期限切れになるまでの日数を設定します。デフォルトでは、署名リクエストに有効期限を適用しないため、署名リクエストは期限切れになりません。", "minimum": 0, "maximum": 730, "example": 2, "nullable": true }, "parent_folder": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "最終的な署名済みドキュメントと署名ログの保存先フォルダ。`ID`フィールドと`type`フィールドのみが必要です。ルートフォルダ (フォルダID `0`) は使用できません。" } ] }, "source_files": { "type": "array", "items": { "$ref": "#/components/schemas/File--Mini" }, "description": "署名するドキュメントの作成元ファイルのリスト。ファイルごとにIDフィールドとtypeフィールドのみが必要です。" }, "are_fields_locked": { "type": "boolean", "description": "テンプレートの入力フィールドが編集可能かどうかを示します。", "example": false }, "are_options_locked": { "type": "boolean", "description": "テンプレートドキュメントのオプション (ドキュメントの名前変更など) が編集可能かどうかを示します。", "example": true }, "are_recipients_locked": { "type": "boolean", "description": "テンプレートの署名者が編集可能かどうかを示します。", "example": false }, "are_email_settings_locked": { "type": "boolean", "description": "テンプレートのメール設定が編集可能かどうかを示します。", "example": true }, "are_files_locked": { "type": "boolean", "description": "テンプレートファイルが編集可能かどうかを示します。これには、テンプレートファイルの削除または名前変更が含まれます。", "example": true }, "signers": { "type": "array", "items": { "$ref": "#/components/schemas/TemplateSigner" }, "description": "テンプレートの署名者の配列。" }, "additional_info": { "description": "必須フィールドと編集不可フィールドに関する追加情報。", "type": "object", "properties": { "non_editable": { "type": "array", "description": "編集不可フィールド。", "items": { "type": "string", "enum": [ "email_subject", "email_message", "name", "days_valid", "signers", "source_files" ] }, "example": [ "email_subject", "name" ] }, "required": { "type": "object", "description": "必須フィールド。", "properties": { "signers": { "description": "必須の署名者フィールド。", "example": [ [ "email" ], [ "email" ] ], "type": "array", "items": { "type": "array", "items": { "type": "string", "enum": [ "email" ] }, "example": [ "email" ] } } } } } }, "ready_sign_link": { "nullable": true, "description": "Boxの署名リンク機能により、テンプレートから作成した署名リクエストへのリンクを作成できます。このリンクは、署名者が誰になるか不明な状態で公開フォーム (メール、ソーシャルメディアの投稿、ウェブページなど) に署名リクエストを投稿する場合に使用します。注: 署名リンク機能は、Enterprise Plusをご利用のお客様に限定されており、Box Verified Enterpriseでは利用できません。", "type": "object", "properties": { "url": { "type": "string", "description": "署名者に送信できるURL。", "example": "\"https://app.box.com/sign/\nready-sign-link/a1cdf2c7-fa81-4a67-8163-1e5f4dbe5178\"" }, "name": { "type": "string", "nullable": true, "description": "リクエスト名。", "example": "Official contract" }, "instructions": { "type": "string", "nullable": true, "description": "署名者全員に対する追加の指示。", "example": "Hello! Please sign the document below" }, "folder_id": { "type": "string", "nullable": true, "example": "12345", "description": "最終的な署名済みドキュメントと署名ログの保存先フォルダ。`ID`フィールドと`type`フィールドのみが必要です。ルートフォルダ (フォルダID `0`) は使用できません。" }, "is_notification_disabled": { "type": "boolean", "description": "署名者が署名したときの通知を無効にするかどうか。", "example": true }, "is_active": { "type": "boolean", "description": "署名リンクが有効になっているかどうか。", "example": false } } }, "custom_branding": { "nullable": true, "type": "object", "description": "通知および署名リクエストに適用されているカスタムブランド設定。", "properties": { "company_name": { "description": "会社の名前", "type": "string", "nullable": true, "example": "Corporation inc." }, "logo_uri": { "type": "string", "nullable": true, "description": "カスタムブランド設定のロゴURI (base64画像形式)。", "example": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA\nAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A\n8AAQUBAScY42YAAAAASUVORK5CYII=" }, "branding_color": { "type": "string", "nullable": true, "example": "9E5E6F", "description": "カスタムブランド設定の色 (16進数)。" }, "email_footer_text": { "type": "string", "nullable": true, "example": "Contact email email@mail.com", "description": "メールフッターのコンテンツ。" } } } } } ] }, "SignTemplates": { "title": "Box Signテンプレート", "type": "object", "x-box-resource-id": "sign_templates", "x-box-tag": "sign_templates", "description": "任意のBox Sign APIエンドポイントからデフォルトで返されるテンプレートのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "テンプレートのリスト。", "items": { "$ref": "#/components/schemas/SignTemplate" } } } } ] }, "TemplateSigner": { "title": "テンプレートの署名者フィールド", "type": "object", "description": "テンプレートの署名者のスキーマ", "allOf": [ { "properties": { "inputs": { "type": "array", "items": { "$ref": "#/components/schemas/TemplateSignerInput" }, "readOnly": true }, "email": { "type": "string", "description": "署名者のメールアドレス", "example": "example@mail.com", "nullable": true }, "role": { "type": "string", "enum": [ "signer", "approver", "final_copy_reader" ], "description": "署名リクエストに含まれる署名者の役割を定義します。役割が`signer`の場合はドキュメントの署名する必要があり、`approver`の場合はドキュメントを承認します。また、最終的な署名済みドキュメントと署名ログを受け取るのは、`final_copy_reader`役割のみです。", "example": "signer", "default": "signer" }, "is_in_person": { "type": "boolean", "description": "署名者の埋め込みURLと組み合わせて使用されます。送信者が署名すると、その次の`in_person`署名者にリダイレクトされます。", "example": true }, "order": { "type": "integer", "description": "署名者の順序", "minimum": 0, "example": 2 }, "signer_group_id": { "type": "string", "description": "指定した場合、この値は、同じ入力が割り当てられ、同じ署名者グループに属している署名者を指します。署名者グループはBoxグループではありません。これは、テンプレート自体に属しているエンティティであり、そのテンプレートから作成された署名リクエスト内でのみ使用できます。", "example": "cd4ff89-8fc1-42cf-8b29-1890dedd26d7", "nullable": true } } } ] }, "TemplateSignerInput": { "title": "テンプレートの署名者の入力", "type": "object", "description": "テンプレートに署名者が作成した入力", "required": [ "page_index" ], "allOf": [ { "$ref": "#/components/schemas/SignRequestPrefillTag" }, { "properties": { "type": { "type": "string", "enum": [ "signature", "date", "text", "checkbox", "attachment", "radio", "dropdown" ], "description": "入力の種類", "example": "text" }, "content_type": { "type": "string", "enum": [ "signature", "initial", "stamp", "date", "checkbox", "text", "full_name", "first_name", "last_name", "company", "title", "email", "attachment", "radio", "dropdown" ], "description": "入力のコンテンツタイプ", "example": "text" }, "is_required": { "type": "boolean", "description": "入力が必要かどうか。", "example": true }, "page_index": { "type": "integer", "description": "入力が配置されるページのインデックス。", "example": 4 }, "document_id": { "type": "string", "description": "ドキュメントの識別子。", "example": "123075213-eb54b537-8b25-445e-87c1-5a1c67d8cbd7", "nullable": true }, "dropdown_choices": { "type": "array", "example": [ "Yes", "No", "Maybe" ], "description": "入力のタイプが`dropdown`の場合、この値には、ドロップダウンのすべてのオプションが設定されます。", "nullable": true, "items": { "type": "string" } }, "group_id": { "type": "string", "description": "入力のタイプが`radio`の場合、この識別子で収集するようにグループ化できます。", "nullable": true, "example": "da317330-225a-4c72-89ad-0d6dcaaf4df6" }, "coordinates": { "type": "object", "description": "ページ上で入力が配置される場所。", "properties": { "x": { "type": "number", "example": 0.672258592471358, "description": "入力が配置されるページに対する相対的なx座標 (範囲は0～1)。" }, "y": { "type": "number", "example": 0.18654283173599448, "description": "入力が配置されるページに対する相対的なy座標 (範囲は0～1)。" } } }, "dimensions": { "type": "object", "description": "入力のサイズ。", "properties": { "width": { "type": "number", "example": 0.2618657937806874, "description": "入力が配置されるページに対する相対的な幅 (範囲は0～1)。" }, "height": { "type": "number", "example": 0.05311728090109673, "description": "入力が配置されるページに対する相対的な高さ (範囲は0～1)。" } } }, "label": { "type": "string", "description": "ラベルフィールドは、テキスト、添付、ラジオボタン、チェックボックスのタイプの入力に特に使用されます。", "nullable": true, "example": "Legal name" }, "read_only": { "type": "boolean", "description": "この入力が読み取り専用 (署名者による変更不可) として定義されているかどうか", "example": true } } } ] }, "TrashFile": { "title": "ごみ箱内のファイル", "type": "object", "x-box-resource-id": "trash_file", "x-box-tag": "trashed_files", "description": "ごみ箱内のファイルを表します。", "required": [ "id", "type", "sequence_id", "sha1", "description", "size", "path_collection", "created_at", "modified_at", "modified_by", "owned_by", "item_status" ], "properties": { "id": { "type": "string", "nullable": false, "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "123456789" }, "etag": { "type": "string", "example": "1", "nullable": true, "description": "このファイルのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にファイルに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。" }, "type": { "type": "string", "description": "`file`", "example": "file", "enum": [ "file" ], "nullable": false }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "ファイルの名前", "example": "Contract.pdf" }, "sha1": { "type": "string", "format": "digest", "nullable": false, "example": "85136C79CBF9FE36BB9D05D0639C70C265C18D37", "description": "ファイルのSHA1ハッシュ。Box上のファイルとローカルファイルの内容を比較する目的に使用できます。" }, "file_version": { "allOf": [ { "$ref": "#/components/schemas/FileVersion--Mini" }, { "description": "ファイルの現在のバージョンに関する情報。" } ] }, "description": { "type": "string", "nullable": false, "description": "このファイルの説明 (省略可)", "maxLength": 256, "example": "Contract for Q1 renewal" }, "size": { "type": "integer", "nullable": false, "description": "ファイルサイズ (バイト単位)。この整数を解析する際には、非常に大きな数値となって整数オーバーフローになる可能性があるため、注意が必要です。", "example": 629644 }, "path_collection": { "allOf": [ { "title": "パスのコレクション (ごみ箱)", "description": "ごみ箱内の項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "description": "この項目のパスのコレクションのフォルダの配列", "type": "array", "items": { "type": "object", "description": "この項目の親フォルダ", "properties": { "type": { "type": "string", "description": "`folder`", "enum": [ "folder" ], "example": "folder" }, "id": { "type": "string", "description": "フォルダを表す一意の識別子。", "example": "123456789" }, "sequence_id": { "type": "string", "nullable": true, "example": null, "description": "ごみ箱フォルダの場合、このフィールドはnullです" }, "etag": { "type": "string", "nullable": true, "example": null, "description": "ごみ箱フォルダの場合、このフィールドはnullです" }, "name": { "type": "string", "description": "ごみ箱フォルダの名前。", "example": "Trash", "nullable": false } } } } } }, { "description": "ルートフォルダを起点にした、このファイルを含むフォルダツリー。" }, { "nullable": false } ] }, "created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Box上でこのファイルが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Boxでこのファイルが最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trashed_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルがごみ箱に移動された日時。", "example": "2012-12-12T10:53:43-08:00" }, "purged_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルがごみ箱から削除される予定日時。", "example": "2012-12-12T10:53:43-08:00" }, "content_created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最初に作成された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "content_modified_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最後に更新された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "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": { "type": "string", "description": "このファイルの共有リンク。ファイルがごみ箱に移動された場合、このリンクはアクティブではなくなるため、これは`null`になります。", "example": null, "nullable": true }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このファイルが配置されているフォルダ。" }, { "nullable": true } ] }, "item_status": { "type": "string", "description": "この項目が削除されたかどうかを定義します。\n\n* `active` - 項目がごみ箱に移動されていない場合。\n* `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。\n* `deleted` - 項目がすでに完全に削除されている場合。", "enum": [ "active", "trashed", "deleted" ], "nullable": false, "example": "trashed" } } }, "TrashFolder": { "title": "ごみ箱内のフォルダ", "type": "object", "x-box-resource-id": "trash_folder", "x-box-tag": "trashed_folders", "description": "ごみ箱内のフォルダを表します。", "required": [ "id", "type", "name", "description", "size", "path_collection", "created_by", "modified_by", "owned_by", "item_status" ], "properties": { "id": { "type": "string", "nullable": false, "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folders/123`の場合、`folder_id`は`123`です。", "example": "123456789" }, "etag": { "type": "string", "nullable": true, "example": "1", "description": "このフォルダのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にフォルダに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。" }, "type": { "type": "string", "description": "`folder`", "example": "folder", "enum": [ "folder" ], "nullable": false }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "フォルダの名前。", "example": "Contracts", "nullable": false }, "created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが作成された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このフォルダが最後に更新された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。", "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": { "type": "integer", "format": "int64", "description": "フォルダサイズ (バイト単位)。\n\nこの整数を解析する際には、値が非常に大きくなることがあるため注意が必要です。", "example": 629644, "nullable": false }, "path_collection": { "allOf": [ { "title": "パスのコレクション (ごみ箱)", "description": "ごみ箱内の項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "description": "この項目のパスのコレクションのフォルダの配列", "type": "array", "items": { "type": "object", "description": "この項目の親フォルダ", "properties": { "type": { "type": "string", "description": "`folder`", "enum": [ "folder" ], "example": "folder" }, "id": { "type": "string", "description": "フォルダを表す一意の識別子。", "example": "123456789" }, "sequence_id": { "type": "string", "nullable": true, "example": null, "description": "ごみ箱フォルダの場合、このフィールドはnullです" }, "etag": { "type": "string", "nullable": true, "example": null, "description": "ごみ箱フォルダの場合、このフィールドはnullです" }, "name": { "type": "string", "description": "ごみ箱フォルダの名前。", "example": "Trash", "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": { "type": "string", "format": "date-time", "description": "このフォルダがごみ箱に移動された日時。", "example": "2012-12-12T10:53:43-08:00", "nullable": true }, "purged_at": { "type": "string", "format": "date-time", "description": "このフォルダがごみ箱から削除される予定日時。", "example": "2012-12-12T10:53:43-08:00", "nullable": true }, "content_created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが最初に作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "content_modified_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "owned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このフォルダを所有するユーザー。" }, { "nullable": false } ] }, "shared_link": { "type": "string", "description": "このフォルダの共有リンク。フォルダがごみ箱に移動された場合、このリンクはアクティブではなくなるため、これは`null`になります。", "example": null, "nullable": true }, "folder_upload_email": { "type": "string", "description": "このフォルダのフォルダアップロード用メールアドレス。フォルダがごみ箱に移動された場合、アップロードは動作しなくなるため、これは`null`になります。", "example": null, "nullable": true }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このフォルダが配置されているフォルダ (省略可)\n\nルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になることがあります。" }, { "nullable": true } ] }, "item_status": { "type": "string", "description": "この項目が削除されたかどうかを定義します。\n\n* `active` - 項目がごみ箱に移動されていない場合。\n* `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。\n* `deleted` - 項目がすでに完全に削除されている場合。", "enum": [ "active", "trashed", "deleted" ], "nullable": false, "example": "trashed" } } }, "TrashWebLink": { "title": "ごみ箱内のウェブリンク", "type": "object", "x-box-resource-id": "trash_web_link", "x-box-tag": "trashed_web_links", "description": "ごみ箱内のウェブリンクを表します。", "properties": { "type": { "type": "string", "description": "`web_link`", "example": "web_link", "enum": [ "web_link" ] }, "id": { "type": "string", "description": "このウェブリンクの一意の識別子", "example": "11446498" }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "etag": { "type": "string", "example": "1", "description": "このウェブリンクのエンティティタグ。`If-Match`ヘッダーで使用します。" }, "name": { "type": "string", "description": "ウェブリンクの名前", "example": "My Bookmark" }, "url": { "type": "string", "example": "https://www.example.com/example/1234", "description": "このウェブリンクが指すURL" }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "ウェブリンクが属する親オブジェクト" } ] }, "description": { "type": "string", "example": "Example page", "description": "ウェブリンクに付加される説明。この説明は、Boxウェブアプリケーション内に表示されます。" }, "path_collection": { "allOf": [ { "title": "パスのコレクション (ごみ箱)", "description": "ごみ箱内の項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "description": "この項目のパスのコレクションのフォルダの配列", "type": "array", "items": { "type": "object", "description": "この項目の親フォルダ", "properties": { "type": { "type": "string", "description": "`folder`", "enum": [ "folder" ], "example": "folder" }, "id": { "type": "string", "description": "フォルダを表す一意の識別子。", "example": "123456789" }, "sequence_id": { "type": "string", "nullable": true, "example": null, "description": "ごみ箱フォルダの場合、このフィールドはnullです" }, "etag": { "type": "string", "nullable": true, "example": null, "description": "ごみ箱フォルダの場合、このフィールドはnullです" }, "name": { "type": "string", "description": "ごみ箱フォルダの名前。", "example": "Trash", "nullable": false } } } } } }, { "description": "ルートフォルダを起点にした、このウェブリンクを含むフォルダツリー。" }, { "nullable": false } ] }, "created_at": { "type": "string", "format": "date-time", "description": "このファイルがBoxのサーバー上に作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このファイルがBoxサーバー上で最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trashed_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最後にごみ箱に移動された日時。", "example": "2012-12-12T10:53:43-08:00" }, "purged_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが完全に削除される日時。", "example": "2012-12-12T10:53:43-08:00" }, "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": { "type": "string", "description": "このブックマークの共有リンク。ブックマークがごみ箱に移動された場合、このリンクはアクティブではなくなるため、これは`null`になります。", "example": null, "nullable": true }, "item_status": { "type": "string", "example": "trashed", "enum": [ "active", "trashed", "deleted" ], "description": "この項目が削除されたかどうか。値には、`active`、`trashed` (ファイルがごみ箱に移動された場合)、`deleted` (ファイルが完全に削除された場合) があります。" } } }, "TrashFileRestored": { "title": "ごみ箱内のファイル (復元済み)", "type": "object", "x-box-resource-id": "trash_file_restored", "x-box-tag": "trashed_files", "description": "ごみ箱から復元されたファイルを表します。", "required": [ "id", "type", "sequence_id", "sha1", "description", "size", "path_collection", "created_at", "modified_at", "modified_by", "owned_by", "item_status" ], "properties": { "id": { "type": "string", "nullable": false, "description": "ファイルを表す一意の識別子。\n\nファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/files/123`の場合、`file_id`は`123`です。", "example": "123456789" }, "etag": { "type": "string", "example": "1", "nullable": true, "description": "このファイルのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にファイルに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。" }, "type": { "type": "string", "description": "`file`", "example": "file", "enum": [ "file" ], "nullable": false }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "ファイルの名前", "example": "Contract.pdf" }, "sha1": { "type": "string", "format": "digest", "nullable": false, "example": "85136C79CBF9FE36BB9D05D0639C70C265C18D37", "description": "ファイルのSHA1ハッシュ。Box上のファイルとローカルファイルの内容を比較する目的に使用できます。" }, "file_version": { "allOf": [ { "$ref": "#/components/schemas/FileVersion--Mini" }, { "description": "ファイルの現在のバージョンに関する情報。" } ] }, "description": { "type": "string", "nullable": false, "description": "このファイルの説明 (省略可)", "maxLength": 256, "example": "Contract for Q1 renewal" }, "size": { "type": "integer", "nullable": false, "description": "ファイルサイズ (バイト単位)。この整数を解析する際には、非常に大きな数値となって整数オーバーフローになる可能性があるため、注意が必要です。", "example": 629644 }, "path_collection": { "allOf": [ { "title": "パスのコレクション", "description": "項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "type": "array", "description": "この項目の親フォルダ", "nullable": false, "items": { "$ref": "#/components/schemas/Folder--Mini" } } } }, { "description": "ルートフォルダを起点にした、このファイルを含むフォルダツリー。" }, { "nullable": false } ] }, "created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Box上でこのファイルが作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Boxでこのファイルが最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trashed_at": { "type": "string", "nullable": true, "description": "このファイルがごみ箱に移動された日時。復元後は`null`になります。", "example": null }, "purged_at": { "type": "string", "nullable": true, "description": "このファイルがごみ箱から削除される予定日時。復元後は`null`になります。", "example": null }, "content_created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最初に作成された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "content_modified_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが最後に更新された日時。この日時はファイルがBoxにアップロードされた時点よりも前になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "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": { "type": "string", "description": "このファイルの共有リンク。ファイルがごみ箱に移動された場合、元の共有リンクが再度アクティブになっても、これは`null`になります。", "nullable": true, "example": null }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このファイルが配置されているフォルダ。" }, { "nullable": true } ] }, "item_status": { "type": "string", "description": "この項目が削除されたかどうかを定義します。\n\n* `active` - 項目がごみ箱に移動されていない場合。\n* `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。\n* `deleted` - 項目がすでに完全に削除されている場合。", "enum": [ "active", "trashed", "deleted" ], "nullable": false, "example": "active" } } }, "TrashFolderRestored": { "title": "ごみ箱内のフォルダ (復元済み)", "type": "object", "x-box-resource-id": "trash_folder_restored", "x-box-tag": "trashed_folders", "description": "ごみ箱から復元されたフォルダを表します。", "properties": { "id": { "type": "string", "nullable": false, "description": "フォルダを表す一意の識別子。\n\nフォルダIDを確認するには、ウェブアプリケーションでフォルダにアクセスして、URLからIDをコピーします。たとえば、URLが`https://*.app.box.com/folders/123`の場合、`folder_id`は`123`です。", "example": "123456789" }, "etag": { "type": "string", "nullable": true, "example": "1", "description": "このフォルダのHTTP `etag`。これは変更が発生した場合 (またはしなかった場合) にフォルダに対して変更を行う目的でのみ、`If-Match`および`If-None-Match`ヘッダー内の一部のAPIエンドポイントで使用できます。" }, "type": { "type": "string", "description": "`folder`", "example": "folder", "enum": [ "folder" ], "nullable": false }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "フォルダの名前。", "example": "Contracts", "nullable": false }, "created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが作成された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このフォルダが最後に更新された日時。ルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になる場合があります。", "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": { "type": "integer", "format": "int64", "description": "フォルダサイズ (バイト単位)。\n\nこの整数を解析する際には、値が非常に大きくなることがあるため注意が必要です。", "example": 629644, "nullable": false }, "path_collection": { "allOf": [ { "title": "パスのコレクション", "description": "項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "type": "array", "description": "この項目の親フォルダ", "nullable": false, "items": { "$ref": "#/components/schemas/Folder--Mini" } } } }, { "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": { "type": "string", "description": "このフォルダがごみ箱に移動された日時。復元後は`null`になります。", "example": null, "nullable": true }, "purged_at": { "type": "string", "description": "このフォルダがごみ箱から削除される予定日時。復元後は`null`になります。", "example": null, "nullable": true }, "content_created_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが最初に作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "content_modified_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このフォルダが最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "owned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "このフォルダを所有するユーザー。" }, { "nullable": false } ] }, "shared_link": { "type": "string", "description": "このファイルの共有リンク。フォルダがごみ箱に移動された場合、元の共有リンクが再度アクティブになっても、これは`null`になります。", "example": null, "nullable": true }, "folder_upload_email": { "type": "string", "description": "このフォルダのフォルダアップロード用メールアドレス。フォルダがごみ箱に移動された場合、元のアップロード用メールアドレスが再度アクティブになっても、これは`null`になります。", "example": null, "nullable": true }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このフォルダが配置されているフォルダ (省略可)\n\nルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になることがあります。" }, { "nullable": true } ] }, "item_status": { "type": "string", "description": "この項目が削除されたかどうかを定義します。\n\n* `active` - 項目がごみ箱に移動されていない場合。\n* `trashed` - 項目がごみ箱に移動されているが、まだ削除されていない場合。\n* `deleted` - 項目がすでに完全に削除されている場合。", "enum": [ "active", "trashed", "deleted" ], "nullable": false, "example": "active" } } }, "TrashWebLinkRestored": { "title": "ごみ箱内のウェブリンク (復元済み)", "type": "object", "x-box-resource-id": "trash_web_link_restored", "x-box-tag": "trashed_web_links", "description": "ごみ箱から復元されたウェブリンクを表します。", "required": [ "sequence_id", "path_collection" ], "properties": { "type": { "type": "string", "description": "`web_link`", "example": "web_link", "enum": [ "web_link" ] }, "id": { "type": "string", "description": "このウェブリンクの一意の識別子", "example": "11446498" }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "etag": { "type": "string", "example": "1", "description": "このウェブリンクのエンティティタグ。`If-Match`ヘッダーで使用します。" }, "name": { "type": "string", "description": "ウェブリンクの名前", "example": "My Bookmark" }, "url": { "type": "string", "example": "https://www.example.com/example/1234", "description": "このウェブリンクが指すURL" }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "ウェブリンクが属する親オブジェクト" } ] }, "description": { "type": "string", "example": "Example page", "description": "ウェブリンクに付加される説明。この説明は、Boxウェブアプリケーション内に表示されます。" }, "path_collection": { "allOf": [ { "title": "パスのコレクション", "description": "項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "type": "array", "description": "この項目の親フォルダ", "nullable": false, "items": { "$ref": "#/components/schemas/Folder--Mini" } } } }, { "description": "ルートフォルダを起点にした、このウェブリンクを含むフォルダツリー。" }, { "nullable": false } ] }, "created_at": { "type": "string", "format": "date-time", "description": "このファイルがBoxのサーバー上に作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このファイルがBoxサーバー上で最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trashed_at": { "type": "string", "nullable": true, "description": "このブックマークがごみ箱に移動された日時。復元後は`null`になります。", "example": null }, "purged_at": { "type": "string", "nullable": true, "description": "このブックマークが完全に削除される予定日時。復元後は`null`になります。", "example": null }, "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": { "type": "string", "description": "このブックマークの共有リンク。ブックマークがごみ箱に移動された場合、元の共有リンクが再度アクティブになっても、これは`null`になります。", "nullable": true, "example": null }, "item_status": { "type": "string", "example": "trashed", "enum": [ "active", "trashed", "deleted" ], "description": "この項目が削除されたかどうか。値には、`active`、`trashed` (ファイルがごみ箱に移動された場合)、`deleted` (ファイルが完全に削除された場合) があります。" } } }, "UploadPart": { "title": "Upload part", "type": "object", "x-box-resource-id": "upload_part", "x-box-variant": "standard", "description": "アップロードセッションチャンクのレプリゼンテーション。", "allOf": [ { "$ref": "#/components/schemas/UploadPart--Mini" }, { "properties": { "sha1": { "description": "チャンクのSHA1ハッシュ。", "type": "string", "example": "134b65991ed521fcfe4724b7d814ab8ded5185dc" } } } ] }, "UploadPart--Mini": { "title": "パーツのアップロード (Mini)", "type": "object", "x-box-resource-id": "upload_part--mini", "x-box-tag": "chunked_uploads", "x-box-variants": [ "mini", "standard" ], "x-box-variant": "mini", "description": "アップロードセッションチャンクのBase版の表示。", "properties": { "part_id": { "description": "チャンクの一意のID。", "type": "string", "example": "6F2D3486" }, "offset": { "description": "ファイル内のチャンクのオフセット (バイト数)。ファイル内のチャンクの位置の下限です。", "type": "integer", "format": "int64", "example": 16777216 }, "size": { "description": "チャンクのサイズ (バイト単位)。", "type": "integer", "format": "int64", "example": 3222784 } } }, "UploadedPart": { "title": "アップロードされたパーツ", "type": "object", "x-box-resource-id": "uploaded_part", "description": "いくつかのエンドポイントで返されるように、アップロードセッションの一部としてアップロードされたファイルのチャンク。", "x-box-tag": "chunked_uploads", "properties": { "part": { "$ref": "#/components/schemas/UploadPart" } } }, "UploadParts": { "title": "Upload part", "type": "object", "x-box-resource-id": "upload_parts", "x-box-tag": "chunked_uploads", "description": "アップロードセッションのアップロード済みチャンクのリスト。", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "アップロードセッションのアップロード済みチャンクのリスト", "items": { "$ref": "#/components/schemas/UploadPart" } } } } ] }, "UploadSession": { "title": "アップロードセッション", "type": "object", "x-box-resource-id": "upload_session", "description": "ファイルをアップロードするチャンクのアップロードセッション。", "x-box-tag": "chunked_uploads", "properties": { "id": { "type": "string", "description": "このセッションの一意の識別子", "example": "F971964745A5CD0C001BBE4E58196BFD" }, "type": { "type": "string", "description": "`upload_session`", "example": "upload_session", "enum": [ "upload_session" ] }, "session_expires_at": { "description": "このセッションが期限切れになる日時。", "type": "string", "format": "date-time", "example": "2012-12-12T10:53:43-08:00" }, "part_size": { "type": "integer", "format": "int64", "example": 1024, "description": "アップロードのすべての部分で使用する必要があるサイズ (バイト単位)。\n\n最後の部分のみ、これより小さいサイズを使用できます。" }, "total_parts": { "type": "integer", "format": "int32", "example": 1000, "description": "ファイルのサイズとパーツのサイズで決定される、このアップロードセッションで予想されるパーツの総数。" }, "num_parts_processed": { "type": "integer", "format": "int32", "example": 455, "description": "アップロードが完了し、サーバーで処理されたパーツの数。値は`0`から始まります。\n\nファイルをコミットするときにこのプロパティを調べることで、すべてのパーツが正しくアップロードされているかどうかを確認できます。" }, "session_endpoints": { "allOf": [ { "title": "セッションエンドポイント", "description": "分割アップロードセッションに使用されるエンドポイントのリスト。", "type": "object", "properties": { "upload_part": { "type": "string", "description": "パーツのアップロード先のURL", "example": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD" }, "commit": { "type": "string", "description": "ファイルのコミットに使用されるURL", "example": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit" }, "abort": { "type": "string", "description": "セッションの中止に使用されるURL。", "example": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD" }, "list_parts": { "type": "string", "description": "すべてのパーツのリストを取得するためのURL。", "example": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/parts" }, "status": { "type": "string", "description": "アップロードステータスの取得に使用されるURL。", "example": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD" }, "log_event": { "type": "string", "description": "アップロードログの取得に使用されるURL。", "example": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/log" } } }, { "description": "このセッションに使用されるエンドポイントのリスト。" } ] } } }, "UploadUrl": { "title": "アップロードURL", "type": "object", "x-box-resource-id": "upload_url", "x-box-tag": "uploads", "description": "ファイルのアップロードセッションの詳細。", "properties": { "upload_url": { "type": "string", "example": "https://upload-las.app.box.com/api/2.0/files/content?upload_session_id=1234", "description": "ファイルのアップロードに使用できるアップロードセッションのURL。" }, "upload_token": { "type": "string", "example": "Pc3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQP", "description": "ファイルをアップロードするために使用するアクセストークン (省略可)" } } }, "User": { "title": "User", "type": "object", "x-box-resource-id": "user", "x-box-variant": "standard", "description": "任意のユーザーAPIエンドポイントからデフォルトで返されるユーザーのStandard版の表示。", "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "properties": { "created_at": { "type": "string", "format": "date-time", "description": "ユーザーオブジェクトが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "ユーザーオブジェクトが最後に変更された日時", "example": "2012-12-12T10:53:43-08:00" }, "language": { "type": "string", "description": "修正版の[ISO 639-1](/guides/api-calls/language-codes)形式で表されるユーザーの言語。", "example": "en" }, "timezone": { "type": "string", "format": "timezone", "description": "ユーザーのタイムゾーン", "example": "Africa/Bujumbura" }, "space_amount": { "type": "integer", "format": "int64", "description": "ユーザーが利用可能な容量の合計 (バイト数)", "example": 11345156112 }, "space_used": { "type": "integer", "format": "int64", "description": "ユーザーが現在使用している容量", "example": 1237009912 }, "max_upload_size": { "type": "integer", "format": "int64", "description": "ユーザーが所有できる個々のファイルの最大サイズ (バイト単位)", "example": 2147483648 }, "status": { "type": "string", "enum": [ "active", "inactive", "cannot_delete_edit", "cannot_delete_edit_upload" ], "description": "ユーザーのアカウントのステータス", "example": "active" }, "job_title": { "type": "string", "description": "ユーザーの役職", "maxLength": 100, "example": "CEO" }, "phone": { "type": "string", "description": "ユーザーの電話番号", "maxLength": 100, "example": "6509241374" }, "address": { "type": "string", "description": "ユーザーの住所", "maxLength": 255, "example": "900 Jefferson Ave, Redwood City, CA 94063" }, "avatar_url": { "type": "string", "description": "ユーザーのアバター画像のURL", "example": "https://www.box.com/api/avatar/large/181216415" }, "notification_email": { "type": "object", "description": "通知メールが送信される代替の通知用メールアドレス。確認されると、通知メールはプライマリメールアドレスではなくこのメールアドレスに送信されます。", "nullable": true, "properties": { "email": { "type": "string", "example": "notifications@example.com", "description": "通知を送付するメールアドレス。" }, "is_confirmed": { "type": "boolean", "example": true, "description": "このメールアドレスが確認されたかどうかを指定します。" } } } } } ] }, "UserAvatar": { "title": "ユーザーのアバター", "type": "object", "x-box-resource-id": "user_avatar", "x-box-tag": "avatars", "description": "BoxアプリケーションにアップロードされたアバターへのURLを保持するリソース。", "properties": { "pic_urls": { "type": "object", "description": "ユーザーのアバターのURLを示すオブジェクトを表します。", "properties": { "small": { "type": "string", "description": "小さいサイズのアバターの場所。", "example": "https://app.box.com/index.php?rm=pic_storage_auth&pic=euks! pac3kv01!7B6R5cZLmurEV_xB-KkycPk8Oi7oENUX2O_qUtIuO4342CG IldyCto9hqiQP7uxqYU5V2w63Ft4ln4UVVLDtDZu903OqzkflY2O-Lq00 ubA29xU-RJ6b_KzJEWRYgUhX1zEl3dzWo12g8eWRE2rStf123DF7AYahNqM 1BmLmviL_nODc7SDQHedTXPAjxURUAra5BvtLe7B05AizbNXdPlCNp-LNh _S-eZ_RjDXcGO-MkRWd_3BOMHnvjf450t5BfKoJ15WhEfiMlfXH1tmouHXrsC 66cT6-pzF9E40Iir_zThqSlrFxzP_xcmXzHapr_k-0E2qr2TXp4iC396TSlEw\n" }, "large": { "type": "string", "description": "大きいサイズのアバターの場所。", "example": "https://app.box.com/index.php?rm=pic_storage_auth&pic=euks\npac3kv01!lipGQlQQOtCTCoB6zCOArUjVWLFJtLr5tn6aOZMCybhRx0NNuFQbVI36nw\njtEk5YjUUz1KVdVuvU2yDhu_ftK_bvxeKP1Ffrx9vKGVvJ-UJc1z32p6n2CmFzzpc\ngSoX4pnPhFgydAL-u9jDspXUGElr-htDG_HPMiE9DZjqDueOxXHy8xe22wbaPAheC\nao1emv8r_fmufaUgSndeMYmyZj-KqOYsLBrBNgdeiK5tZmPOQggAEUmyQPkrd8W92TQ6sSlIp0r" }, "preview": { "type": "string", "description": "アバターのプレビューの場所。", "example": "https://app.box.com/index.php?rm=pic_storage_auth&pic=euks!\npac3kv01!8UcNPweOOAWj2DtHk_dCQB4wJpzyPkl7mT5nHj5ZdjY92ejYCBBZc95--403b29CW\nk-8hSo_uBjh5h9QG42Ihu-cOZ-816sej1kof3SOm5gjn7qjMAx89cHjUaNK-6XasRqSNboenjZ\n04laZuV9vSH12BZGAYycIZvvQ5R66Go8xG5GTMARf2nBU84c4H_SL5iws-HeBS4oQJWOJh6FBl\nsSJDSTI74LGXqeZb3EY_As34VFC95F10uozoTOSubZmPYylPlaKXoKWk2f9wYQso1ZTN7sh-Gc\n9Kp43zMLhArIWhok0Im6FlRAuWOQ03KYgL-k4L5EZp4Gw6B7uqVRwcBbsTwMIorWq1g" } } } } }, "Users": { "title": "Users", "type": "object", "x-box-resource-id": "users", "x-box-tag": "users", "description": "ユーザーのリスト。", "allOf": [ { "type": "object", "description": "ページ割りについて説明しているAPIレスポンスの部分", "properties": { "total_count": { "description": "コレクション全体の最後のエントリのオフセットに1を加算した値。コレクション内のエントリの合計数は、`total_count`よりも少ない場合があります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 5000, "type": "integer", "format": "int64" }, "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "offset": { "description": "このセットに含まれる最初のエントリのゼロから始まるオフセット。これは、`offset`クエリパラメータと同じになります。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "example": 2000, "type": "integer", "format": "int64" }, "order": { "description": "項目が返される順序。\n\nこのフィールドは、オフセットベースのページ割りを使用する呼び出しのみで返されます。マーカーベースでページ割りされたAPIでは、このフィールドは省略されます。", "type": "array", "items": { "type": "object", "description": "ページ割りの順序", "properties": { "by": { "description": "並べ替えに使用するフィールド", "example": "type", "type": "string" }, "direction": { "type": "string", "description": "並べ替えの方向 (昇順または降順)", "example": "ASC", "enum": [ "ASC", "DESC" ] } } } } } }, { "properties": { "entries": { "type": "array", "description": "ユーザーのリスト", "items": { "$ref": "#/components/schemas/User--Full" } } } } ] }, "User--Full": { "title": "ユーザー (Full)", "type": "object", "x-box-resource-id": "user--full", "x-box-variant": "full", "description": "任意のユーザーAPIエンドポイントから返される可能性があるユーザーのFull版の表示。", "allOf": [ { "$ref": "#/components/schemas/User" }, { "properties": { "role": { "type": "string", "enum": [ "admin", "coadmin", "user" ], "description": "ユーザーの会社ロール", "example": "admin" }, "tracking_codes": { "type": "array", "items": { "$ref": "#/components/schemas/TrackingCode" }, "description": "追跡コードを使用すると、管理者は管理コンソールからレポートを生成し、特定のグループのユーザーに属性を割り当てることができます。この設定を使用するには、会社に対して有効にしておく必要があります。" }, "can_see_managed_users": { "type": "boolean", "example": true, "description": "ユーザーが自身の連絡先リストで会社の他のユーザーを参照できるかどうか" }, "is_sync_enabled": { "type": "boolean", "description": "ユーザーがBox Syncを使用できるかどうか", "example": true }, "is_external_collab_restricted": { "type": "boolean", "example": true, "description": "ユーザーが社外のユーザーとのコラボレーションを許可されているかどうか" }, "is_exempt_from_device_limits": { "type": "boolean", "example": true, "description": "会社のデバイス制限からユーザーを除外するかどうか" }, "is_exempt_from_login_verification": { "type": "boolean", "example": true, "description": "ユーザーが2要素認証を使用する必要があるかどうか" }, "enterprise": { "allOf": [ { "title": "Enterprise", "type": "object", "description": "Boxに登録されている会社のレプリゼンテーション", "properties": { "id": { "type": "string", "description": "この会社の一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`enterprise`", "example": "enterprise", "enum": [ "enterprise" ] }, "name": { "description": "会社の名前", "example": "Acme Inc.", "type": "string" } } }, { "description": "ユーザーの会社のレプリゼンテーション" } ] }, "my_tags": { "type": "array", "items": { "type": "string" }, "example": [ "important" ], "description": "ユーザーが所有するすべてのファイルとフォルダのタグ。返される値にはリクエスト元によって設定されたタグのみが含まれます。" }, "hostname": { "type": "string", "example": "https://example.app.box.com/", "description": "ユーザーに対して生成する必要があるリンクのルート (プロトコル、サブドメイン、ドメイン)" }, "is_platform_access_only": { "type": "boolean", "example": true, "description": "ユーザーがApp Userであるかどうか" }, "external_app_user_id": { "type": "string", "example": "my-user-1234", "description": "ユーザーの検索に使用できる、アプリユーザーの外部識別子。これを使用して、外部IDプロバイダのユーザーIDをBoxユーザーに結び付けることができます。" } } } ] }, "User--Mini": { "title": "ユーザー (Mini)", "type": "object", "x-box-resource-id": "user--mini", "x-box-variant": "mini", "description": "他のリソース内にネストされたときに返される可能性があるユーザーのMini版の表示。", "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "properties": { "name": { "type": "string", "description": "このユーザーの表示名", "example": "Aaron Levie", "maxLength": 50, "nullable": false }, "login": { "type": "string", "format": "email", "description": "このユーザーのプライマリメールアドレス", "example": "ceo@example.com", "nullable": false } } } ] }, "User--Base": { "title": "ユーザー (Base)", "type": "object", "x-box-resource-id": "user--base", "x-box-tag": "users", "x-box-variants": [ "base", "mini", "standard", "full" ], "x-box-variant": "base", "description": "他のリソース内にネストされたときに使用されるユーザーのMini版の表示。", "required": [ "type", "id" ], "properties": { "id": { "type": "string", "description": "このユーザーの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`user`", "example": "user", "nullable": false, "enum": [ "user" ] } } }, "User--Collaborations": { "title": "ユーザー (コラボレーション)", "type": "object", "x-box-resource-id": "user_collaborations", "x-box-variant": "collaborations", "description": "ユーザーのMini版の表示は、ステータスが`pending`の場合にのみ返すことができます。", "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "properties": { "name": { "type": "string", "description": "このユーザーの表示名。コラボレーションのステータスが`pending`の場合、空の文字列が返されます。", "example": "Aaron Levie", "maxLength": 50, "nullable": false }, "login": { "type": "string", "format": "email", "description": "このユーザーのプライマリメールアドレス。コラボレーションのステータスが`pending`の場合、空の文字列が返されます。", "example": "ceo@example.com", "nullable": false } } } ] }, "UserIntegrationMappings": { "title": "ユーザー (統合マッピング)", "type": "object", "x-box-resource-id": "user_integration_mappings_reference", "x-box-tag": "users", "description": "統合マッピングAPIのためのユーザーのレプリゼンテーション。フィールド名とログインは必要ありません。", "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "properties": { "name": { "type": "string", "description": "このユーザーの表示名", "example": "Aaron Levie", "maxLength": 50, "nullable": false }, "login": { "type": "string", "format": "email", "description": "このユーザーのプライマリメールアドレス", "example": "ceo@example.com", "nullable": false } } } ] }, "Watermark": { "title": "Watermark", "type": "object", "x-box-resource-id": "watermark", "x-box-tag": "file_watermarks", "description": "電子すかしとは、埋め込みファイルのプレビューに適用される半透明のオーバーレイです。電子すかしには、ビューアーのメールアドレスまたはユーザーIDと、ファイルのコンテンツのアクセス日時が表示されます。", "properties": { "watermark": { "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "description": "この電子すかしが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このタスクが変更された日時", "example": "2012-12-12T10:53:43-08:00" } } } } }, "Webhook": { "title": "Webhook", "type": "object", "x-box-resource-id": "webhook", "x-box-variant": "standard", "x-box-tag": "webhooks", "description": "設定されたWebhookを表します。", "allOf": [ { "$ref": "#/components/schemas/Webhook--Mini" }, { "properties": { "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "Webhookを作成したユーザー" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "Webhookが作成された日時を示すタイムスタンプ。", "example": "2012-12-12T10:53:43-08:00" }, "address": { "type": "string", "example": "https://example.com/webhooks", "description": "このWebhookによって通知されるURL" }, "triggers": { "type": "array", "example": [ "FILE.UPLOADED" ], "description": "このWebhookがトリガーされるイベント名の配列", "items": { "title": "Webhookトリガー", "example": "FILE.UPLOADED", "type": "string", "description": "このWebhookをトリガーしたイベント名", "enum": [ "FILE.UPLOADED", "FILE.PREVIEWED", "FILE.DOWNLOADED", "FILE.TRASHED", "FILE.DELETED", "FILE.RESTORED", "FILE.COPIED", "FILE.MOVED", "FILE.LOCKED", "FILE.UNLOCKED", "FILE.RENAMED", "COMMENT.CREATED", "COMMENT.UPDATED", "COMMENT.DELETED", "TASK_ASSIGNMENT.CREATED", "TASK_ASSIGNMENT.UPDATED", "METADATA_INSTANCE.CREATED", "METADATA_INSTANCE.UPDATED", "METADATA_INSTANCE.DELETED", "FOLDER.CREATED", "FOLDER.RENAMED", "FOLDER.DOWNLOADED", "FOLDER.RESTORED", "FOLDER.DELETED", "FOLDER.COPIED", "FOLDER.MOVED", "FOLDER.TRASHED", "WEBHOOK.DELETED", "COLLABORATION.CREATED", "COLLABORATION.ACCEPTED", "COLLABORATION.REJECTED", "COLLABORATION.REMOVED", "COLLABORATION.UPDATED", "SHARED_LINK.DELETED", "SHARED_LINK.CREATED", "SHARED_LINK.UPDATED", "SIGN_REQUEST.COMPLETED", "SIGN_REQUEST.DECLINED", "SIGN_REQUEST.EXPIRED", "SIGN_REQUEST.SIGNER_EMAIL_BOUNCED" ] } } } } ] }, "Webhook--Mini": { "title": "Webhook (Mini)", "type": "object", "x-box-resource-id": "webhook--mini", "x-box-tag": "webhooks", "x-box-variants": [ "mini", "standard" ], "x-box-variant": "mini", "description": "設定されたWebhookを表します。", "properties": { "id": { "type": "string", "description": "このWebhookの一意の識別子。", "example": "11446498" }, "type": { "type": "string", "description": "`webhook`", "example": "webhook", "enum": [ "webhook" ] }, "target": { "type": "object", "description": "Webhookをトリガーする項目", "properties": { "id": { "description": "Webhookをトリガーする項目のID", "type": "string", "example": "1231232" }, "type": { "description": "Webhookをトリガーする項目のタイプ", "type": "string", "example": "file", "enum": [ "file", "folder" ] } } } } }, "Webhooks": { "title": "Webhooks", "type": "object", "x-box-resource-id": "webhooks", "x-box-tag": "webhooks", "description": "Webhookのリスト。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "Webhookのリスト", "items": { "$ref": "#/components/schemas/Webhook--Mini" } } } } ] }, "WebLink": { "title": "ウェブリンク", "type": "object", "x-box-resource-id": "web_link", "x-box-variant": "standard", "description": "ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。\n\nウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。", "allOf": [ { "$ref": "#/components/schemas/WebLink--Mini" }, { "properties": { "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "ウェブリンクが属する親オブジェクト" } ] }, "description": { "type": "string", "example": "Example page", "description": "ウェブリンクに付加される説明。この説明は、Boxウェブアプリケーション内に表示されます。" }, "path_collection": { "allOf": [ { "title": "パスのコレクション", "description": "項目の親フォルダのリスト。", "type": "object", "required": [ "total_count", "entries" ], "properties": { "total_count": { "description": "このリスト内のフォルダの数。", "example": 1, "type": "integer", "format": "int64", "nullable": false }, "entries": { "type": "array", "description": "この項目の親フォルダ", "nullable": false, "items": { "$ref": "#/components/schemas/Folder--Mini" } } } }, { "description": "ルートフォルダを起点にした、このウェブリンクを含むフォルダツリー。" }, { "nullable": false } ] }, "created_at": { "type": "string", "format": "date-time", "description": "このファイルがBoxのサーバー上に作成された日時。", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "このファイルがBoxサーバー上で最後に更新された日時。", "example": "2012-12-12T10:53:43-08:00" }, "trashed_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルがごみ箱に移動された日時。", "example": "2012-12-12T10:53:43-08:00" }, "purged_at": { "type": "string", "format": "date-time", "nullable": true, "description": "このファイルが完全に削除される日時。", "example": "2012-12-12T10:53:43-08:00" }, "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上のファイルやフォルダに対する読み取り専用アクセスを直接実行できます。\n\nアクセスレベルがopenに設定されている共有リンクの場合は、URLを知っているすべてのユーザーが項目にアクセスでき、アクセスレベルがcompanyまたはcollaboratorsに設定されている共有リンクの場合は、適切に認証されたBoxユーザーのみが項目にアクセスできます。", "type": "object", "required": [ "url", "accessed", "effective_access", "effective_permission", "is_password_enabled", "download_count", "preview_count" ], "properties": { "url": { "type": "string", "format": "url", "description": "Box上の項目にアクセスするために使用できるURL。\n\nこのURLに移動すると、BoxのプレビューUIに項目が表示され、許可されている場合は、このUIからファイルをダウンロードできます。\n\nこのURLは、この共有リンクに対してカスタムの`vanity_url`が 設定されている場合でも動作します。", "example": "https://www.box.com/s/vspke7y05sb214wjokpk", "nullable": false }, "download_url": { "type": "string", "format": "url", "x-box-premium-feature": true, "description": "ファイルをダウンロードするために使用できるURL。このURLをブラウザで使用すると、ファイルをダウンロードできます。このURLには、ファイルを正しいファイルタイプで保存できるように、ファイル拡張子が含まれます。\n\nフォルダの場合、このプロパティは`null`になります。", "example": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg", "nullable": true }, "vanity_url": { "type": "string", "format": "url", "description": "Boxで項目をプレビューする目的にも使用できる「カスタムURL」。カスタムURLの作成と変更は、Boxウェブアプリケーションでのみ行えます。", "example": "https://acme.app.box.com/v/my_url/", "nullable": true }, "vanity_name": { "type": "string", "description": "`vanity_url`フィールドで使用される、共有リンクのカスタム名。", "example": "my_url", "nullable": true }, "access": { "type": "string", "description": "この共有リンクのアクセスレベル\n\n* `open` - このリンクを知っている全員にこの項目へのアクセスを許可します\n* `company` - 同じ会社のユーザーにのみこの項目へのアクセスを許可します\n* `collaborators` - この項目のコラボレータとなっているユーザーに対してのみこの項目へのアクセスを許可します\n\n共有リンクの作成時にこのフィールドを省略した場合は、Enterprise管理者によって指定されたデフォルトのアクセスレベルに設定されます。", "enum": [ "open", "company", "collaborators" ], "example": "open", "nullable": false }, "effective_access": { "type": "string", "description": "共有リンクの実際のアクセスレベル。許可されるアクセスレベルが会社の設定で制限されている場合は、`access`フィールドの値よりも低いアクセスレベルになることがあります。", "enum": [ "open", "company", "collaborators" ], "example": "company", "nullable": false }, "effective_permission": { "type": "string", "description": "この共有リンクの実際の権限。これらにより、共有リンクの権限と、管理者、所有者、任意の先祖項目 (フォルダなど) によって設定される項目の権限の組み合わせの制限が厳しくなります。", "enum": [ "can_edit", "can_download", "can_preview", "no_access" ], "example": "can_download", "nullable": false }, "unshared_at": { "type": "string", "format": "date-time", "description": "このリンクが共有解除される日時。このフィールドを設定できるのは、有料アカウントを持つユーザーのみです。", "example": "2018-04-13T13:53:23-07:00", "nullable": true }, "is_password_enabled": { "type": "boolean", "description": "共有リンクを通じて項目にアクセスする際にパスワードを要求するかどうかを定義します。", "example": true, "nullable": false }, "permissions": { "type": "object", "description": "このリンクを通じてユーザーが項目のプレビュー、編集、およびダウンロードを行うことを許可するかどうかを定義します。これらの権限は、共有リンクのみに適用され、その項目自体に適用される権限より優先されることはありません。", "required": [ "can_download", "can_preview", "can_edit" ], "properties": { "can_download": { "type": "boolean", "example": true, "nullable": false, "description": "共有リンクを通じて項目をダウンロードすることを許可するかどうかを定義します。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。\n\n実際のアクセスレベルが`collaborators`ではなく、`open`または`company`に設定されている場合は、この値を`true`に設定できます。" }, "can_preview": { "type": "boolean", "example": true, "nullable": false, "description": "共有リンクを通じて項目をプレビューすることを許可するかどうかを定義します。\n\nこの値は常に`true`です。フォルダの共有リンクの場合、この設定はフォルダ内のすべての項目にも適用されます。" }, "can_edit": { "type": "boolean", "example": false, "nullable": false, "description": "共有リンクからの項目の編集を許可するかどうかを定義します。\n\n`can_download`が`true`で、項目のタイプが`file`の場合のみ、この値も`true`に設定できます。" } } }, "download_count": { "type": "integer", "example": 3, "description": "この項目がダウンロードされた回数。", "nullable": false }, "preview_count": { "type": "integer", "example": 3, "description": "この項目がプレビューされた回数。", "nullable": false } } }, { "description": "この項目の共有リンクオブジェクト。共有リンクがまだ作成されていない場合は、`null`になります。" }, { "nullable": true } ] }, "item_status": { "type": "string", "example": "active", "enum": [ "active", "trashed", "deleted" ], "description": "この項目が削除されたかどうか。値には、`active`、`trashed` (ファイルがごみ箱に移動された場合)、`deleted` (ファイルが完全に削除された場合) があります。" } } } ] }, "WebLink--Base": { "title": "ウェブリンク (Base)", "type": "object", "x-box-resource-id": "web_link--base", "x-box-tag": "web_links", "x-box-variants": [ "base", "mini", "standard" ], "x-box-variant": "base", "description": "ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。\n\nウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。", "required": [ "id", "type" ], "properties": { "id": { "type": "string", "description": "このウェブリンクの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`web_link`", "example": "web_link", "enum": [ "web_link" ] }, "etag": { "type": "string", "example": "1", "description": "このウェブリンクのエンティティタグ。`If-Match`ヘッダーで使用します。" } } }, "WebLink--Mini": { "title": "ウェブリンク (Mini)", "type": "object", "x-box-resource-id": "web_link--mini", "x-box-variant": "mini", "description": "ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。\n\nウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。", "allOf": [ { "$ref": "#/components/schemas/WebLink--Base" }, { "properties": { "url": { "type": "string", "example": "https://www.example.com/example/1234", "description": "このウェブリンクが指すURL" }, "sequence_id": { "allOf": [ { "type": "string", "example": "3", "nullable": true, "description": "この項目に適用された最新のUser Eventを表す数値の識別子。\n\nこれを`GET /events`エンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。\n\nたとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventの`sequence_id`が最初に取得されたリソースの`sequence_id`よりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。" }, { "nullable": false } ] }, "name": { "type": "string", "description": "ウェブリンクの名前", "example": "My Bookmark" } } } ] }, "Workflow": { "title": "Workflow", "type": "object", "x-box-resource-id": "workflow", "x-box-variant": "standard", "description": "Box Relayワークフローは、名前が付けられたフローのコレクションを表すオブジェクトです。\n\nアプリケーションは、このリソースを使用するために、開発者コンソールでの`Manage Box Relay`アプリケーションスコープの使用が承認されている必要があります。", "allOf": [ { "$ref": "#/components/schemas/Workflow--Mini" }, { "properties": { "flows": { "type": "array", "description": "ワークフローに割り当てられているフローのリスト。", "items": { "type": "object", "description": "Box Relayワークフロー内のステップ。各フローには、`Trigger`のほか、`Trigger`の条件が満たされた場合に実行する結果のコレクションが含まれています", "properties": { "id": { "type": "string", "description": "フローのID", "example": "12345" }, "type": { "type": "string", "description": "フローのリソースの種類", "example": "flow", "enum": [ "flow" ] }, "trigger": { "allOf": [ { "type": "object", "properties": { "type": { "type": "string", "description": "トリガーのリソースの種類", "example": "trigger", "enum": [ "trigger" ] }, "trigger_type": { "type": "string", "description": "このフローに選択されているトリガーのタイプ", "example": "WORKFLOW_MANUAL_START", "enum": [ "WORKFLOW_MANUAL_START" ] }, "scope": { "type": "array", "description": "トリガースコープのリスト", "items": { "type": "object", "description": "トリガーの条件が満たされる場所と方法を説明するオブジェクト", "properties": { "type": { "type": "string", "description": "トリガースコープのリソースの種類", "example": "trigger_scope", "enum": [ "trigger_scope" ] }, "ref": { "type": "string", "description": "確認する条件値のパスを示します", "example": "/event/source/parameters/folder" }, "object": { "type": "object", "description": "`ref`が指すオブジェクト", "properties": { "type": { "type": "string", "description": "オブジェクトのタイプ", "example": "folder", "enum": [ "folder" ] }, "id": { "type": "string", "description": "オブジェクトのID", "example": "12345" } } } } } } } }, { "description": "フローを開始するトリガー" } ] }, "outcomes": { "allOf": [ { "type": "array", "items": { "type": "object", "description": "トリガーの条件が満たされた場合に実行する結果のリスト。", "properties": { "id": { "type": "string", "description": "結果のID", "example": "12345" }, "type": { "type": "string", "description": "結果のリソースの種類", "example": "outcome", "enum": [ "outcome" ] }, "name": { "type": "string", "description": "結果の名前", "example": "Task Approval Outcome" }, "action_type": { "allOf": [ { "title": "操作の種類", "example": "assign_task", "type": "string", "description": "結果の種類", "enum": [ "add_metadata", "assign_task", "copy_file", "copy_folder", "create_folder", "delete_file", "delete_folder", "lock_file", "move_file", "move_folder", "remove_watermark_file", "rename_folder", "restore_folder", "share_file", "share_folder", "unlock_file", "upload_file", "wait_for_task", "watermark_file", "go_back_to_step", "apply_file_classification", "apply_folder_classification", "send_notification" ] }, { "description": "結果の種類" } ] }, "if_rejected": { "type": "array", "description": "`action_type`が`assign_task`の場合にタスクが拒否されると、完了すべき結果のリストが返されます", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "結果のID", "example": "12345" }, "type": { "type": "string", "description": "結果のリソースの種類", "example": "outcome", "enum": [ "outcome" ] }, "name": { "type": "string", "description": "結果の名前", "example": "Approval Rejection Outcome" }, "action_type": { "allOf": [ { "title": "操作の種類", "example": "assign_task", "type": "string", "description": "結果の種類", "enum": [ "add_metadata", "assign_task", "copy_file", "copy_folder", "create_folder", "delete_file", "delete_folder", "lock_file", "move_file", "move_folder", "remove_watermark_file", "rename_folder", "restore_folder", "share_file", "share_folder", "unlock_file", "upload_file", "wait_for_task", "watermark_file", "go_back_to_step", "apply_file_classification", "apply_folder_classification", "send_notification" ] }, { "description": "結果の種類" } ] } } } } } } }, { "description": "フローがトリガーされたら完了する操作" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "このフローが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このフローを作成したユーザー" } ] } } } } } } ] }, "Workflow--Full": { "title": "ワークフロー (Full)", "type": "object", "x-box-resource-id": "workflow--full", "x-box-variant": "full", "description": "Box Relayワークフローは、名前が付けられたフローのコレクションを表すオブジェクトです。\n\nアプリケーションは、このリソースを使用するために、開発者コンソールでの`Manage Box Relay`アプリケーションスコープの使用が承認されている必要があります。", "allOf": [ { "$ref": "#/components/schemas/Workflow" }, { "properties": { "created_at": { "type": "string", "format": "date-time", "description": "Boxでこのワークフローが作成された日時", "example": "2012-12-12T10:53:43-08:00" }, "modified_at": { "type": "string", "format": "date-time", "description": "Boxでこのワークフローが最後に更新された日時", "example": "2012-12-12T10:53:43-08:00" }, "created_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このワークフローを作成したユーザー" } ] }, "modified_by": { "allOf": [ { "$ref": "#/components/schemas/User--Base" }, { "description": "このワークフローを最後に変更したユーザー" } ] } } } ] }, "Workflow--Mini": { "title": "ワークフロー (Mini)", "type": "object", "x-box-resource-id": "workflow--mini", "x-box-tag": "workflows", "x-box-variants": [ "mini", "standard", "full" ], "x-box-variant": "mini", "description": "Box Relayワークフローは、名前が付けられたフローのコレクションを表すオブジェクトです。\n\nアプリケーションは、このリソースを使用するために、開発者コンソールでの`Manage Box Relay`アプリケーションスコープの使用が承認されている必要があります。", "properties": { "id": { "type": "string", "description": "ワークフローの一意の識別子", "example": "11446498" }, "type": { "type": "string", "description": "`workflow`", "example": "workflow", "enum": [ "workflow" ] }, "name": { "type": "string", "example": "New Hire Workflow", "description": "ワークフローの名前" }, "description": { "type": "string", "description": "ワークフローの説明", "example": "This workflow sets off a new hire approval flow" }, "is_enabled": { "type": "boolean", "example": true, "description": "このワークフローが有効かどうかを指定します" } } }, "Workflows": { "title": "ワークフロー (リスト)", "type": "object", "x-box-resource-id": "workflows", "x-box-tag": "workflows", "description": "ワークフローのリスト。\n\nアプリケーションは、このリソースを使用するために、開発者コンソールでの`Manage Box Relay`アプリケーションスコープの使用が承認されている必要があります。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true }, "prev_marker": { "description": "前の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "ワークフローのリスト", "items": { "$ref": "#/components/schemas/Workflow" } } } } ] }, "ZipDownload": { "title": "zipダウンロード", "type": "object", "x-box-resource-id": "zip_download", "x-box-tag": "zip_downloads", "x-box-reference-category": "zip_downloads", "description": "ファイルやフォルダのリストの`zip`アーカイブを作成するリクエストが成功したことを表します。", "example": { "download_url": "https://dl.boxcloud.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/content", "status_url": "https://api.box.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/status", "expires_at": "2020-07-22T11:26:08Z", "name_conflicts": [ [ { "id": "12345", "type": "file", "original_name": "Report.pdf", "download_name": "3aa6a7.pdf" }, { "id": "34325", "type": "file", "original_name": "Report.pdf", "download_name": "5d53f2.pdf" } ] ] }, "properties": { "download_url": { "type": "string", "description": "`zip`アーカイブのダウンロードに使用できるURL。このURLに対する`Get`リクエストにより、リクエストされた項目のストリーミングが開始されます。デフォルトでは、このURLは、ダウンロードが開始されない限り、`expires_at`の時間までの数秒間だけ有効です。ダウンロードが開始されると、ダウンロードしている間は有効です。\n\nこのURLのドメインとパスは、APIコール間で変更される可能性があるため、このURLをそのまま使用することが重要です。", "example": "https://dl.boxcloud.com/2.0/zip_downloads/Lu6fA9Ob-jyysp3AAvMF4AkLEwZwAYbL=tgj2zIC=eK9RvJnJbjJl9rNh2qBgHDpyOCAOhpM=vajg2mKq8Mdd/content" }, "status_url": { "type": "string", "description": "ダウンロード中の`zip`アーカイブのステータスを取得するために使用できるURL。このURLに対する`Get`リクエストにより、アーカイブ内のファイル数に加え、すでにダウンロードまたはスキップされた項目の数が返されます。デフォルトでは、このURLは、ダウンロードが開始されない限り、`expires_at`の時間までの数秒間だけ有効です。ダウンロードの開始後、このURLは12時間有効です。\n\nこのURLのドメインとパスは、APIコール間で変更される可能性があるため、このURLをそのまま使用することが重要です。", "example": "https://api.box.com/2.0/zip_downloads/Lu6fA9Ob-jyysp3AAvMF4AkLEwZwAYbL=tgj2zIC=eK9RvJnJbjJl9rNh2qBgHDpyOCAOhpM=vajg2mKq8Mdd/status" }, "expires_at": { "type": "string", "format": "date-time", "description": "このアーカイブの有効期限が切れる日時。この日時を経過すると、`status_url`と`download_url`によってエラーが返されます。\n\nデフォルトでは、このURLは、ダウンロードが開始されない限り、`download_url`の時間までの数秒間だけ有効です。ダウンロードが開始されると、ダウンロードしている間は有効です。また、`status_url`の有効期間は、ダウンロードを開始してから12時間です。", "example": "2019-08-29T23:59:00-07:00" }, "name_conflicts": { "type": "array", "description": "アーカイブを作成しようとしたときに発生した競合のリスト。これは、複数の項目が同じ名前でリクエストされたときに発生します。\n\nこれらの競合を解決するために、APIでは、自動的に項目の名前を変更し、項目の元の名前と新しい名前の間のマッピングを返します。\n\n競合ごとに、両方のファイル名が変更されるため、このリストは常に2の倍数になります。", "items": { "type": "array", "description": "アーカイブを作成しようとしたときに発生した個々の競合。これには、2個のオブジェクトからなる配列が含まれています。各オブジェクトには、名前が競合したファイルまたはフォルダの元の名前と変更後のファイル名が格納されています。", "items": { "type": "object", "description": "競合が発生したファイルまたはフォルダ。このオブジェクトにより、元の項目のタイプと識別子に加えて、項目の元の名前とアーカイブで表示される新しい名前の間のマッピングが提供されます。", "properties": { "id": { "type": "string", "description": "項目の識別子", "example": "12345" }, "type": { "type": "string", "description": "この項目のタイプ", "example": "file", "enum": [ "file", "folder" ] }, "original_name": { "type": "string", "description": "この項目の元の名前", "example": "Report.pdf" }, "download_name": { "type": "string", "description": "ダウンロードされた`zip`アーカイブで表示される項目の新しい名前。", "example": "3aa6a7.pdf" } } } } } } }, "ZipDownloadStatus": { "title": "zipダウンロードのステータス", "type": "object", "x-box-resource-id": "zip_download_status", "x-box-tag": "zip_downloads", "x-box-reference-category": "zip_downloads", "description": "ダウンロード中の`zip`アーカイブのステータス。", "properties": { "total_file_count": { "type": "integer", "description": "このアーカイブ内のファイルの合計数。", "example": 20, "minimum": 0, "maximum": 10000 }, "downloaded_file_count": { "type": "integer", "description": "すでにダウンロードされているファイルの数。", "example": 10, "minimum": 0 }, "skipped_file_count": { "type": "integer", "description": "ダウンロードできなかったためスキップされたファイルの数。多くの場合、この原因は、アーカイブに対するリクエストの作成と、ダウンロードされるアーカイブとの間に発生した権限に関する問題です。", "example": 5, "minimum": 0 }, "skipped_folder_count": { "type": "integer", "description": "ダウンロードできなかったためスキップされたフォルダの数。多くの場合、この原因は、アーカイブに対するリクエストの作成と、ダウンロードされるアーカイブとの間に発生した権限に関する問題です。", "example": 5, "minimum": 0 }, "state": { "type": "string", "description": "ダウンロード中のアーカイブの状態。", "default": "in_progress", "example": "succeeded", "enum": [ "in_progress", "failed", "succeeded" ] } } }, "SignRequest--Base": { "title": "署名リクエスト (Base)", "type": "object", "x-box-resource-id": "sign_request--base", "x-box-tag": "sign_requests", "x-box-variants": [ "standard", "base" ], "x-box-variant": "base", "description": "署名リクエストオブジェクトを作成するリクエスト", "properties": { "is_document_preparation_needed": { "type": "boolean", "description": "UIを使用してドキュメントの準備を完了するために送信者がレスポンスで`prepare_url`を受け取る必要があるかどうかを示します。", "example": true }, "redirect_url": { "type": "string", "example": "https://www.example.com", "description": "指定した場合、ドキュメントに署名された時点で、署名リクエストがこのURLにリダイレクトされます。", "nullable": true }, "declined_redirect_url": { "type": "string", "example": "https://declined-redirect.com", "description": "署名者がドキュメントへの署名を拒否した後にリダイレクトされるURI。", "nullable": true }, "are_text_signatures_enabled": { "type": "boolean", "description": "(テキストの) 入力で生成された署名の使用を無効にします。", "example": true, "default": true }, "email_subject": { "type": "string", "example": "Sign Request from Acme", "description": "署名リクエストメールの件名。これは、署名リクエストによって消去されます。このフィールドを渡さない場合は、デフォルトの件名が使用されます。", "nullable": true }, "email_message": { "type": "string", "example": "Hello! Please sign the document below", "description": "署名リクエストメールに含めるメッセージ。このフィールドは、特定の文字のサニタイズによって消去されます。ただし、一部のHTMLタグは使用できます。また、このメッセージに含まれているリンクはメールではハイパーリンクに変換されます。このメッセージには、HTMLタグ`a`、`abbr`、`acronym`、`b`、`blockquote`、`code`、`em`、`i`、`ul`、`li`、`ol`、`strong`を含めることができます。HTMLに対するテキストの比率が大きすぎると、メールがスパムフィルタに入る可能性があることに注意してください。これらのタグにカスタムスタイルを適用することはできません。このフィールドを渡さない場合は、デフォルトのメッセージが使用されます。", "nullable": true }, "are_reminders_enabled": { "type": "boolean", "description": "3、8、13、18日目にドキュメントに署名するよう署名者に促します。リマインダは未署名の署名者にのみ送信されます。", "example": true }, "name": { "type": "string", "example": "name", "description": "署名リクエストの名前。" }, "prefill_tags": { "type": "array", "items": { "$ref": "#/components/schemas/SignRequestPrefillTag" }, "description": "署名に関連するタグがドキュメントのコンテンツに含まれている場合、この`prefill_tags`を使用してタグを事前入力できます。その際、タグの「id」を事前入力タグの`external_id`フィールドとして参照します。" }, "days_valid": { "type": "integer", "description": "作成した署名リクエストが完了しなかった場合に自動的に期限切れになるまでの日数を設定します。デフォルトでは、署名リクエストに有効期限を適用しないため、署名リクエストは期限切れになりません。", "minimum": 0, "maximum": 730, "example": 2, "nullable": true }, "external_id": { "type": "string", "description": "これは、署名リクエストが関連する外部システムのIDを参照する際に使用できます。", "example": "123", "nullable": true }, "is_phone_verification_required_to_view": { "type": "boolean", "description": "ドキュメントを表示する前にテキストメッセージを確認するよう署名者に強制します。この設定を署名者に適用するには、署名者の電話番号を指定する必要があります。", "example": true, "nullable": true }, "template_id": { "type": "string", "example": "123075213-af2c8822-3ef2-4952-8557-52d69c2fe9cb", "description": "署名リクエストがテンプレートから作成された場合、このフィールドはそのテンプレートのIDを示します。", "nullable": true } } }, "SignRequest": { "title": "署名リクエスト", "type": "object", "x-box-resource-id": "sign_request", "x-box-tag": "sign_requests", "x-box-variants": [ "standard", "base" ], "x-box-variant": "standard", "description": "署名リクエストオブジェクト", "allOf": [ { "$ref": "#/components/schemas/SignRequest--Base" }, { "properties": { "type": { "type": "string", "example": "sign-request", "enum": [ "sign-request" ], "description": "オブジェクトタイプ" }, "source_files": { "type": "array", "items": { "$ref": "#/components/schemas/File--Base" }, "description": "署名するドキュメントの作成元ファイルのリスト。現在は、10ファイルに制限されています。ファイルごとにIDフィールドとtypeフィールドのみが必要です。" }, "signers": { "type": "array", "items": { "$ref": "#/components/schemas/SignRequestSigner" }, "description": "署名リクエストの署名者の配列" }, "signature_color": { "type": "string", "example": "blue", "description": "署名に特定の色 (青、黒、または赤) を強制します。", "nullable": true }, "id": { "type": "string", "example": "12345", "description": "署名リクエストID" }, "prepare_url": { "type": "string", "example": "https://prepareurl.com", "description": "このURLは、リクエストで`is_document_preparation_needed`が`true`に設定されている場合に返されます。これは、UIで署名リクエストを準備する際に使用されます。署名リクエストは、準備が完了するまで送信されません。", "nullable": true }, "signing_log": { "allOf": [ { "$ref": "#/components/schemas/File--Mini" }, { "description": "リクエストに対する署名者のアクティビティがすべて記録されているファイルへの参照" } ] }, "status": { "type": "string", "enum": [ "converting", "created", "sent", "viewed", "signed", "cancelled", "declined", "error_converting", "error_sending", "expired", "finalizing", "error_finalizing" ], "example": "converting", "description": "署名リクエストのステータスを説明します" }, "sign_files": { "type": "object", "properties": { "files": { "type": "array", "items": { "$ref": "#/components/schemas/File--Mini" } }, "is_ready_for_download": { "type": "boolean", "example": true, "description": "`sign_files`のドキュメントが処理中で、PDFが古くなっている可能性があるかどうかを示します。任意のドキュメントを変更するには、すべての`sign_files`で処理が必要になります。処理が終了するまで (およびこの値がtrueになるまで) 待ってからPDFをダウンロードすることをお勧めします。" } }, "description": "署名されるファイル (元のソースファイルのコピー) のリスト。署名者が署名すると、これらのファイルの新しいバージョンが作成され、署名プロセスのどの時点でもダウンロードできます。" }, "auto_expire_at": { "type": "string", "format": "date-time", "example": "2021-04-26T08:12:13.982Z", "description": "`days_valid`を使用すると、未署名の場合に署名リクエストの有効期限となる日時 (GMT) が計算されます。", "nullable": true }, "parent_folder": { "nullable": false, "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "最終的な署名済みドキュメントと署名ログの保存先フォルダ。\n\n署名リクエストの作成時にこの値が渡されなかった場合は、デフォルトのフォルダを使用することになります。デフォルトのフォルダは、ペイロードの最初のソースファイルの親フォルダ (そのフォルダへのアップロード権限がある場合) または「My Sign Requests」という名前のフォルダになります。" } ] } } } ] }, "SignRequests": { "title": "Box Sign", "type": "object", "x-box-resource-id": "sign_requests", "x-box-tag": "sign_requests", "description": "任意のBox Sign APIエンドポイントからデフォルトで返される署名リクエストのStandard版の表示。", "allOf": [ { "type": "object", "description": "マーカーベースのページ割りについて説明しているAPIレスポンスの部分", "properties": { "limit": { "description": "これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータの`limit`と等しくなります。最大値はAPIによって異なります。", "example": 1000, "type": "integer", "format": "int64" }, "next_marker": { "description": "次の検索結果ページの開始場所のマーカー。", "example": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii", "type": "string", "nullable": true } } }, { "properties": { "entries": { "type": "array", "description": "署名リクエストのリスト", "items": { "$ref": "#/components/schemas/SignRequest" } } } } ] }, "CompletionRuleVariable": { "title": "完了ルール変数", "type": "object", "description": "完了ルールオブジェクト。操作をすべての担当者が完了する必要があるか、一人でも完了すればよいかを決定します。", "required": [ "type", "variable_type", "variable_value" ], "properties": { "type": { "type": "string", "enum": [ "variable" ], "description": "完了ルールオブジェクトタイプ。", "example": "variable" }, "variable_type": { "type": "string", "description": "完了ルールオブジェクトの変数タイプ。", "example": "task_completion_rule", "enum": [ "task_completion_rule" ] }, "variable_value": { "type": "string", "description": "完了ルールの変数値。", "example": "all_assignees", "enum": [ "all_assignees", "any_assignees" ] } } }, "CollaboratorVariable": { "title": "コラボレータ変数", "type": "object", "description": "コラボレータオブジェクト。ワークフローの結果の影響を受けるユーザーIDのリストを指定できます。", "required": [ "type", "variable_type", "variable_value" ], "properties": { "type": { "type": "string", "enum": [ "variable" ], "description": "コラボレータオブジェクトタイプ。", "example": "variable" }, "variable_type": { "type": "string", "description": "コラボレータオブジェクトの変数タイプ。", "example": "user_list", "enum": [ "user_list" ] }, "variable_value": { "type": "array", "description": "ユーザーIDのリスト。", "items": { "type": "object", "required": [ "type", "id" ], "description": "ワークフローの結果で使用されるユーザー変数。", "properties": { "type": { "type": "string", "enum": [ "user" ], "description": "オブジェクトタイプ。", "example": "user" }, "id": { "type": "string", "description": "ユーザーのID。", "example": "636281" } } } } } }, "FileOrFolderScope": { "title": "ファイルまたはフォルダのスコープ", "type": "object", "description": "リソース (ファイルまたはフォルダ) とそのリソースにアクセスできるスコープの関係", "properties": { "scope": { "type": "string", "description": "リソースへのアクセスのスコープ", "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" ] }, "object": { "allOf": [ { "oneOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "$ref": "#/components/schemas/File--Mini" } ] }, { "description": "ファイルまたはフォルダのリソース" } ] } } }, "EventSource": { "title": "イベントソース", "type": "object", "x-box-resource-id": "event_source", "description": "イベントストリーム内のイベントを開始させるソースファイルまたはフォルダ。", "required": [ "item_type", "item_id", "item_name" ], "properties": { "item_type": { "type": "string", "nullable": false, "enum": [ "file", "folder" ], "description": "イベントを表す項目の種類。`file`または`folder`になります。", "example": "file" }, "item_id": { "type": "string", "nullable": false, "description": "項目を表す一意の識別子。", "example": "560284318361" }, "item_name": { "type": "string", "nullable": false, "description": "項目の名前。", "example": "report.pdf" }, "classification": { "type": "object", "description": "イベントをトリガーした項目の分類情報を格納しているオブジェクト。項目に分類が設定されていない場合、このフィールドは表示されません。", "properties": { "name": { "type": "string", "description": "分類の名前", "example": "Top Secret" } } }, "parent": { "allOf": [ { "$ref": "#/components/schemas/Folder--Mini" }, { "description": "このフォルダが配置されているフォルダ (省略可)\n\nルートフォルダやごみ箱フォルダなど、一部のフォルダの場合、この値は`null`になることがあります。" } ], "nullable": true }, "owned_by": { "allOf": [ { "$ref": "#/components/schemas/User--Mini" }, { "description": "この項目を所有するユーザー" }, { "nullable": false } ] } } }, "KeywordSkillCard": { "type": "object", "x-box-resource-id": "keyword_skill_card", "x-box-tag": "skills", "title": "キーワードスキルカード", "description": "一連のキーワードを含むスキルカード", "required": [ "type", "skill_card_type", "skill", "invocation", "entries" ], "properties": { "created_at": { "type": "string", "format": "date-time", "example": "2018-04-13T13:53:23-07:00", "description": "このカードの作成日時 (省略可)。" }, "type": { "type": "string", "description": "`skill_card`", "example": "skill_card", "enum": [ "skill_card" ] }, "skill_card_type": { "type": "string", "description": "`keyword`", "example": "keyword", "enum": [ "keyword" ] }, "skill_card_title": { "type": "object", "description": "カードのタイトル。", "required": [ "message" ], "properties": { "code": { "type": "string", "example": "labels", "description": "タイトルの識別子 (省略可)。" }, "message": { "type": "string", "example": "Labels", "description": "UI上で表示する実際のタイトル。" } } }, "skill": { "type": "object", "description": "このメタデータを適用したサービス。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "service", "description": "`service`", "enum": [ "service" ] }, "id": { "type": "string", "example": "image-recognition-service", "description": "このメタデータを適用したサービスを表すカスタム識別子。" } } }, "invocation": { "type": "object", "description": "このサービスの呼び出し。メタデータを適用したサービスのインスタンスを追跡するために使用されます。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "skill_invocation", "description": "`skill_invocation`", "enum": [ "skill_invocation" ] }, "id": { "type": "string", "example": "image-recognition-service-123", "description": "このメタデータを適用したサービスのインスタンスを表すカスタム識別子。たとえば、`image-recognition-service`が複数のノードで動作する場合、このフィールドを使用すると、メタデータの適用に使用されたノードのIDを識別できます。" } } }, "entries": { "type": "array", "description": "メタデータカード内のエントリのリスト。", "items": { "type": "object", "description": "メタデータカードの`entries`属性のエントリ", "properties": { "text": { "type": "string", "example": "keyword1", "description": "キーワードのテキスト。" } } } } } }, "IntegrationMappingSlackOptions": { "title": "Slackタイプ用の統合マッピングオプション", "type": "object", "description": "Slackタイプの統合マッピングオプションオブジェクトのスキーマ。", "properties": { "is_access_management_disabled": { "type": "boolean", "example": true, "description": "基になるBox項目に対するチャンネルメンバーのアクセスを自動で管理する必要があるかどうかを示します。チャンネルのタイプによっては、アクセスがコラボレーションまたは共有リンクの作成により管理されます。", "nullable": false } } }, "IntegrationMappingPartnerItemSlack": { "title": "Slackタイプの統合マッピングのマッピングされた項目スキーマ", "type": "object", "description": "Slackタイプの統合マッピングのマッピングされた項目オブジェクトのスキーマ。\n\nBox for Slackがオーガナイゼーションレベルとワークスペースレベルのどちらでインストールされているかに応じて、`slack_org_id`**または**`slack_workspace_id`の**いずれか**を指定します。両方のパラメータを同時に使用しないでください。", "properties": { "type": { "type": "string", "enum": [ "channel" ], "example": "channel", "description": "`id`で参照されるマッピングされた項目のタイプ", "nullable": false }, "id": { "type": "string", "example": "C12378991223", "description": "(`type`で参照されるタイプの) マッピングされた項目のID", "nullable": false }, "slack_workspace_id": { "type": "string", "example": "T12352314", "description": "項目が関連付けられているSlackワークスペースのID。このパラメータは、ワークスペースレベルでBox for Slackがインストールされている場合に使用します。`slack_org_id`を同時に使用しないでください。", "nullable": true }, "slack_org_id": { "type": "string", "example": "E1234567", "description": "項目が関連付けられているSlackオーガナイゼーションのID。このパラメータは、オーガナイゼーションレベルでBox for Slackがインストールされている場合に使用します。`slack_workspace_id`を同時に使用しないでください。", "nullable": true } }, "required": [ "id", "type" ] }, "IntegrationMappingBoxItemSlack": { "title": "Slackタイプの統合マッピングのBox項目スキーマ", "type": "object", "description": "Slackタイプの統合マッピングのBox項目オブジェクトのスキーマ", "properties": { "type": { "type": "string", "enum": [ "folder" ], "example": "folder", "description": "`id`で参照されるマッピングされた項目のタイプ", "nullable": false }, "id": { "type": "string", "example": "1234567891", "description": "(`type`で参照されるタイプの) マッピングされた項目のID", "nullable": false } }, "required": [ "id", "type" ] }, "Outcome": { "title": "結果", "type": "object", "description": "結果のインスタンス。", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "特定の結果のID", "example": "17363629" }, "collaborators": { "allOf": [ { "$ref": "#/components/schemas/CollaboratorVariable" }, { "description": "ワークフローの結果の影響を受けたコラボレータのリストを取得します。" } ] }, "completion_rule": { "allOf": [ { "$ref": "#/components/schemas/CompletionRuleVariable" }, { "description": "操作をすべての担当者が完了する必要があるか、一人でも完了すればよいかを決定します。" } ] }, "file_collaborator_role": { "allOf": [ { "$ref": "#/components/schemas/RoleVariable" }, { "description": "特定のコラボレータの役割がファイルに関するワークフローの結果の影響を受けるかどうかを決定します。" } ] }, "task_collaborators": { "allOf": [ { "$ref": "#/components/schemas/CollaboratorVariable" }, { "description": "タスクのワークフローの結果の影響を受けたコラボレータのリストを取得します。" } ] }, "role": { "allOf": [ { "$ref": "#/components/schemas/RoleVariable" }, { "description": "特定のコラボレータの役割がワークフローの結果の影響を受けるかどうかを決定します。" } ] } } }, "RoleVariable": { "title": "役割変数", "type": "object", "description": "特定のコラボレータの役割がワークフローの結果の影響を受けるかどうかを決定します。", "required": [ "type", "variable_type", "variable_value" ], "properties": { "type": { "type": "string", "enum": [ "variable" ], "description": "役割オブジェクトタイプ。", "example": "variable" }, "variable_type": { "type": "string", "description": "オブジェクトで使用される変数タイプ。", "example": "collaborator_role", "enum": [ "collaborator_role" ] }, "variable_value": { "allOf": [ { "type": "string", "description": "付与されるアクセスレベル。", "example": "editor", "enum": [ "editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner" ] }, { "description": "役割パラメータに使用できる変数値。" } ] } } }, "TimelineSkillCard": { "type": "object", "x-box-resource-id": "timeline_skill_card", "x-box-tag": "skills", "title": "タイムラインスキルカード", "description": "タイムラインに画像のリストを配置するBox Skillメタデータカード。", "required": [ "type", "skill_card_type", "skill", "invocation", "entries" ], "properties": { "created_at": { "type": "string", "format": "date-time", "example": "2018-04-13T13:53:23-07:00", "description": "このカードの作成日時 (省略可)。" }, "type": { "type": "string", "description": "`skill_card`", "example": "skill_card", "enum": [ "skill_card" ] }, "skill_card_type": { "type": "string", "description": "`timeline`", "example": "timeline", "enum": [ "timeline" ] }, "skill_card_title": { "type": "object", "description": "カードのタイトル。", "required": [ "message" ], "properties": { "code": { "type": "string", "example": "Faces", "description": "タイトルの識別子 (省略可)。" }, "message": { "type": "string", "example": "Faces", "description": "UI上で表示する実際のタイトル。" } } }, "skill": { "type": "object", "description": "このメタデータを適用したサービス。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "service", "description": "`service`", "enum": [ "service" ] }, "id": { "type": "string", "example": "image-recognition-service", "description": "このメタデータを適用したサービスを表すカスタム識別子。" } } }, "invocation": { "type": "object", "description": "このサービスの呼び出し。メタデータを適用したサービスのインスタンスを追跡するために使用されます。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "skill_invocation", "description": "`skill_invocation`", "enum": [ "skill_invocation" ] }, "id": { "type": "string", "example": "image-recognition-service-123", "description": "このメタデータを適用したサービスのインスタンスを表すカスタム識別子。たとえば、`image-recognition-service`が複数のノードで動作する場合、このフィールドを使用すると、メタデータの適用に使用されたノードのIDを識別できます。" } } }, "duration": { "type": "integer", "example": 1000, "description": "タイムラインの総持続時間 (秒)。" }, "entries": { "type": "array", "description": "タイムライン上のエントリのリスト。", "items": { "type": "object", "description": "タイムライン上の複数の項目に配置される1つの項目。", "properties": { "text": { "type": "string", "example": "John", "description": "エントリのテキスト。これは、たとえば、ビデオで検出された人物の名前など、タイムラインに配置される項目の表示名になります。" }, "appears": { "type": "array", "description": "この項目がタイムラインに表示される日時を表すタイムスタンプのリストを定義します。", "required": [ "start", "end" ], "items": { "type": "object", "description": "エントリのタイムスタンプ。", "properties": { "start": { "type": "integer", "example": 1, "description": "エントリがタイムライン上に表示され始める時間 (秒)。" }, "end": { "type": "integer", "example": 20, "description": "エントリがタイムラインに表示されなくなる時間 (秒)。" } } } }, "image_url": { "type": "string", "description": "タイムラインに表示されるエントリを示す画像。この画像のURLはすべてのエントリに必要です。\n\nこの画像は項目 (顔など) のリストに表示されます。また、画像をクリックすると、このエントリの期間中にそのエントリが表示される位置がユーザーに示されます。", "example": "https://example.com/image1.jpg" } } } } } }, "TranscriptSkillCard": { "type": "object", "x-box-resource-id": "transcript_skill_card", "x-box-tag": "skills", "title": "トランスクリプトスキルカード", "description": "ファイルにトランスクリプトを追加するBox Skillメタデータカード。", "required": [ "type", "skill_card_type", "skill", "invocation", "entries" ], "properties": { "created_at": { "type": "string", "format": "date-time", "example": "2018-04-13T13:53:23-07:00", "description": "このカードの作成日時 (省略可)。" }, "type": { "type": "string", "description": "`skill_card`", "example": "skill_card", "enum": [ "skill_card" ] }, "skill_card_type": { "type": "string", "description": "`transcript`", "example": "transcript", "enum": [ "transcript" ] }, "skill_card_title": { "type": "object", "description": "カードのタイトル。", "required": [ "message" ], "properties": { "code": { "type": "string", "example": "my_transcripts", "description": "タイトルの識別子 (省略可)。" }, "message": { "type": "string", "example": "My Transcripts", "description": "UI上で表示する実際のタイトル。" } } }, "skill": { "type": "object", "description": "このメタデータを適用したサービス。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "service", "description": "`service`", "enum": [ "service" ] }, "id": { "type": "string", "example": "transciption-service", "description": "このメタデータを適用したサービスを表すカスタム識別子。" } } }, "invocation": { "type": "object", "description": "このサービスの呼び出し。メタデータを適用したサービスのインスタンスを追跡するために使用されます。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "skill_invocation", "description": "`skill_invocation`", "enum": [ "skill_invocation" ] }, "id": { "type": "string", "example": "transciption-service-123", "description": "このメタデータを適用したサービスのインスタンスを表すカスタム識別子。たとえば、`image-recognition-service`が複数のノードで動作する場合、このフィールドを使用すると、メタデータの適用に使用されたノードのIDを識別できます。" } } }, "duration": { "type": "integer", "example": 1000, "description": "総持続時間 (秒) (省略可)。\n\n`skill_card_type`が`transcript`または`timeline`の場合に使用されます。" }, "entries": { "type": "array", "description": "カードのエントリのリスト。これは、書き起こしの個々のエントリを表します。", "items": { "type": "object", "description": "メタデータカードの`entries`属性のエントリ", "properties": { "text": { "type": "string", "example": "Hi, and welcome to this video...", "description": "エントリのテキスト。これは、タイムライン上のエントリに割り当てられた書き起こしテキストになります。" }, "appears": { "type": "array", "description": "書き起こしテキストが表示される時刻を定義します。これに含まれるのは開始時刻のみで、終了時刻は含まれません。", "required": [ "start" ], "items": { "type": "object", "description": "エントリのタイムスタンプ。", "properties": { "start": { "type": "integer", "example": 1, "description": "エントリがタイムライン上に表示され始める時間 (秒)。" } } } } } } } } }, "StatusSkillCard": { "type": "object", "x-box-resource-id": "status_skill_card", "x-box-tag": "skills", "title": "ステータススキルカード", "description": "メタデータサイドバーにステータスメッセージを配置するBox Skillメタデータカード。", "required": [ "type", "skill_card_type", "skill", "invocation", "status" ], "properties": { "created_at": { "type": "string", "format": "date-time", "example": "2018-04-13T13:53:23-07:00", "description": "このカードの作成日時 (省略可)。" }, "type": { "type": "string", "description": "`skill_card`", "example": "skill_card", "enum": [ "skill_card" ] }, "skill_card_type": { "type": "string", "description": "`status`", "example": "status", "enum": [ "status" ] }, "skill_card_title": { "type": "object", "description": "カードのタイトル。", "required": [ "message" ], "properties": { "code": { "type": "string", "example": "status", "description": "タイトルの識別子 (省略可)。" }, "message": { "type": "string", "example": "Status", "description": "UI上で表示する実際のタイトル。" } } }, "status": { "type": "object", "description": "スキルのステータスを設定します。これは、スキルがデータを処理している間またはファイルを処理できなかった場合にユーザーにメッセージを表示するのに使用できます。", "required": [ "code" ], "properties": { "code": { "type": "string", "description": "このスキル呼び出しのステータスを表すコード。デフォルトでは、各コードには独自のメッセージが伴います。これらのメッセージを調整するには、このオブジェクトの`message`値を設定します。", "example": "success", "enum": [ "invoked", "processing", "success", "transient_failure", "permanent_failure" ] }, "message": { "type": "string", "description": "このステータスで提供できるカスタムメッセージ。ウェブアプリでエンドユーザーに表示されます。", "example": "We're preparing to process your file. Please hold on!" } } }, "skill": { "type": "object", "description": "このメタデータを適用したサービス。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "service", "description": "`service`", "enum": [ "service" ] }, "id": { "type": "string", "example": "image-recognition-service", "description": "このメタデータを適用したサービスを表すカスタム識別子。" } } }, "invocation": { "type": "object", "description": "このサービスの呼び出し。メタデータを適用したサービスのインスタンスを追跡するために使用されます。", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "example": "skill_invocation", "description": "`skill_invocation`", "enum": [ "skill_invocation" ] }, "id": { "type": "string", "example": "image-recognition-service-123", "description": "このメタデータを適用したサービスのインスタンスを表すカスタム識別子。たとえば、`image-recognition-service`が複数のノードで動作する場合、このフィールドを使用すると、メタデータの適用に使用されたノードのIDを識別できます。" } } } } }, "SignRequestCreateSigner": { "title": "署名リクエストを作成の署名者フィールド", "type": "object", "description": "署名リクエストを投稿のリクエスト本文内の署名者のスキーマ", "properties": { "email": { "type": "string", "description": "署名者のメールアドレス。メールアドレスが含まれるように構成されているテンプレートを使用する場合を除き、署名リクエストを作成する際は署名者のメールアドレスが必須です。", "example": "example@gmail.com", "nullable": true }, "role": { "type": "string", "enum": [ "signer", "approver", "final_copy_reader" ], "description": "署名リクエストに含まれる署名者のロールを定義します。`signer`はドキュメントに署名し、`approver`はドキュメントを承認する必要があります。最終的な署名済みドキュメントと署名ログを受け取るのは、`final_copy_reader`のみです。", "example": "signer", "default": "signer" }, "is_in_person": { "type": "boolean", "description": "送信者の埋め込みURLと組み合わせて使用されます。送信者が署名すると、その次の`in_person`署名者にリダイレクトされます。", "example": true }, "order": { "type": "integer", "description": "署名者の順序", "minimum": 0, "example": 2 }, "embed_url_external_user_id": { "type": "string", "description": "埋め込みURLへのアクセス時に認証を担当する、外部アプリケーションの署名者のユーザーID。", "example": "1234", "nullable": true }, "redirect_url": { "type": "string", "description": "署名者がドキュメントに署名した後にリダイレクトされるURL。このURLを定義すると、特定の署名者で、デフォルトまたはグローバルのリダイレクトURL設定より優先されます。拒否した場合のリダイレクトURLが指定されていない場合は、このURLが拒否の操作にも使用されます。", "example": "https://example.com", "nullable": true }, "declined_redirect_url": { "type": "string", "description": "署名者がドキュメントへの署名を拒否した後にリダイレクトされるURL。このURLを定義すると、特定の署名者で、デフォルトまたはグローバルのリダイレクトURL設定より優先されます。", "example": "https://declined-example.com", "nullable": true }, "login_required": { "type": "boolean", "description": "trueに設定した場合、署名者はリクエストに署名する前にBoxアカウントにログインする必要があります。署名者に既存のアカウントがない場合は、無料のBoxアカウントを作成できます。", "example": true, "nullable": true }, "verification_phone_number": { "type": "string", "description": "設定した場合は、2要素認証による署名者の認証にこの電話番号を使用しないと、署名者はドキュメントに署名できません。", "example": "6314578901", "nullable": true }, "password": { "type": "string", "writeOnly": true, "description": "設定した場合、署名者は、このパスワードを入力しないと、ドキュメントに署名できません。このフィールドは書き込み専用です。", "example": "SecretPassword123", "nullable": true }, "signer_group_id": { "type": "string", "description": "設定した場合、同じ値が設定されている署名者は、同じ入力および同じ署名者グループに割り当てられます。署名者グループはBoxグループではありません。これは、署名リクエストに属しているエンティティであり、この署名リクエスト内でのみ使用/アクセスできます。署名者グループには複数の署名者が含まれることが想定されています。指定された値が1人の署名者に対してのみ使用されている場合、この値は無視され、リクエストは、個別の署名者を対象としたものとして処理されます。指定できる値は任意の文字列で、同じグループに属している署名者を判別するためだけに使用できます。成功したレスポンスでは、同じ署名者グループ内の署名者ではなく、生成されたUUID値が示されます。", "example": "cd4ff89-8fc1-42cf-8b29-1890dedd26d7", "nullable": true } } }, "SignRequestPrefillTag": { "title": "署名リクエスト事前入力タグ", "type": "object", "description": "事前入力タグは、署名者の入力データをプレースホルダに事前入力するために使用されます。含めることができる値フィールドは1つだけです。", "properties": { "document_tag_id": { "type": "string", "example": "1234", "description": "これは、署名リクエストのファイルに含まれている特定のタグのIDを参照します。", "nullable": true }, "text_value": { "type": "string", "example": "text", "description": "テキストの事前入力値", "nullable": true }, "checkbox_value": { "type": "boolean", "example": true, "description": "チェックボックスの事前入力値", "nullable": true }, "date_value": { "type": "string", "format": "date", "example": "2021-04-26", "description": "日付の事前入力値", "nullable": true } } }, "SignRequestSignerInput": { "title": "署名リクエストの署名者の入力", "type": "object", "description": "署名リクエストに署名者が作成した入力", "required": [ "page_index" ], "allOf": [ { "$ref": "#/components/schemas/SignRequestPrefillTag" }, { "properties": { "type": { "type": "string", "enum": [ "signature", "date", "text", "checkbox", "radio", "dropdown" ], "description": "入力の種類", "example": "text" }, "content_type": { "type": "string", "enum": [ "signature", "initial", "stamp", "date", "checkbox", "text", "full_name", "first_name", "last_name", "company", "title", "email", "attachment", "radio", "dropdown" ], "description": "入力のコンテンツタイプ", "example": "signature" }, "page_index": { "type": "integer", "description": "入力が配置されるページのインデックス", "example": 4 }, "read_only": { "type": "boolean", "description": "この入力が読み取り専用 (署名者による変更不可) として定義されているかどうか", "example": true } } } ] }, "SignRequestSigner": { "title": "署名リクエストを取得のレスポンスの署名者フィールド", "type": "object", "description": "署名リクエストを取得のリクエスト本文内の署名者のスキーマ", "required": [ "email" ], "allOf": [ { "$ref": "#/components/schemas/SignRequestCreateSigner" }, { "properties": { "has_viewed_document": { "type": "boolean", "readOnly": true, "example": true, "description": "署名者がドキュメントを表示する場合は`true`に設定します" }, "signer_decision": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "signed", "declined" ], "example": "signed", "description": "署名者による決定の種類" }, "finalized_at": { "type": "string", "format": "date-time", "example": "2021-04-26T08:12:13.982Z", "description": "決定が行われた日時" }, "additional_info": { "type": "string", "example": "Requesting changes before signing.", "description": "署名者の拒否理由など、決定に関する追加情報", "nullable": true } }, "description": "署名者による最終的な決定", "nullable": true }, "inputs": { "type": "array", "items": { "$ref": "#/components/schemas/SignRequestSignerInput" }, "readOnly": true }, "embed_url": { "type": "string", "readOnly": true, "example": "https://example.com", "description": "署名のために署名者に案内するURL", "nullable": true }, "iframeable_embed_url": { "type": "string", "nullable": true, "example": "https://app.box.com/embed/sign/document/gfhr4222-a331-494b-808b-79bc7f3992a3/f14d7098-a331-494b-808b-79bc7f3992a4", "description": "このURLは、HTMLの`iframe`タグ内のドキュメントに署名するために設計されています。これがレスポンスで返されるのは、`embed_url_external_user_id`パラメータが`create sign request`コールで渡された場合のみです。" } } } ] }, "ShieldInformationBarrierReference": { "title": "Shield情報バリア参照", "type": "object", "x-box-resource-id": "shield_information_barrier_reference", "x-box-tag": "shield_information_barrier_reports", "description": "リクエストおよびレスポンスのShield情報バリア参照", "properties": { "shield_information_barrier": { "$ref": "#/components/schemas/ShieldInformationBarrier--Base" } } }, "ShieldInformationBarrierReportDetails": { "title": "Shield情報バリアレポートの詳細", "type": "object", "x-box-resource-id": "shield_information_barrier_report_details", "x-box-tag": "shield_information_barrier_reports", "description": "レポートの生成時に、レポートファイルが配置されているフォルダとエラー (ある場合) を示します。", "properties": { "details": { "type": "object", "properties": { "folder_id": { "type": "string", "example": "124235", "description": "このレポートの配置先を表すフォルダID" } } } } }, "TrackingCode": { "title": "追跡コード", "type": "object", "description": "追跡コードを使用すると、管理者は管理コンソールからレポートを生成し、特定のグループのユーザーに属性を割り当てることができます。この設定を使用するには、会社に対して有効にしておく必要があります。", "properties": { "type": { "type": "string", "description": "`tracking_code`", "example": "tracking_code", "enum": [ "tracking_code" ] }, "name": { "type": "string", "description": "追跡コードの名前。管理コンソールであらかじめ設定しておく必要があります", "example": "department" }, "value": { "type": "string", "description": "追跡コードの値", "example": "Sales" } } }, "MetadataFilter": { "title": "メタデータフィルタ", "type": "object", "x-box-resource-id": "metadata_filter", "x-box-tag": "search", "description": "検索結果のフィルタに使用するメタデータテンプレート。", "properties": { "scope": { "description": "検索結果のフィルタに使用する、テンプレートのスコープを指定します。\n\nこれは、この会社で使用するために定義されたテンプレートの場合は`enterprise_{enterprise_id}`、Boxを使用するすべての会社が利用できる一般的なテンプレートの場合は`global`になります。", "type": "string", "example": "enterprise", "enum": [ "global", "enterprise", "enterprise_{enterprise_id}" ] }, "templateKey": { "description": "検索結果のフィルタに使用するテンプレートのキー。\n\n多くの場合、テンプレートキーはその表示名から自動的に派生します。たとえば、`Contract Template`の場合は`contractTemplate`となります。場合によっては、テンプレートの作成者が独自のテンプレートキーを指定することもあります。\n\nテンプレートのキーを調べるには、[会社のテンプレートのリストを取得する][list]か、[ファイル][file]または[フォルダ][folder]上のすべてのインスタンスを取得してください。\n\n[list]: e://get-metadata-templates-enterprise\n\n[file]: e://get-files-id-metadata\n\n[folder]: e://get-folders-id-metadata", "type": "string", "example": "contract" }, "filters": { "allOf": [ { "anyOf": [ { "$ref": "#/components/schemas/MetadataFieldFilterString" }, { "$ref": "#/components/schemas/MetadataFieldFilterFloat" }, { "$ref": "#/components/schemas/MetadataFieldFilterMultiSelect" }, { "$ref": "#/components/schemas/MetadataFieldFilterFloatRange" }, { "$ref": "#/components/schemas/MetadataFieldFilterDateRange" } ] }, { "description": "検索結果のフィルタに使用するテンプレートのフィールドを指定します。複数のフィールドを指定すると、クエリでは論理`AND`が実行され、指定された各フィールドに一致するテンプレートのインスタンスが取得されます。" }, { "example": { "category": "online", "contractValue": 1000000 } } ] } } }, "MetadataFieldFilterString": { "title": "メタデータフィールドのフィルタ (文字列)", "type": "object", "x-box-resource-id": "metadata_field_filter_string", "description": "検索結果のフィルタに使用する、テンプレートのテキストフィールドを指定します。", "example": { "category": "online" }, "additionalProperties": { "type": "string", "description": "メタデータの`string`フィールドキーと検索結果の照合に使用する値のマッピング。", "example": "online", "x-box-example-key": "category" } }, "MetadataFieldFilterFloat": { "title": "メタデータフィールドのフィルタ (浮動小数点)", "type": "object", "x-box-resource-id": "metadata_field_filter_float", "description": "検索結果のフィルタに使用する、テンプレートの`float`フィールドを指定します。", "example": { "contractValue": 10000 }, "additionalProperties": { "type": "number", "description": "メタデータの`float`フィールドキーと検索結果の照合に使用する値のマッピング。", "example": 10000, "x-box-example-key": "contractValue" } }, "MetadataFieldFilterMultiSelect": { "title": "メタデータフィールドのフィルタ (複数選択)", "type": "object", "x-box-resource-id": "metadata_field_filter_multi_select", "description": "`multiSelect`メタデータフィールドと照合する値を指定します。検索を実行すると、クエリでは基本的に`OR`演算が実行され、指定した値のいずれかがこのフィールドと一致するテンプレートが取得されます。", "example": { "category": [ "online", "enterprise" ] }, "additionalProperties": { "type": "array", "description": "メタデータの`multiSelect`フィールドキーと検索結果の照合に使用する1つ以上の値のマッピング。\n\n検索を実行すると、クエリでは基本的に`OR`演算が実行され、指定した値のいずれかがこのフィールドと一致するテンプレートが取得されます。", "example": [ "online", "enterprise" ], "items": { "type": "string" }, "x-box-example-key": "category" } }, "MetadataFieldFilterFloatRange": { "title": "メタデータフィールドのフィルタ (浮動小数点の範囲)", "type": "object", "x-box-resource-id": "metadata_field_filter_float_range", "description": "検索結果のフィルタに使用するテンプレートの`float`フィールドを指定して、照合する値の範囲を指定します。", "example": { "contractValue": { "gt": 100000, "lt": 200000 } }, "additionalProperties": { "type": "object", "description": "検索結果のフィルタに使用するテンプレートの`float`フィールドを指定して、照合する値の範囲を指定します。", "example": { "gt": 100000, "lt": 200000 }, "x-box-example-key": "value", "properties": { "lt": { "description": "メタデータフィールド値の上限 (その値を含む) を指定します。検索クエリがこのテンプレートに一致するには、フィールドの値をこの値より小さくする (`lt`) かこの値と等しくする必要があります。", "type": "number", "example": 200000 }, "gt": { "description": "メタデータフィールド値の下限 (その値を含む) を指定します。検索クエリがこのテンプレートに一致するには、フィールドの値をこの値より大きくする (`gt`) かこの値と等しくする必要があります。", "type": "number", "example": 100000 } } } }, "MetadataFieldFilterDateRange": { "title": "メタデータフィールドのフィルタ (日付範囲)", "type": "object", "x-box-resource-id": "metadata_field_filter_date_range", "description": "検索結果のフィルタに使用するテンプレートの`date`フィールドを指定して、照合する日付の範囲を指定します。", "example": { "expirationDate": { "lt": "2017-08-01T00:00:00Z", "gt": "2016-08-01T00:00:00Z" } }, "additionalProperties": { "type": "object", "description": "`date`メタデータフィールドをある範囲の値と照合します。", "example": { "lt": "2017-08-01T00:00:00Z", "gt": "2016-08-01T00:00:00Z" }, "x-box-example-key": "expirationDate", "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" } } } } } }, "security": [ { "OAuth2Security": [] } ], "tags": [ { "name": "承認", "description": "A set of endpoints used to\nmanage user authorization process.", "x-box-tag": "authorization", "x-box-priority": true }, { "name": "署名リクエスト", "description": "Sign requests are used\nto submit a file for\nsignature.", "x-box-tag": "sign_requests" }, { "name": "Classifications", "description": "Classification labels are\nused for content that is\nsensitive or under security\nrestrictions.", "x-box-tag": "classifications" }, { "name": "ファイルの分類", "description": "Classification labels are\nused for files that are\nsensitive or under security\nrestrictions.", "x-box-tag": "file_classifications" }, { "name": "フォルダの分類", "description": "Classification labels are\nused for folders that are\nsensitive or under security\nrestrictions.", "x-box-tag": "folder_classifications" }, { "name": "Collaborations", "description": "Collaborations define access permissions\nfor users and groups to files and folders,\nsimilar to access control lists.", "x-box-tag": "user_collaborations" }, { "name": "コラボレーション (リスト)", "description": "A set of endpoints used to\nretrieve file, folder,\npending, and group collaborations.", "x-box-tag": "list_collaborations" }, { "name": "Collections", "description": "Collections are a way to group files,\nfolders, and web links without putting them\nall into a folder.", "x-box-tag": "collections" }, { "name": "Comments", "description": "Comments are messages generated users on files,\nallowing users to collaborate on a file,\ndiscussing any feedback they might\nhave on the content.", "x-box-tag": "comments" }, { "name": "Device Pinner", "description": "Device pinners allow enterprises to\ncontrol what devices can use\nnative Box applications.", "x-box-tag": "device_pinners" }, { "name": "ドメインの制限 (ユーザーの除外)", "description": "A set of endpoints that allow exempting users\nfrom restrictions imposed by the list of\nallowed collaboration domains for a specific enterprise.", "x-box-tag": "collaboration_allowlist_exempt_targets" }, { "name": "コラボレーションに対するドメインを制限", "description": "A set of endpoints that manage domains for which users\ncan collaborate with files and folders in an enterprise.", "x-box-tag": "collaboration_allowlist_entries" }, { "name": "ダウンロード", "description": "Downloads allow saving files to the application's server,\nor directly by the end user in a browser.", "x-box-tag": "downloads" }, { "name": "メールエイリアス", "description": "Email aliases provide a list of emails additional\nto the user's primary login email.", "x-box-tag": "email_aliases" }, { "name": "Events", "description": "Events provide a way for an\napplication to subscribe to\nany actions performed by\nany user, users, or service in an enterprise.", "x-box-tag": "events" }, { "name": "ファイルリクエスト", "description": "File Requests provide a fast and\nsecure way to request files and associated metadata\nfrom anyone.\nUsers can create new file requests\nbased on an existing file request,\nupdate file request settings, activate, deactivate, and delete\nfile requests programmatically.", "x-box-tag": "file_requests" }, { "name": "ファイルバージョンのリーガルホールド", "description": "A legal hold is a process that an enterprise\ncan use to preserve all forms of potentially relevant\ninformation when\nlitigation is pending or reasonably anticipated.\nA File Version Legal Hold represents all the policies that\nare assigned to a specific file version.", "x-box-tag": "file_version_legal_holds" }, { "name": "ファイルバージョンリテンション", "description": "A retention policy blocks permanent\ndeletion of content for a specified amount of time.\nA file version retention is a record for a retained file.", "x-box-tag": "file_version_retentions" }, { "name": "ファイルバージョン", "description": "A set of endpoints used to manage specific\nversions of a file.", "x-box-tag": "file_versions" }, { "name": "Files", "description": "Files, together with Folders,\nare at the core of the Box API.\nFiles can be uploaded and downloaded,\nas well as hold important metadata\ninformation about the content.", "x-box-tag": "files" }, { "name": "フォルダロック", "description": "Folder locks define access restrictions\nplaced by folder owners to prevent\nspecific folders from being moved or deleted.", "x-box-tag": "folder_locks" }, { "name": "Folders", "description": "Folders, together with Files,\nare at the core of the Box API.\nFolders can be uploaded and downloaded,\nas well as hold important metadata\ninformation about the content.", "x-box-tag": "folders" }, { "name": "統合マッピング", "description": "Integration Mappings allow the users\nto manage where content from partner apps is stored in Box.", "x-box-tag": "integration_mappings" }, { "name": "グループメンバーシップ", "description": "Group memberships signify that\na user is a part of the group.", "x-box-tag": "memberships" }, { "name": "Groups", "description": "Groups created in an enterprise.", "x-box-tag": "groups" }, { "name": "Invites", "description": "Invites are used to invite the user to\nan enterprise.", "x-box-tag": "invites" }, { "name": "リーガルホールドポリシー", "description": "A legal hold is a process that an enterprise\ncan use to preserve all forms of potentially\nrelevant information when litigation is pending or\nreasonably anticipated.", "x-box-tag": "legal_hold_policies" }, { "name": "リーガルホールドポリシー割り当て", "description": "A Legal Hold Policy Assignment\nis a relation between a policy and custodian.\nIn this case, as custodian can be a user, folder,\nfile, or file version.", "x-box-tag": "legal_hold_policy_assignments" }, { "name": "メタデータカスケードポリシー", "description": "A metadata cascade policy describes how metadata\ninstances applied to a folder should be applied\nto any item within that folder.", "x-box-tag": "metadata_cascade_policies" }, { "name": "メタデータインスタンス (ファイル)", "description": "A metadata instance describes\nthe relation between a template and a file,\nincluding the values that are assigned for every field.", "x-box-tag": "file_metadata" }, { "name": "メタデータインスタンス (フォルダ)", "description": "A metadata instance describes the relation between a template and a folder,\nincluding the values that are assigned for every field.", "x-box-tag": "folder_metadata" }, { "name": "メタデータテンプレート", "description": "A metadata template describes a reusable set\nof key/value pairs that can be assigned to a file.", "x-box-tag": "metadata_templates" }, { "name": "最近使用した項目", "description": "Recent items represent items such\nas files or folders that\nthe user accessed recently.", "x-box-tag": "recent_items" }, { "name": "リテンションポリシー", "description": "A retention policy blocks permanent deletion of content\nfor a specified amount of time. Admins can create\nretention policies and then assign them to\nspecific folders or their entire enterprise.", "x-box-tag": "retention_policies" }, { "name": "リテンションポリシー割り当て", "description": "A Retention Policy Assignment is a relation\nbetween a policy and folder or enterprise.\nCreating an assignment puts a retention on\nall the file versions that belong to that folder or enterprise.", "x-box-tag": "retention_policy_assignments" }, { "name": "検索", "description": "The Box API provides a way to find content in Box\nusing full-text search queries.", "x-box-tag": "search" }, { "name": "セッション終了", "description": "Session termination API is used to\nvalidate the roles and permissions of the group,\nand creates asynchronous jobs to terminate the group's sessions.", "x-box-tag": "session_termination" }, { "name": "共有リンク (ファイル)", "description": "Files shared links are URLs that are generated for files stored in Box,\nwhich provide direct, read-only access to the resource.", "x-box-tag": "shared_links_files" }, { "name": "共有リンク (フォルダ)", "description": "Folders shared links are URLs that are generated for folders stored in Box,\nwhich provide direct, read-only access to the resource.", "x-box-tag": "shared_links_folders" }, { "name": "共有リンク (ウェブリンク)", "description": "Web links for files are URLs that are generated\nfor web links in Box,\nwhich provide direct, read-only access to the resource.", "x-box-tag": "shared_links_web_links" }, { "name": "Shield情報バリア", "description": "Shield information barrier in Box defines an ethical wall.\nAn ethical wall is a mechanism that prevents exchanges or communication that\ncould lead to conflicts of interest and therefore result in\nbusiness activities ethically or legally questionable.", "x-box-tag": "shield_information_barriers" }, { "name": "Shield情報バリアのセグメント", "description": "Shield information barrier segment represents\na defined group of users. A user can be a member\nof only one segment, which makes segments\ndifferent from groups.", "x-box-tag": "shield_information_barrier_segments" }, { "name": "Shield情報バリアのセグメントメンバー", "description": "Shield information barrier segment member\nrepresents a user that is assigned to a\nspecific segment.", "x-box-tag": "shield_information_barrier_segment_members" }, { "name": "Shield情報バリアレポート", "description": "Shield information barrier reports\ncontain information on what existing collaborations\nwill be removed permanently when the information barrier is enabled.", "x-box-tag": "shield_information_barrier_reports" }, { "name": "Shield情報バリアのセグメント制限", "description": "Shield information barrier segment restriction is\nan access restriction based on the content (file or folder) owner.", "x-box-tag": "shield_information_barrier_segment_restrictions" }, { "name": "Signテンプレート", "description": "Sign templates allow you to use a predefined Box Sign\ntemplate when creating a sign request.\nThe template includes placeholders that\nare automatically populated with data when creating the request.", "x-box-tag": "sign_templates" }, { "name": "Skills", "description": "Box Skills are designed to allow custom processing\nof files uploaded to Box, with the\nintent of enhancing the underlying metadata of the file.", "x-box-tag": "skills" }, { "name": "標準およびZonesのストレージポリシー", "description": "Storage policy assignment represents the\nstorage zone for items in a given enterprise.", "x-box-tag": "storage_policies" }, { "name": "標準およびZonesのストレージポリシー割り当て", "description": "Storage policy assignment represents the\nrelation between storage zone and the\nassigned item (for example a file stored\nin a specific zone).", "x-box-tag": "storage_policy_assignments" }, { "name": "タスク割り当て", "description": "A task assignment defines which\ntask is assigned to which user to complete.", "x-box-tag": "task_assignments" }, { "name": "Tasks", "description": "Tasks allow users to request collaborators on a file\nto review a file or complete a piece of work.\nTasks can be used by developers to create file-centric workflows.", "x-box-tag": "tasks" }, { "name": "サービス利用規約", "description": "A set of endpoints used to\nmanage terms of service agreements.", "x-box-tag": "terms_of_services" }, { "name": "サービス利用規約のユーザーステータス", "description": "A set of endpoints used to\nmanage the status of terms of service\nfor a particular user.", "x-box-tag": "terms_of_service_user_statuses" }, { "name": "フォルダを移行", "description": "API designed to move all of the items\n(files, folders and workflows)\nowned by a user into another user's account.", "x-box-tag": "transfer" }, { "name": "ごみ箱内のファイル", "description": "Files that were deleted and\nare in trash.", "x-box-tag": "trashed_files" }, { "name": "ごみ箱内のフォルダ", "description": "Folders that were deleted and\nare in trash.", "x-box-tag": "trashed_folders" }, { "name": "ごみ箱内の項目", "description": "Items that were deleted and\nare in trash.", "x-box-tag": "trashed_items" }, { "name": "ごみ箱内のウェブリンク", "description": "Web links that were deleted and\nare in trash.", "x-box-tag": "trashed_web_links" }, { "name": "アップロード", "description": "The direct file upload API supports files\nup to 50MB in size and sends all\nthe binary data to the Box API in 1 API request.", "x-box-tag": "uploads" }, { "name": "アップロード (分割)", "description": "The chunked upload endpoints support files from\n20MB in size and allow an application\nto upload the file in parts,\nallowing for more control to catch any errors\nand retry parts individually.", "x-box-tag": "chunked_uploads" }, { "name": "ユーザーのアバター", "description": "User avatars are JPG or PNG files\nuploaded to Box to represent the\nuser image. They are then displayed\nin the user account.", "x-box-tag": "avatars" }, { "name": "Users", "description": "Box API supports a variety of users,\nranging from real employees\nlogging in with their Managed User account,\nto applications using App Users to drive powerful\nautomation workflows.", "x-box-tag": "users" }, { "name": "電子すかし (ファイル)", "description": "A watermark is a semi-transparent\noverlay on an embedded file\npreview that displays a viewer's email address\nor user ID and the time of access over\nthe file.", "x-box-tag": "file_watermarks" }, { "name": "電子すかし (フォルダ)", "description": "A watermark is a semi-transparent overlay on an embedded folder\npreview that displays a viewer's email address or user ID\nand the time of access over\nthe folder content.", "x-box-tag": "folder_watermarks" }, { "name": "ウェブリンク", "description": "Web links are objects that point to URLs.\nThese objects are also known as bookmarks\nwithin the Box web application.", "x-box-tag": "web_links" }, { "name": "Webhooks", "description": "Webhooks allow you to monitor Box content for events,\nand receive notifications to a URL of your choice when they occur.\nFor example, a workflow may include waiting\nfor a file to be downloaded to delete a shared link.", "x-box-tag": "webhooks" }, { "name": "ワークフロー (リスト)", "description": "Box Relay Workflows are objects that represent\na named collection of flows.", "x-box-tag": "workflows" }, { "name": "zipダウンロード", "description": "Zip downloads represent a successful request\nto create a ZIP archive with files and folders.", "x-box-tag": "zip_downloads" } ], "externalDocs": { "description": "Box Developerドキュメント", "url": "https://developer.box.com" } }