> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
> Box Platform変更ログ: API、SDK、および製品の更新 (2021年)
# 2021
## 廃止された言語バージョンのサポートの終了
Python SDKおよびJava SDKの次のメジャーバージョンをリリースする予定です。これに伴い、廃止された言語バージョンのサポートが終了となりますのでご注意ください。
日本時間2022年1月18日に、[Python](https://github.com/box/box-python-sdk/releases) SDKと[Java](https://github.com/box/box-java-sdk/releases) SDKのライブラリのメジャーリリースが計画されており、廃止された言語バージョンのサポートが終了する予定です。Python SDKでは、Python SDKのバージョン`v3.0.0`以降のPython 2.7およびPython 3.5のサポートが終了します。Java SDKでは、Java SDKのバージョン`v3.0.0`以降のJava 7のサポートが終了します。Python SDKまたはJava SDKを使用するアプリケーションでは、[GitHub](https://github.com/box/sdks)のリリースセクションにあるこれらのライブラリの古いバージョンをそれぞれ使用できますが、今後の新機能は使用できません。
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。また、それぞれのGitHubリポジトリでSDKチームにお問い合わせいただくことも可能です。
## Box Windows SDK v4.1.0のリリース
### バグ修正
* デッドロックの防止を待機中に欠落している`configureAwait`(false) を追加 ([#775](https://github.com/box/box-windows-sdk-v2/issues/775)) ([`b16267e`](https://github.com/box/box-windows-sdk-v2/commit/b16267e8f3dca5396e87be660e30a1e9405d8139))
### 新機能と機能強化
* `BoxClient`用に設定可能な`Timeout`を追加 ([#779](https://github.com/box/box-windows-sdk-v2/issues/779)) ([`ac842ed`](https://github.com/box/box-windows-sdk-v2/commit/ac842ed4ba1a2dfe499706524441bc6ae3b3c192))
* ファイルリクエストAPIを追加 ([#777](https://github.com/box/box-windows-sdk-v2/issues/777)) ([`1098f75`](https://github.com/box/box-windows-sdk-v2/commit/1098f75983e2d784521f13b8d53df0e55d03203b))
* `vanity_name`を`SharedLink`に追加 ([#782](https://github.com/box/box-windows-sdk-v2/issues/782)) ([`00a1e26`](https://github.com/box/box-windows-sdk-v2/commit/00a1e265569d76c2c9593aa259202d7febef629c))
- [https://www.nuget.org/packages/Box.V2/4.1.0](https://www.nuget.org/packages/Box.V2/4.1.0)
- [https://www.nuget.org/packages/Box.V2.Core/4.1.0](https://www.nuget.org/packages/Box.V2.Core/4.1.0)
## Box Python SDK v2.14.0のリリース
### 新機能と機能強化
* イベントストリームに対する`admin_logs_streaming`のサポートを追加 ([#623](https://github.com/box/box-python-sdk/pull/623))
* ファイルまたはフォルダへの共有リンクを作成するための`vanity_name`パラメータを追加 ([#637](https://github.com/box/box-python-sdk/pull/637))
* リテンションポリシー割り当てのために、リテンションの対象となるファイルおよびファイルバージョンの取得を追加 ([#633](https://github.com/box/box-python-sdk/pull/633))
* WebLinkクラスの基本の項目操作をサポート ([#639](https://github.com/box/box-python-sdk/pull/639))
### バグ修正
* 暗号化技術をバージョン3.5.0未満に制限 ([#636](https://github.com/box/box-python-sdk/pull/636))
* ファイルのサムネイルを生成できないときの404エラーの発生を回避 ([#642](https://github.com/box/box-python-sdk/pull/642))
## 要件の変更に伴うOAuth 2.0リダイレクトURIの更新
Box開発者コンソールの新機能をリリースしました。開発者は、この新機能を使用して、OAuth 2.0アプリケーション用に複数のリダイレクトURIを追加できるようになります。
日本時間2021年11月30日以降、OAuth 2.0を使用する新規のアプリケーションでは、開発者コンソールの \[構成] タブで設定されたURIとリダイレクト時に使用されるURIが厳密に一致する必要があります。また、そのため新規のアプリケーションと既存のアプリケーションの両方で、複数のリダイレクトURIを追加できるようになります。
既存のアプリケーションでは、サービスの中断を回避するために、日本時間2022年5月14日までにこのURLを変更する必要があります。
## 更新内容
* Box開発者コンソールのOAuth 2.0アプリケーションの \[構成] セクションに、複数のリダイレクトURIを追加するための新しいボタンが用意されました
* リダイレクトURIは、渡されたURIと、OAuth 2.0アプリケーションの構成で設定されたURIを一致させるように厳密なチェックを強制するようになりました
* [`GET /authorize`](/reference/get-authorize/#param-redirect_uri)エンドポイントのページで`redirect_uri`クエリパラメータの表現を更新しました
* OAuth 2.0の[設定](/guides/authentication/oauth2/oauth2-setup/)、[SDKを使用したOAuth 2.0](/guides/authentication/oauth2/with-sdk/)、[SDKを使用しないOAuth 2.0](/guides/authentication/oauth2/without-sdk/)に関するガイドページを更新しました
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## Box Java SDK v2.58.0のリリース
### 新機能と機能強化
* 新しいGET /events `stream_type`である`admin_logs_streaming`のSDKサポート ([#938](https://github.com/box/box-java-sdk/pull/938))
* 管理対象ユーザーまたはApp Userにこの接続を使用できることを示すために`BoxDeveloperEditionAPIConnection#getUserConnection`を追加 ([#940](https://github.com/box/box-java-sdk/pull/940))
### バグ修正
* 非推奨の列挙型が使用されている問題を修正 ([#931](https://github.com/box/box-java-sdk/issues/931))
## 新しいShieldダウンロードイベント
Shieldアクセスポリシーに基づいて制限されるダウンロードに対する新しい`event_type`を、[Enterprise Event](/guides/events/enterprise-events/for-enterprise) Streamにリリースしました。
ダウンロードを制限するShieldアクセスポリシーを管理者が作成し、エンドユーザーがファイルをダウンロードできないようブロックされると、[Enterprise Event](/guides/events/enterprise-events/for-enterprise) Stream内でイベントが生成されます。また、ユーザーがダウンロードが制限されたファイルを含むフォルダを表示したとき、ダウンロードが制限されたファイルをプレビューで表示したとき、ダウンロードが制限されたファイルをAPIを介してダウンロードすることをリクエストしたときにもイベントが生成されます。これらのイベントは、標準のイベントオブジェクトスキーマと、`SHIELD_DOWNLOAD_BLOCKED`に設定された`event_type`値に従います。
## 更新内容
* スマートアクセスのイベントトリガーのドキュメントに[新しいセクション](/guides/events/event-triggers/shield-alert-events/#download-restriction)を追加
* [Enterprise Eventのリスト](/guides/events/enterprise-events/for-enterprise/#event-types)に`SHIELD_DOWNLOAD_BLOCKED`を追加
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## stream\_typeをライブで監視する新しいイベントストリーム
`admin_logs_streaming`という[`GET /events`](/reference/get-events) API用に新しい`stream_type`をリリースしました。これにより、Boxで発生したイベントをほぼリアルタイムで監視できるようになります。
`admin_logs`を使用してライブイベントを登録しているアプリケーションは、最も低く一貫性のあるレイテンシを実現するために、`admin_logs_streaming`に移行することをお勧めします。この`stream_type`を使用するには、ユーザーは、**新規レポートの実行および既存レポートへのアクセスを行う**ための権限を持つEnterprise管理者または共同管理者である必要があります。
## 更新内容
この新しいオプションについて説明するために、ドキュメントを更新しました。
* わかりやすくするために[イベント](/guides/events)ガイドを全面的に再編しました (各種セクションのすべてのページへの情報の追加を含む)
* [`GET /events`](/reference/get-events)エンドポイントに関するOpenAPIの仕様を更新して、`admin_logs_streaming`の新しい`stream_type`オプションを含めました
* 切り替え時の手順を含め、[`stream_type`ページ](/guides/events/enterprise-events/migrate-to-stream)の新しい移行方法を追加しました
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## リテンションポリシーのマーカーベースのページネーションの追加
BoxのOpenAPIの仕様は、リテンションポリシーおよびリテンションポリシー割り当てのエンドポイントで`marker`ベースのページネーションと`fields`クエリパラメータの使用を示すために更新されました。
## 更新内容
更新内容は以下のとおりです。
* [`GET /retention-policies`](/reference/get-retention-policies)および[`GET /retention-policies-id-assignments`](/reference/get-retention-policies-id-assignments)エンドポイントに`fields`、`limit`、`marker`クエリパラメータを追加しました。
* [リテンションポリシー](/reference/retention-policies-resources#retention-policies)および[リテンションポリシー割り当て](/reference/retention-policy-assignments-resources#retention-policy-assignments)のレスポンスオブジェクトに`limit`と`next_marker `を追加しました。
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語で投稿してください。
## ファイルAPIを使用したリテンションポリシーの拡張
すでにリテンションの対象となっているファイルのリテンション期間を、新しい`disposition_at`フィールドを使用して延長できるようになりました。日付を延長した場合は、元に戻すことも、新しい日付より前の日付に更新することもできません。
## 更新内容
* [ファイル (Full) リソース](/reference/resources/file--full/#param-disposition_at)に`disposition_at`フィールドを追加
* [PUTファイルエンドポイント](/reference/put-files-id/#param-disposition_at)に`disposition_at`パラメータを追加
* [ガイドのリテンションポリシーセクション](/guides/retention-policies/#extend-retention-for-a-file)に注記を追加
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## Box Windows SDK v4.0.0のリリース
### 重要な変更
* BoxClientおよびマネージャのインターフェースを抽出し、テスタビリティを改善 ([#603](https://github.com/box/box-windows-sdk-v2/pull/603))
* BoxConfigBuilderを追加し、BoxConfigを変更不可に設定 ([#737](https://github.com/box/box-windows-sdk-v2/pull/737))
* 非同期メソッドからタスクを公開 ([#742](https://github.com/box/box-windows-sdk-v2/pull/742))
* DateTimeの代わりにDateTimeOffsetを使用 ([#749](https://github.com/box/box-windows-sdk-v2/pull/749))
* 返された例外を修正 ([#753](https://github.com/box/box-windows-sdk-v2/pull/753))
* .NET Standardを2.0にアップグレード ([#755](https://github.com/box/box-windows-sdk-v2/pull/755))
### 新機能と機能強化
* 割り当てのリテンションの対象となるファイルおよびファイルバージョンを取得する機能を追加 ([#734](https://github.com/box/box-windows-sdk-v2/pull/734))
* `Folder`の更新のために`is_collaboration_restricted_to_enterprise`フラグのサポートを追加 ([#732](https://github.com/box/box-windows-sdk-v2/pull/732))
* 不適切な用語の変更 ([#738](https://github.com/box/box-windows-sdk-v2/pull/738))
* サービス利用規約のユーザーステータスの作成用に使いやすくなった新しいメソッドを追加 ([#740](https://github.com/box/box-windows-sdk-v2/pull/740))
* ごみ箱内の項目を取得する際に並べ替えと方向のパラメータを渡すことを許可 ([#754](https://github.com/box/box-windows-sdk-v2/pull/754))
* タスクのcompletion\_ruleフィールドのサポートを追加 ([#758](https://github.com/box/box-windows-sdk-v2/pull/758))
* BoxSign APIのサポートを追加 ([#765](https://github.com/box/box-windows-sdk-v2/pull/765))
### バグ修正
* アップロード時の`Cannot access a closed Stream.Request`例外を修正 ([#739](https://github.com/box/box-windows-sdk-v2/pull/739)) ([#757](https://github.com/box/box-windows-sdk-v2/pull/757))
- [https://www.nuget.org/packages/Box.V2/4.0.0](https://www.nuget.org/packages/Box.V2/4.0.0)
- [https://www.nuget.org/packages/Box.V2.Core/4.0.0](https://www.nuget.org/packages/Box.V2.Core/4.0.0)
## Box iOS SDK v5.0.0のリリース
### 重要な変更
* ページを返してロジックを簡素化するようPagingIteratorを更新 ([#737](https://github.com/box/box-ios-sdk/pull/737))
* BoxClientの不適切な用語フィールド`collaborationWhiteList`を削除し、代わりに`collaborationAllowList`を使用 ([#790](https://github.com/box/box-ios-sdk/pull/790))
### 新機能と機能強化
* 不適切なイベントタイプを置き換え ([#785](https://github.com/box/box-ios-sdk/pull/785))
* SignAPIのサポートを追加 ([#792](https://github.com/box/box-ios-sdk/pull/792))
## Box SignのEnterprise Event
[Box Sign](/guides/box-sign)イベントが、Enterprise Event Streamを使用して利用できるようになりました。詳細については、[Box Signイベントガイド](/guides/events/event-triggers/sign-events)をご参照ください。
## 更新内容
* 署名リクエストの[ドキュメントイベント](/guides/events/event-triggers/sign-events/#document-events)を追加: 作成、変換、完了、キャンセル、期限切れ
* 署名リクエストの[署名者イベント](/guides/events/event-triggers/sign-events/#signer-events)を追加: 割り当て、署名者による表示、ダウンロード、転送、署名、拒否
* 2つの新しい[ステータス](/reference/resources/sign-requests/#param-status)を追加: `downloaded`、`downloaded and signed`
## Box UI Elements v14.0.0のリリース
## [14.0.0](https://github.com/box/box-ui-elements/releases/tag/v14.0.0) (2021-10-20)
## バグ修正と機能
このリリースでは、複数のバグが修正されます。全一覧については、[リリースノートを参照してください](https://github.com/box/box-ui-elements/releases/tag/v14.0.0)。
## App Diagnosticsレポートへのフィードバック
新しい[App Diagnosticsレポート](https://developer.box.com/guides/troubleshooting/app-diagnostics-report/)の[リリースを開始](/changelog/2021)しました。ぜひ皆様のご意見やご感想をお寄せください。フィードバックの提供については、[フォーラムの投稿](https://support.box.com/hc/en-us/community/posts/4408877038483-App-Diagnostics-Report-Feedback)を参照してください。
## Box Java SDK v2.57.0のリリース
### 新機能と機能強化
* `BoxFolder.getChildren`でのマーカーベースのページ割りのサポートを追加 ([#927](https://github.com/box/box-java-sdk/pull/927))
* `minimal-json`をバージョン0.9.5にアップグレード
* `jose4j`をバージョン0.7.9にアップグレード
* バージョン4.0.1にGradleラッパーを追加 ([#928](https://github.com/box/box-java-sdk/pull/928))
### バグ修正:\*\*
* 無限再帰の修正 ([#924](https://github.com/box/box-java-sdk/pull/924))
* `BoxFile`および`BoxFolder`の`BoxSharedLink`にバニティURLを設定できないバグの修正 ([#925](https://github.com/box/box-java-sdk/issues/925))
## Webhookのレスポンスの更新
[Webhookのレスポンス](/reference/get-webhooks)は、entriesの配列で適切なWebhook (Mini) オブジェクトを示すように更新されました。
## バグ修正
* [Webhook](/reference/resources/webhook--mini)用に`mini`リソースを追加
* [Webhookを取得](/reference/get-webhooks)のレスポンスオブジェクトを修正
## 新しいApp Diagnosticsレポート
日本時間2021年10月8日以降、新しいレポートが順次リリースされます。このレポートは、10月25日までにすべてのお客様にリリースされる予定です。
開発者は、開発者コンソールからApp Diagnosticsレポートを生成することにより、自分のアプリケーションに対するAPIアクティビティを確認できるようになりました。レポートの実行に必要な手順については、[ガイド](/guides/troubleshooting/app-diagnostics-report)をご確認ください。
これまでと同様、問題が発生した場合は、[サポートチケット](https://developer.box.com/support)を申請するか、[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語で投稿してください。
## Adobe Creative Cloudプレビューのサポート
ウェブアプリプレビューとの連携で、Adobe Photoshop、Illustrator、およびInDesignのファイルがAPIでサポートされるようになりました。
## 更新内容
拡張子が`indt`、`idml`、`indd`、`inx`のファイルは、以下の機能でサポートされます。
* [サムネイル](/guides/representations/thumbnail)
* [画像ビューアーUI Element](/guides/embed/ui-elements/viewers-and-events/#image-viewer)
* [注釈](/guides/embed/ui-elements/annotations)
* [サムネイルレプリゼンテーション](/guides/representations/thumbnail-representation)
## Box Python SDK v2.13.0のリリース
### 新機能と機能強化
* 不適切な用語の変更 ([#609](https://github.com/box/box-python-sdk/pull/609))
* Box Signのサポートを追加 ([#617](https://github.com/box/box-python-sdk/pull/617))
### バグ修正
* 暗号化技術をバージョン3にアップグレード ([#620](https://github.com/box/box-python-sdk/pull/620))
## Box Node SDK v2.0.0のリリース
### 重要な変更
* Node 6、7のサポートを終了 ([#670](https://github.com/box/box-node-sdk/pull/670))
### 新機能と機能強化
* `is_external_collab_restricted`ユーザープロパティのサポートを追加 ([#668](https://github.com/box/box-node-sdk/pull/668))
* プロキシエージェントを4.0.0から5.0.0に昇格 ([#664](https://github.com/box/box-node-sdk/pull/664))
## Open With UI ElementおよびAdobe Signの公式サポート終了
本日、[Open With UI Element](/guides/embed/ui-elements/open-with)をBox Tools、Google Workspace、およびAdobe Signと統合できるようになりました。Boxでは、常にエクスペリエンスの改善に向けて取り組む中で、変化するユーザーのニーズにより合った新しい機能の開発に今後も注力してまいります。
日本時間2021年12月22日に、以下の変更が行われる予定です。
* Box ToolsおよびGoogle Workspaceでは、新規のお客様に対するBox Open With UI Elementのサポートが終了する予定です。12月22日までにこのUI Elementを使用しなかったお客様は、新規のお客様とみなされます。12月22日までにBox Tools/Google WorkspaceでOpen With UI Elementを利用した場合は、既存のお客様とみなされ、別途通知があるまで引き続きサポートを受けることができます。Box ToolsおよびGoogle Workspaceのウェブアプリ機能に影響はありません。
* Adobe Signは、新規のお客様も既存のお客様も、Open With UI Elementまたはウェブアプリから使用できなくなる予定です。
ご質問がある場合は、[サポート](https://developer.box.com/support)チケットを作成するか[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語で投稿してお問い合わせください。
## リテンションAPIに対する新しい機能強化
指定されたリテンションポリシー割り当てのリテンションの対象となっているファイルおよびファイルバージョンを取得するために、新しく2つのAPIエンドポイントが導入されました。これらのAPIは、APIの[リテンションポリシー](/guides/retention-policies)スイートに含まれており、個々の[ファイル](/reference/get-file-version-retentions-id)および[ファイルバージョン](/reference/get-file-version-retentions)リテンションエンドポイント (まもなくBox APIでの公式サポート終了予定) に代わるものとして作成されました。公式サポート終了日については、後日お知らせいたします。
リテンションポリシー割り当てによってリテンションポリシーが適用されると、その適用先となるフォルダが選択されます。そのフォルダ内のファイルおよびファイルバージョンは、新しいエンドポイントを呼び出したときに返されるコンテンツになります。
## 機能
このリリースでは、以下の新しいコンテンツと機能が導入されました。
* [リテンションの対象となるファイルを取得](/reference/get-retention-policy-assignments-id-files-under-retention): 指定したリテンションポリシー割り当てに関連付けられている、リテンションの対象となるファイルのリストを返します。
* [リテンションの対象となるファイルバージョンを取得](/reference/get-retention-policy-assignments-id-file-versions-under-retention): 指定したリテンションポリシー割り当てに関連付けられている、リテンションの対象となるファイルバージョンのリストを返します。
* 編集可能な`description`フィールドを[リテンションポリシー](/reference/resources/retention-policy)リソースに追加。
* 書き込み不可の`start_field_date`を[リテンションポリシー割り当て](/reference/resources/retention-policy-assignment)リソースに追加。このフィールドは、メタデータフィールドのキーIDです。また、その値は、`assigned_to`のタイプが`metadata_template`でない場合または日付フィールドが選択されていない場合に`upload_date`にすることもできます。
## イベントAPIで分類の名前フィールドが追加
コンテンツに分類が存在する場合、[イベント](/reference/get-events/)APIにより、レスポンスオブジェクトで分類の`name`フィールドが返されるようになりました。
* イベントソースのレスポンスオブジェクトの更新については、[こちら](/reference/resources/event-source/)を参照してください。
* ユーザーソースおよびイベントソースによってトリガーされるイベントの例を紹介するために新しい[ガイドページ](/guides/events/event-triggers/event-source)が追加されました。
機能強化前と機能強化後のレスポンスの例を以下に示します。分類が存在しない場合は機能強化前の例が返されることに注意してください。
機能強化前:
```js theme={null}
{
"source": {
"item_type": "file",
"item_id": "8903212345",
"item_name": "example.docx",
"parent": {
"type": "folder",
"name": "All Files",
"id": "0"
},
"owned_by": {
"type": "user",
"id": "11446498",
"name": "Aaron Levie",
"login": "notifications@example.com"
}
}
}
```
機能強化後:
```js theme={null}
{
"source": {
"item_type": "file",
"item_id": "8903212345",
"item_name": "example.docx",
"parent": {
"type": "folder",
"name": "All Files",
"id": "0"
},
"owned_by": {
"type": "user",
"id": "11446498",
"name": "Aaron Levie",
"login": "notifications@example.com"
},
"classification": {
"name": "Top Secret"
}
}
}
```
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## 項目プレビューイベントの動作変更のお知らせ
本日以降、アプリケーションがBoxの[イベントAPIエンドポイント](https://developer.box.com/reference/get-events/)から項目プレビューイベントを使用した場合のこのイベントの動作に対する変更のリリースを開始します。
この変更は`ITEM_PREVIEW`[User Event](https://developer.box.com/guides/events/enterprise-events/for-user/#event-types)のみに影響し、既存の[Enterprise Event](https://developer.box.com/guides/events/enterprise-events)には影響しません。この新しい動作により、既存のアプリケーション内でダウンタイムが発生することはありません。また、稼働時間の中断を防ぐためのアプリケーションの変更も必要ありません。
## 変更の概要
以前の動作では、イベントを使用した場合、プレビューされた項目イベントが、コンテンツの所有者およびコンテンツに割り当てられたすべてのコラボレータのイベントタイプ`ITEM_PREVIEW`によって表示されました。つまり、2,000人のコラボレータが存在するファイルがプレビューされた場合、このファイルの所有者に加えて2,000人のコラボレータ全員に、ファイルがプレビューされたことを示すイベントが作成されます。
新しい動作では、項目のプレビューに関する通知がコンテンツの所有者に対してのみ作成され、コラボレータに対しては生成されません。これは、コンテンツの所有者としていつ項目がプレビューされたかを確認できるようにしたままイベントストリームのノイズを低減するのに役立ちます。
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## Box Java SDK v2.56.0のリリース
### 新機能と機能強化
* `submaster` `GroupMembershipRole`を`coadmin`に置き換え、`MASTER_INVITE_ACCEPT`および`MASTER_INVITE_REJECT`を`ADMIN_INVITE_ACCEPT`および`ADMIN_INVITE_REJECT`に置き換え ([#907](https://github.com/box/box-java-sdk/pull/907))
* ユーザーの作成APIコールに`tracking_codes`を追加 ([#910](https://github.com/box/box-java-sdk/pull/910))
### バグ修正
* `BoxFileRequest.Info`オブジェクトの`url`を修正 ([#906](https://github.com/box/box-java-sdk/pull/906))
* アクセストークンの更新時に発生するスレッドロックの問題の修正を試行 ([#912](https://github.com/box/box-java-sdk/pull/912))
## Box Node SDK v1.39.0のリリース
### 新機能と機能強化
* Box Sign APIのサポートを追加 ([#658](https://github.com/box/box-node-sdk/pull/658))
* TS Importsを強化 ([#656](https://github.com/box/box-node-sdk/pull/656))
## Box Node SDK v1.38.0のリリース
### 新機能と機能強化
* 管理者による招待のために機密性の高い言語イベントタイプを追加 ([#648](https://github.com/box/box-node-sdk/pull/648))
* `BetterDocs`を使用して`JSDocs`を`TypeScript`に適合 ([#646](https://github.com/box/box-node-sdk/pull/646))
* `ProxyAgent`のインポートを動的に変更 ([#641](https://github.com/box/box-node-sdk/pull/641))
* リテンションの対象となっているファイルおよびファイルバージョンを取得するための新しいAPI ([#585](https://github.com/box/box-node-sdk/pull/585))
### バグ修正
* BuffersおよびReadableストリームを除くConfigを強く固定 ([#651](https://github.com/box/box-node-sdk/pull/651))
* `src/managers/search.ts`のドキュメントの誤字を修正 ([#649](https://github.com/box/box-node-sdk/pull/649))
* ドキュメントのリンク切れを更新 ([#647](https://github.com/box/box-node-sdk/pull/647))
* `exchangeToken`関数の型注釈を修正 ([#645](https://github.com/box/box-node-sdk/pull/645))
* ファイルの`getThumbnail` APIのサポートを終了して`getRepresentationContent`を推奨 ([#627](https://github.com/box/box-node-sdk/pull/627))
## JWT形式に対して予定されている変更
日本時間2021年8月5日に、インフラストラクチャの継続的なアップグレードの一環として、JSON Web Token (JWT) を使用するサーバー認証を利用しているカスタムアプリケーションに影響を及ぼす可能性がある変更の展開を開始する予定です。
潜在的な影響により、公式の[Box SDK](https://developer.box.com/sdks-and-tools)を使用せず、トークンをデータベースに格納しているユーザーによる追加の確認が必要になります。
影響を受ける可能性があるユーザーとアプリケーション所有者全員に、メールで直接通知済みです。
## 変更の概要
今回の変更は、JSON Web Token (JWT) を使用するサーバー認証を利用しているアプリケーションのみに影響を及ぼす可能性があります。トークンは、Boxの[ドキュメント](https://developer.box.com/reference/post-oauth2-token/)で説明されているとおり、今後も文字列として返されますが、その形式は長くなり、特殊文字が含まれるようになります。
special characters.
現在返されるトークンの例: `NXWd9KDPVofXQKZJlQjICCWFHEmuOihs`
今回の変更後、トークンは次の形式で返されます。
`1!yxxhRreQCKcEbC_ZfYvPudyLe7Ed36gIQcqqZo2pfaVZyxNBkQjoHk0fgA1iTY3_uwXgif-hg-gne
aUdLRmGCb2He6tyQ_rA8aV-CllTyBbd9Tx-wU6Fnt4Df9XjzBAk8Dj7RYc1Ew_fcY2vfycpCvjwHLgql
jzjEpVIrOpOlK_2AyP5FExzn0x7DtbkaGc6avJU8UMQd_huXoJ7CnXIL_JBzVrW4D32pBLQ2AZIuecOZ
NMIy9T8PdUiZIG6xKEPqYmm21mQHEM0d7dT5foSBtjm65-Ah2tb2MdSGFb1G1O24vz2GmYFgmIe5UOol
qYIGg-0u2xQPC3F76WiNCiU_TP1JDQYi3HKaos807WkRtnBY5Vd-VAbY9DH-Qo3u1EiB0RFr4cht2N7V
B99y-379IEYzCojL2V58dE_pBxpRMv4KcOLVsUfDkbx3uo34H4UzOycI_IWGWrhVJD4M7GeLeD_5Vkmj
fbwYl2CmHdXAKbZKtXTHjzB0CZixZriT_wRUpsN8GTrrxGbx9ukgzJWRJwelGZ_1Yx7vP4Zkx3OfR5Be
-Tso7xdHd9rW0FXsu024U7dMNuQ6kpP1_kJI2Y`.
この形式はBoxにとって新しい形式ではありません。これは、[トークンのダウンスコープ](https://developer.box.com/guides/authentication/access-tokens/downscope)に使用されている形式と同じになります。
## アプリケーションへの影響の確認
1. \[**管理コンソール**] > \[**アプリ**] タブ > \[**カスタムアプリ**] に移動します。
2. 表示されている各アプリの行で \[**表示**] をクリックします。
3. アプリの詳細ページの一番下までスクロールし、選択されている認証方法を確認します。影響を受けるアプリには、\[**サーバー認証 (JWT使用)**] と表示されます。
上記で特定された各アプリケーションについて、以下の点を確認する必要があります。
1. 公式の[Box SDK](https://developer.box.com/sdks-and-tools)が使用されているかどうか。使用されている場合は、何もする必要はありません。常に最新バージョンを使用することをお勧めしますが、互換性に必要となる最小バージョンはありません。
2) 公式のSDKが使用されていない場合は、トークンがデータベースに格納されているかどうか。データベースに格納されている場合は、そのデータベースが新しい長さと特殊文字の両方に対応できるかを確認する必要があります。
## リリース前のテスト
サーバー認証 (JWT使用) を利用してトークンをデータベースに格納するアプリケーションを特定したら、8月5日より前に以下のテストを実行する必要があります。
前述のとおり、トークンの新しい形式は、現在、[トークンのダウンスコープ](https://developer.box.com/guides/authentication/access-tokens/downscope)時に使用されています。そのため、影響を確認するには、次の手順を実行してください。
1. アプリケーション用にアクセストークンを生成します。
2) 手順1で生成したトークンを[ダウンスコープ](https://developer.box.com/guides/authentication/access-tokens/downscope)します。
3. ダウンスコープされたトークンをデータベースに格納します。
このトークンをデータベースに問題なく格納できる場合は、何もする必要はありません。
このトークンを格納できない場合は、追加の長さと特殊文字をサポートするようデータベースを更新する必要があります。
## サポート情報
ご質問がある場合やさらにガイドが必要な場合は、[jwt-set-rollout@box.com](mailto:jwt-set-rollout@box.com)に英語でお問い合わせください。
## 新しい入門ガイド
Box APIの利用を開始するには、Boxの[ステップバイステップガイド](/guides/getting-started)をご確認ください。最適なユースケース、ユーザーモデル、アーキテクチャパターンなどを紹介しています。
## 機能
* ユースケースの評価: [ガイド](page/platform/use-cases/)
* 一般的なユーザーモデル: [ガイド](page/platform/user-types/)
* 一般的なアーキテクチャパターン: [ガイド](page/platform/appendix/architecture-patterns/)
* 一般的な値の確認: [ガイド](page/platform/appendix/locating-values/)
* セキュリティの概要: [ガイド](/guides/security)
* 認証のベストプラクティス: [ガイド](/guides/authentication/best-practices)
* 詳細な承認手順: [ガイド](/guides/authorization)
## Box Java SDK v2.55.1のリリース
### バグ修正
* [#890](https://github.com/box/box-java-sdk/pull/890)で削除されたメタデータクエリ実行の方式を復元し、非推奨としてマーク ([#905](https://github.com/box/box-java-sdk/pull/905))
## Box Sign APIのリリース
日本時間2021年7月27日に、Box Signをリリースしました。Box Signリクエストの作成、リスト取得、再送信、キャンセルを実行する最新のAPIエンドポイントを使用することで、[Box Signウェブアプリ](https://support.box.com/hc/en-us/articles/4404086827411-Introducing-Box-Sign)の全機能をプログラムによって利用できます。
Box SignのAPIエンドポイントを使用するために管理者がBox Signを有効にする必要はありませんが、Box Signを企業に導入する必要があります。Box SignがBoxインスタンスで利用できるようになると、管理者に通知されます。
少なくとも、Box Signリクエストを作成するには、署名用ファイルのほか、署名済みファイル/[署名ログ](https://support.box.com/hc/en-us/articles/4404095202579-Viewing-the-signing-log)の保存先フォルダを選択し、署名者を指定する必要があります。現時点では、1つのリクエストにつき署名できるファイルは1つだけです。
```curl theme={null}
curl -i -X PUT "https://api.box.com/2.0/sign_requests" \
-H "Authorization: Bearer " \
-d '{
"signers": [
{
"role": "signer",
"email": "example_email@box.com"
}
],
"source_files": [
{
"type": "file",
"id": "123456789"
}
],
"parent_folder":
{
"type": "folder",
"id": "0987654321"
}
}'
```
## 機能
* Box Signリクエストを**作成する**エンドポイントを追加: [ガイド](/guides/box-sign/create-sign-request) | [APIリファレンス](/reference//post-sign-requests)
* Box Signリクエストの**リストを取得する**エンドポイントを追加: [ガイド](/guides/box-sign/list-sign-requests/#all) | [APIリファレンス](/reference/get-sign-requests)
* IDを指定してBox Signリクエストを**取得する**エンドポイントを追加: [ガイド](/guides/box-sign/list-sign-requests/#by-id) | [APIリファレンス](/reference/get-sign-requests-id)
* Box Signリクエストを**再送信する**エンドポイントを追加: [ガイド](/guides/box-sign/resend-sign-request) | [APIリファレンス](/reference/post-sign-requests-id-resend)
* Box Signリクエストを**キャンセルする**エンドポイントを追加: [ガイド](/guides/box-sign/cancel-sign-request) | [APIリファレンス](/reference/post-sign-requests-id-cancel)
* Java SDKのサポート: [GitHub](https://github.com/box/box-java-sdk/tree/main/src/test/java/com/box/sdkgen/signrequests)
## Box Java SDK v2.55.0のリリース
注: 以下の「重大な変更」による悪影響はないため、Boxでは、このリリースについてメジャーバージョンを上げないことを決定しました。この変更によるお客様への影響はありません。
### 重大な変更
* APIレスポンスと一致するようメタデータ実行クエリを更新 ([#890](https://github.com/box/box-java-sdk/pull/890))
* 注: この変更により、メソッドは、サポートが終了されることなく、削除されます。このメソッドは、基になるサービスでサポートされなくなったため、正しく使用できなくなりました。
### 新機能と機能強化
* 不適切な用語を削除または廃止 (\[[#889](https://github.com/box/box-java-sdk/issues/889)])([https://github.com/box/box-java-sdk/pull/889](https://github.com/box/box-java-sdk/pull/889))
* ユーザーの`is_external_collab_restricted`パラメータのサポートを追加 ([#896](https://github.com/box/box-java-sdk/pull/896))
* `GroupMembership`の設定可能な権限のサポートを追加 ([#897](https://github.com/box/box-java-sdk/pull/897))
* `SHIELD_JUSTIFICATION_APPROVAL`イベントタイプを追加 ([#898](https://github.com/box/box-java-sdk/pull/898))
* 割り当てのリテンションの対象となるファイルおよびファイルバージョンを取得する機能を追加 ([#899](https://github.com/box/box-java-sdk/pull/899))
* `TASK_UPDATE`、`FILE_VERSION_RESTORE`、`ADVANCED_FOLDER_SETTINGS_UPDATE`イベントタイプを追加 ([#902](https://github.com/box/box-java-sdk/pull/902))
* Box Sign APIのサポートを追加 ([#904](https://github.com/box/box-java-sdk/pull/904))
### バグ修正
* `BoxLegalHoldPolicy`のセッターを追加 ([#885](https://github.com/box/box-java-sdk/pull/885))
* `BoxTaskAssignment`のセッターを追加 ([#886](https://github.com/box/box-java-sdk/pull/886))
* グループメンバーシップおよびウェブリンクのセッターを追加 ([#887](https://github.com/box/box-java-sdk/pull/887))
* Webhookのセッターを追加 ([#888](https://github.com/box/box-java-sdk/pull/888))
* `BoxFile.getThumbnail`のサポートを終了して`BoxFile.getRepresentationContent`を推奨 ([#891](https://github.com/box/box-java-sdk/pull/891))
## ファイルサイズの上限の更新
本日、Boxの新しいBusinessプランとしてEnterprise Plusプランをリリースしました。このプランでは、最大150 GBのアップロードとダウンロードをサポートします。また、以下のとおり、一部の既存プランでもファイルサイズの上限をアップグレードしました。ご利用のアカウントのファイルサイズの上限を確認する方法については、[アップロードに関するガイド](/guides/uploads/direct)を参照してください。
## 更新内容
* Enterprise: 50 GB
* Digital Workplace Suite: 50 GB
* Digital Workplace Global Suite: 50 GB
* Digital Business Suite: 50 GB
* Digital Business Global Suite: 50 GB
* Enterprise Plus: 150 GB
## 手動開始ワークフローの新しいエンドポイント
[Box Relay](https://www.box.com/collaboration/relay-workflow)用に2つのAPIエンドポイントが新しく導入されました。
* フォルダに構成されたワークフローを取得する
* ファイルのワークフロー内で手動開始フローを開始する
この新しいエンドポイントでは、ワークフロー内での情報の更新が許可されません。また、POSTエンドポイントで開始できるのは、`trigger_type`が`WORKFLOW_MANUAL_START`のフローのみです。POSTリクエスト本文内には`outcome_parametes`オブジェクト (省略可) があります。開始時に選択内容を承認するようフローが構成されている場合は、その選択内容をパラメータとして送信する必要があります。送信できるすべてのオプションを含むガイドは、まもなく利用できるようになります。
## 機能
このリリースでは、以下の新しいコンテンツと機能が導入されました。
* 新しい[ワークフロー](/reference/workflows-resources#workflow)リソース
* 新しい[GET](/reference/get-workflows)ワークフローエンドポイント
* 新しい[POST](/reference/post-workflows-id-start)手動開始ワークフローエンドポイント
## 項目を開くイベントの動作変更のお知らせ
本日以降、アプリケーションがBoxの[イベントAPIエンドポイント](https://developer.box.com/reference/get-events)から`ITEM_OPEN`イベントを使用した場合のこのイベントの動作に対する変更のリリースを開始します。
この変更は`ITEM_OPEN` [Enterprise Event](/guides/events/enterprise-events/for-enterprise)のみに影響します。この新しい動作により、既存のアプリケーション内でダウンタイムが発生することはありません。また、稼働時間の中断を防ぐためのアプリケーションの変更も必要ありません。
## 変更の概要
以前の動作では、イベントを使用した場合、開かれた項目イベントが、コンテンツの所有者およびコンテンツに割り当てられたすべてのコラボレータのイベントタイプ`ITEM_OPEN`によって表示されました。つまり、2,000人のコラボレータが存在するファイルがDriveなどで開かれた場合、このファイルの所有者に加えて2,000人のコラボレータ全員に、ファイルが開かれたことを示すイベントが作成されます。
新しい動作では、項目が開かれたという通知がコンテンツの所有者に対してのみ作成され、コラボレータに対しては生成されません。これは、コンテンツの所有者としていつ項目が開かれたかを確認できるようにしたままイベントストリームのノイズを低減するのに役立ちます。
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## Box Python SDK v2.12.1のリリース
### バグ修正
* サムネイルレプリゼンテーションが見つからない場合のバグの修正 ([#597](https://github.com/box/box-python-sdk/pull/597))
## Box Node SDK v1.37.2のリリース
### バグ修正
* 一部のTypeScript[`@types`](https://github.com/types)を直接的な依存関係として移動することで、後方互換性の問題を修正 ([#630](https://github.com/box/box-node-sdk/pull/630))
## Box Node SDK v1.37.1のリリース
### バグ修正
* 不適切な用語: `whitelist`から`allowlist`への変更 ([#625](https://github.com/box/box-node-sdk/pull/625))
## Box UI Elements v13.0.0のリリース
## [13.0.0](https://github.com/box/box-ui-elements/releases/tag/v13.0.0) (2021/04/22)
## バグ修正と機能
このリリースでは、複数のバグが修正されます。全一覧については、[リリースノートを参照してください](https://github.com/box/box-ui-elements/releases/tag/v13.0.0)。
## Box iOS SDK v4.4.0のリリース
## 重大な変更
### 新機能と機能強化
* 共有リンク項目を取得するための検索パラメータのサポートを追加 ([#756](https://github.com/box/box-ios-sdk/pull/756))
* フォルダロック機能のサポートを追加 ([#759](https://github.com/box/box-ios-sdk/pull/759))
* メタデータテンプレートの`copyInstanceOnItemCopy`フィールドのサポートを追加 ([#763](https://github.com/box/box-ios-sdk/pull/763))
* 新しいファイルバージョンのストリームアップロードのサポートを追加、新しいファイルバージョンのアップロード時の「If-Match」ヘッダーのサポートを追加 ([#766](https://github.com/box/box-ios-sdk/pull/766))
* `Event`モデルの詳細フィールドを追加 ([#770](https://github.com/box/box-ios-sdk/pull/770))
### バグ修正:\*\*
* iOS認証APIにスキーマのみを渡す ([#755](https://github.com/box/box-ios-sdk/pull/755))
* 名前によるフィルタにドキュメントされたパラメータを使用するよう`listEnterpriseGroups()`を更新 ([#757](https://github.com/box/box-ios-sdk/pull/757))
* トークンが取り消された場合にコールバックが呼び出されない、OAuthのバグを修正 ([#762](https://github.com/box/box-ios-sdk/pull/762))
## Box Python SDK v2.12.0のリリース
### 新機能と機能強化
* メタデータクエリ機能を追加 ([#574](https://github.com/box/box-python-sdk/pull/574))
* フォルダロック機能を追加 ([#581](https://github.com/box/box-python-sdk/pull/581))
* `include_recent_shared_links`フィールドの検索クエリサポートを追加 ([#582](https://github.com/box/box-python-sdk/pull/582))
* ドキュメントされたパラメータを使用して名前でフィルタをかけるために`get_groups()`を更新 ([#586](https://github.com/box/box-python-sdk/pull/586))
## Box Node SDK v1.37.0のリリース
### 新機能と機能強化
* メタデータテンプレートの`copyInstanceOnItemCopy`フィールドのサポートを追加 ([#572](https://github.com/box/box-node-sdk/pull/572))
### バグ修正
* Webhook署名の検証を修正 ([#568](https://github.com/box/box-node-sdk/pull/568))
* セキュリティの脆弱性にパッチを適用するための依存関係の更新 ([#578](https://github.com/box/box-node-sdk/pull/578))
## 項目ダウンロードイベントの動作変更のお知らせ
本日以降、アプリケーションがBoxの[イベントAPIエンドポイント](https://developer.box.com/reference/get-events/)から項目ダウンロードイベントを使用した場合のこのイベントの動作に対する変更のリリースを開始します。
この変更は`ITEM_DOWNLOAD`[User Event](https://developer.box.com/guides/events/user-events/for-user/#event-types)のみに影響し、既存の[Enterprise Event](https://developer.box.com/guides/events/enterprise-events/for-enterprise/)には影響しません。この新しい動作により、既存のアプリケーション内でダウンタイムが発生することはありません。また、稼働時間の中断を防ぐためのアプリケーションの変更も必要ありません。
## 変更の概要
以前の動作では、イベントを使用した場合、ダウンロードされた項目イベントが、コンテンツの所有者およびコンテンツに割り当てられたすべてのコラボレータのイベントタイプ`ITEM_DOWNLOAD`によって表示されました。つまり、2,000人のコラボレータが存在するファイルがダウンロードされた場合、このファイルの所有者に加えて2,000人のコラボレータ全員に、ファイルがダウンロードされたことを示すイベントが作成されます。
新しい動作では、項目のダウンロードに関する通知がコンテンツの所有者に対してのみ作成され、コラボレータに対しては生成されません。これは、コンテンツの所有者としていつ項目がダウンロードされたかを確認できるようにしたままイベントストリームのノイズを低減するのに役立ちます。
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## 共有リンクを使用してトークンをダウンスコープするための新しいオプション
アクセストークンをリクエストする際、共有リンクを使用してそのトークンをファイルまたはフォルダにダウンスコープできるようになりました。
この新しいパラメータは、`resource`パラメータの代わりに使用できます。このパラメータを使用すると、ファイルIDまたはフォルダIDを指定して同じ操作を実行できます。
## 更新内容
* 新しい`box_shared_link`リクエストパラメータを[ダウンスコープのドキュメント](https://developer.box.com/guides/authentication/access-tokens/downscope/#downscoping-in-practice)に追加しました。以下の方法で、共有リンクを指定してアクセストークンをダウンスコープできます。
```bash theme={null}
{
curl -i -X POST "https://api.box.com/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "subject_token=[ACCESS_TOKEN]" \
-d "subject_token_type=urn:ietf:params:oauth:token-type:access_token" \
-d "scope=item_upload item_preview base_explorer" \
-d "box_shared_link=https://cloud.box.com/s/123456" \
-d "grant_type=urn:ietf:params:oauth:grant-type:token-exchange"
}
```
* `box_shared_link`リクエストパラメータを[アクセストークンをリクエストAPIリファレンス](https://developer.box.com/reference/post-oauth2-token/#request)に追加しました。
## Box Java SDK v2.54.0のリリース
### 新機能と機能強化
* ファイルリクエストのサポートを追加 ([#869](https://github.com/box/box-java-sdk/pull/869))
### バグ修正
* `BoxWeblink`の逆シリアル化を修正 ([#881](https://github.com/box/box-java-sdk/pull/881))
## 開発者コンソールへのサービスアカウントのメールアドレスの追加
サーバー認証を利用するアプリケーションを管理者が承認すると、サービスアカウントの自動生成メールアドレスが開発者コンソールの \[一般] タブに表示されるようになりました。その後、このメールアドレスは、Boxコンテンツでユーザーをコラボレータに設定するために使用できます。これは、必ず`AutomationUser_AppServiceID_RandomString@boxdevedition.com`形式になります (例: `AutomationUser_123456_6jCo6Pqwo@boxdevedition.com`)。
詳細については、[ユーザータイプ](https://developer.box.com/platform/user-types)と[サービスアカウント](https://developer.box.com/platform/user-types#service-account)のガイドを参照してください。
## 機能
* サービスアカウントユーザーの自動生成メールアドレスを開発者コンソールに追加
## 新しいメタデータクエリインデックスのエンドポイント
指定したテンプレートとスコープのメタデータクエリインデックスのリストを取得する新しいAPIエンドポイントが導入されました。
メタデータクエリを使用すると、ファイルやフォルダに追加されているメタデータを検索して、そのファイルやフォルダを見つけることができます。
10,000を超えるファイルやフォルダに対してメタデータクエリを実行する際に、クエリのパフォーマンスが悪いと`HTTP 403`エラーが発生する場合があります。検索インデックスを作成すれば、これらのクエリを大規模に実行して、このエラー状態を回避できます。また、検索インデックスは、クエリの処理中に自動的に適用されます。
この新しいエンドポイントにより、作成されたこれらの検索インデックスの参照が可能になります。
## 機能
このリリースでは、以下の新しいコンテンツと機能が導入されました。
* スコープやメタデータを指定してメタデータクエリインデックスのリストを取得するための新しいAPIエンドポイント。
* 新しいメタデータクエリインデックスの[レスポンスオブジェクト](https://developer.box.com/reference/resources/metadata-query-indices/)。
* 新しいメタデータクエリインデックス (複数) の[レスポンスオブジェクト](https://developer.box.com/reference/resources/metadata-query-index/)。
## 更新内容
このリリースでは、次のように、コンテンツが更新されました。
* メタデータクエリインデックスのリストを取得する方法の詳細が記載されているメタデータクエリインデックスガイドを更新。
## 新しいコレクションイベント
外部のコレクションイベントが[Enterprise Event](/guides/events/enterprise-events/for-enterprise/) Streamから使用可能になりました。
Boxの[コレクション](/guides/collections/)を使用すると、ファイル、フォルダ、ウェブリンクを1つのフォルダにまとめるのではなく、グループ化できます。これらの新しいイベントにより、社内で行われるコレクションの操作を監視することができます。
イベントは標準的なイベントオブジェクトスキーマに従っており、以下のようなものがあります。
* `COLLECTION_CREATE`: コレクションが作成されました
* `COLLECTION_DELETE`: コレクションが削除されました
* `COLLECTION_UPDATE`: コレクションが更新されました
* `COLLECTION_ITEM_CREATE`: 項目がコレクションに追加されました
* `COLLECTION_ITEM_DELETE`: 項目がコレクションから削除されました
* `COLLECTION_ITEM_UPDATE`: コレクション内の項目が更新されました
## Box Shieldスマートアクセスイベント
外部コラボレーションの制限および正当な理由の承認のイベントが[Enterprise Event](/guides/events/enterprise-events/for-enterprise/) Streamから使用可能になりました。
この高度なセキュリティ機能を活用するには、[Box Shield](https://www.box.com/shield)を購入し、Box Enterpriseで有効にする必要があります。
これらのイベントは、`event_type`値が次のいずれかに設定されている、標準的な[イベントオブジェクト](/reference/resources/event/)スキーマに従います: `SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED_MISSING_JUSTIFICATION`、`SHIELD_EXTERNAL_COLLAB_INVITE_JUSTIFIED`、`SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED`、`SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED_MISSING_JUSTIFICATION`、`SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED`、`SHIELD_JUSTIFICATION_APPROVAL`。
各イベントの`additional_details`ペイロードでは、より多くの情報が提供されます。詳細については、BoxのShieldイベントの[ガイド](/guides/events/event-triggers/shield-alert-events/#smart-access)を参照してください。
## 機能
* Box Shieldの外部コラボレーションと正当な理由の承認のサポートをEnterprise Event Streamに追加
## Box CLI v2.9.0のリリース
## 新機能と機能強化
* メタデータテンプレートの複数選択フィールドにオプションを追加する機能を追加 ([#230](https://github.com/box/boxcli/pull/230))
* フォルダロック機能を追加 ([#232](https://github.com/box/boxcli/pull/232))
* 共有リンク項目を取得するための検索パラメータのサポートを追加 ([#233](https://github.com/box/boxcli/pull/233))
## バグ修正
* ストリーム位置のフラグが存在しない場合に発生するイベントコマンドのバグを修正 ([#234](https://github.com/box/boxcli/pull/234))
* folders:uploadコマンドでフォルダのコンテンツをアップロードできないバグを修正 ([#231](https://github.com/box/boxcli/issues/231))
## アプリケーションに影響を及ぼす可能性があるBox APIレスポンスヘッダーの変更
日本時間2021年5月11日に、インフラストラクチャの継続的なアップグレードの一環として、BoxのAPIレスポンスヘッダーが業界のベストプラクティスとAPIドキュメントに従って標準化され、常に小文字で返されるようになります。
この変更は、以下の影響を及ぼす可能性があります。
* [Salesforce SDK `v1`](https://github.com/box/box-salesforce-sdk/releases/tag/1.0.0)のユーザーは、影響を受けるため、最新のSDKバージョンにアップグレードする必要があります。アップグレードしなかった場合、2021年5月10日を過ぎると、Box Salesforce統合は機能しなくなります。
* Box APIのユーザーで、[Box SDK](https://developer.box.com/sdks-and-tools/)のいずれも使用していない場合は影響を受ける可能性があるため、コード全体でヘッダーの使用状況を確認する必要があります。ヘッダーの使用状況によっては、調整しないと、Box API統合で中断が生じる可能性があります。
影響を受ける可能性があるユーザーとアプリケーション管理者全員に、メールで直接通知済みです。
## 変更の概要
上記のリターンヘッダー (`location`や`retry-after`など) を使用しているアプリケーションでは、そのアプリケーションが大文字小文字を区別せずにこれらのヘッダーをチェックしているかを確認することが必要になります。この1年間で、Boxは自社のネットワークおよび可観測性のインフラストラクチャをアップグレードしてきました。このようなアップグレードでは、お客様のためにBoxの製品の信頼性と利用可能性の向上を目標としています。この具体的な変更により、Boxは、更新されたサービスプロキシを展開できるようになるため、サービストラフィックの監視強化、問題点の迅速な特定、アプリケーションパフォーマンスのチューニングを実現できます。
## APIをご利用の場合: アプリケーションへの影響の確認
使用するアプリケーションが影響を受けるかどうかを確認するには、コードのレビューが必要になります。Box公式SDKのいずれかをBox APIへの接続だけに使用している場合は影響を受けません。SDKでは、大文字小文字を区別せずにレスポンスヘッダーが処理されるためです。
影響を受けているかどうかを確認するには、以下の手順に従います。
* Box APIリクエストからのレスポンスを処理するアプリケーションコードを特定します。これらのレスポンスからレスポンスヘッダーを抽出しなければ、影響を受けることはありません。
* このようなレスポンスヘッダーを抽出する場合、ヘッダーの大文字小文字を区別する必要があると、影響を受ける可能性があります。
たとえば、`Location`ヘッダーの先頭が大文字`L`で返されること (つまり、特定の文字による文字列の直接比較) を想定している場合は、変更後に中断されないようにコードを修正する必要があります。
## APIをご利用の場合: 変更方法
影響を受けるアプリケーションを更新するには、これらのレスポンスヘッダーを確認する際に大文字小文字を区別しないようにしてください。具体的には、ヘッダー (`Location`など) が送信される際に先頭が大文字`L`でも小文字`l`でも同様に処理されるよう、慎重にコードを作成する必要があります。たとえば、このプロセスを処理するための2つの方法として、確認する前にすべてのヘッダーを強制的に小文字にするか、大文字小文字を区別しない正規表現による文字列チェックを使用することができます。
## Salesforce SDK `v1`をご利用の場合: アプリケーションへの影響の確認
Box Salesforce SDKの`v1.0`を使用しているかどうかわからない場合は、アプリケーションコード内で、Box Salesforce SDKを格納している場所に移動し、以下の手順を実行します。
次のSalesforce SDKファイルを読み込む: `src/classes/BoxApiRequest.cls`
以下の行 ([6～7行目](https://github.com/box/box-salesforce-sdk/compare/1.0.0...v1.1.0#diff-1855f83ffd4977e5b9e4bfc167154f2e11b0161fd6c380502c48082b6837b0af)) を探す。
```apex theme={null}
public final static String HEADER_LOCATION_LOWER_CASE = 'location';
public final static String HEADER_LOCATION_CAPITALIZED = 'Location';
```
上記の行が存在する場合は、使用しているSalesforce SDKは`v1.1.0`以降です。この場合は影響を受けず、変更も必要ありません。上記の行が存在しない場合、使用しているSalesforce SDKは`v1.0`です。この場合は影響を受けるため、更新する必要があります。
## Salesforce SDK `v1`をご利用の場合: 変更方法
影響を受けるアプリケーションを更新するには、使用しているSalesforce SDKのバージョンを更新する必要があります。[最新バージョン](https://github.com/box/box-salesforce-sdk)のSDKへのアップグレードをお勧めしますが、アプリケーションに影響がないようにするには、[`v1.1.0`以降](https://github.com/box/box-salesforce-sdk/releases)であればどれでも十分です。
## サポート情報
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxサポートチームに[チケットを申請](https://support.box.com/hc/en-us/requests/new)するか、Boxの[Developer Forum](https://support.box.com/hc/en-us/community/topics/360001932973-Platform-and-Developer-Forum)に英語でリクエストを投稿してください。
## Box iOS SDK v4.3.0のリリース
## 重大な変更
### 新機能と機能強化
* OAuth 2カスタムコールバックURLのサポートを追加 ([#746](https://github.com/box/box-ios-sdk/pull/746))
* zipダウンロードのサポートを追加 ([#749](https://github.com/box/box-ios-sdk/pull/749))
### バグ修正
* `kramdown`の脆弱性にパッチを適用するためにgemを更新 ([#742](https://github.com/box/box-ios-sdk/pull/742))
* `activesupport`の脆弱性にパッチを適用するためにgemを更新 ([#745](https://github.com/box/box-ios-sdk/pull/745))
## Box Node SDK v1.36.0のリリース
### 新機能と機能強化
* フォルダロック機能を追加 ([#560](https://github.com/box/box-node-sdk/pull/560))
* 名前によるグループのフィルタのサポートを追加 ([#561](https://github.com/box/box-node-sdk/pull/561))
### バグ修正
* プロキシサポートの問題にパッチを適用するためのプロキシエージェントの更新 ([#563](https://github.com/box/box-node-sdk/pull/563))
* セキュリティの脆弱性にパッチを適用するための依存関係の更新 ([#566](https://github.com/box/box-node-sdk/pull/566))
## ファイルの最大アップロードサイズの増加
以下のBoxアカウントプランで、APIを介してアップロードできる最大ファイルサイズが増加しました。
* Business Plus
* Enterprise
* Digital Workplace Suite
* Digital Workplace Global Suite
これまで、これらのアカウントの最大アップロードサイズは**5 GB**でした。このアップデートにより、最大ファイルサイズが**15 GB**に増加し、すぐに有効になります。
すべてのアカウントの最大ファイルサイズの詳細については、[直接アップロード](/guides/uploads/direct/)を参照してください。
## メタデータクエリのインデックスの変更
ファイル/フォルダの[メタデータクエリ](/guides/metadata/queries/)リクエストを実行する際、検索対象となるファイル/フォルダが10,000を超えるクエリには検索インデックスの作成が必要になります。
このプロセスの効率を改善し、より簡潔にするために、メタデータクエリAPIリクエストで`use_index`キーを使用してインデックスを指定するという明示的な要件をなくすことで、インデックスの使用方法を変更しました。
現在`use_index`キーを使用してインデックスを指定している既存のアプリケーションに影響はありません。指定されたインデックスはリクエストで無視され、最も効率的なインデックスが自動的に適用されます。
## 以前のインデックス作成プロセス
検索対象のファイル/フォルダが10,000を超えるメタデータクエリリクエストに対してインデックスを作成して使用する場合の以前のプロセスは以下のとおりです。これは、変更前のプロセスです。
* インデックスをリクエストするには、メタデータクエリチームにお問い合わせください。
* メタデータクエリチームによってインデックスが作成され、新しく作成されたインデックスの名前が提供されます。
* メタデータクエリリクエストの実行時に、このインデックス名をAPIリクエストの`use_index`キーの値として指定していました。
## 新しいインデックス作成プロセス
インデックスを作成して使用する新しいプロセスは以下のとおりです。
* インデックスをリクエストするには、メタデータクエリチームにお問い合わせください。
メタデータクエリAPIリクエスト内の`use_index`キーは削除されました。その代わり、検索処理中に最も効率的なクエリが自動的に適用されます。
`use_index`キーで現在指定されているインデックスは無視され、代わりに最も効率的なインデックスが使用されます。
アプリケーションの所有者は、自己の判断でメタデータクエリリクエストから`use_index`キーと値を安全に削除できます。
## 開発者コンソールのアップデート
開発者コンソールで新しく \[**承認**] タブが使用可能になりました。さらに、\[**構成**] タブ内の \[**アプリケーションアクセス**] と \[**Scope (スコープ)**] の設定でUIがわかりやすく変更されたことで、設定を決定しやすくなりました。このような変更は、設定の機能には影響しません。
これで、開発者は \[**承認**] タブに移動して、承認を得るためにアプリケーションを直接Box管理者に送信するようになります。
\[**構成**] タブに関しては、JWTの \[**アプリケーションアクセス**] の設定に役立つヒントが追加されたため、\[**アプリアクセスのみ**] と \[**アプリアクセス + Enterpriseアクセス**] のどちらにするかを明確に決めやすくなりました。現在、\[**Scope (スコープ)**] セクションは、操作の種類 (コンテンツ操作、管理操作、管理者操作) でグループ化されています。
* **アプリの承認プロセス**: [ガイド](/guides/authorization/platform-app-approval)
* **スコープ**: [ガイド](/guides/api-calls/permissions-and-errors/scopes)
* **アプリケーションアクセス**: [ガイド](/guides/authentication/jwt/jwt-setup/#application-access)
## 更新内容
* 開発者コンソールに \[承認] タブを追加しました
* \[構成] タブでJWTの \[アプリケーションアクセス] の設定用UIを更新しました
* \[構成] タブで \[Scopes (スコープ)] のUIのグループ化を更新しました
## Box Python SDK v2.11.0のリリース
### 新機能と機能強化
* サムネイルを取得するためのメソッドの廃止および追加 ([#572](https://github.com/box/box-python-sdk/pull/572))
## Box Java SDK v2.53.0のリリース
### 新機能と機能強化
* `BoxFolder.getChildren`へのオフセットおよび制限パラメータの追加 ([#861](https://github.com/box/box-java-sdk/pull/861))