> ## 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、および製品の更新 (2018年)
# 2018
export const Link = ({href, children, className, ...props}) => {
const localizedHref = localizeLink(href);
return
{children}
;
};
## Box CLI V2のリリース
Box CLIのメジャーバージョン (V2) がリリースされました。
更新情報については次のリンクを参照してください。
* [リリースノート](https://github.com/box/boxcli/blob/master/CHANGELOG.md#200): 大きな修正の詳細、重大な変更、バグの修正。
* [コマンドの一覧](https://github.com/box/boxcli#command-topics): 新しいCLIで利用可能なすべてのコマンド。
* インストールオプション: スタンドアロンインストーラとソースコードオプション。
## Windows .NET SDK v3.10.0のリリース
1. メタデータカスケードポリシーの機能を追加
[`nuget.org/packages/Box.V2`](https://www.nuget.org/packages/Box.V2)
[`nuget.org/packages/Box.V2.Core`](https://www.nuget.org/packages/Box.V2.Core/)
## Java SDK v2.25.0のリリース
1. `outputstream`を介したBoxへのコンテンツストリーミングを許可。[#667](https://github.com/box/box-java-sdk/pull/667)
## コラボレーションに未登録ユーザーを表示
ファイルまたはフォルダのコラボレータとして未登録ユーザーが追加されている場合のために、コラボレーション戻りオブジェクトにフィールド`invite_email`が追加されました。現在返される`accessible_by`オブジェクトでは未登録ユーザーの結果として`null`が表示されることから、この変更が加えられました。新しいフィールドには、ユーザーの招待に使用されたメールアドレスが表示されます。
この変更は以下のエンドポイントに影響します。
* [コラボレーションを取得](/reference/get-collaborations-id)
* [ファイルコラボレーションを取得](/reference/get-files-id-collaborations)
* [フォルダコラボレーションを取得](/reference/get-folders-id-collaborations)
これまで、未登録ユーザーを含むコラボレーションオブジェクトは以下のように表示されていました。
```js theme={null}
{
"type": "collaboration",
"id": "376164239",
.....
"accessible_by": null
.....
}
```
今回の更新により、返されるオブジェクトは以下のように表示されます。
```js theme={null}
{
"type": "collaboration",
"id": "376164239",
......
"accessible_by": null
"invite_email": "sadfasdf@box.com",
},
......
}
```
## Enterprise Event APIにスーパーバイザ向けのcreated\_byを追加
Box管理者などのスーパーバイザまたは内部管理者ユーザーがアクションを実行する場合の[Enterprise Event](/reference/get-events/#request) APIエンドポイントのレスポンスオブジェクトに小さな変更が加えられました。
この更新の前は、スーパーバイザまたは内部管理者ユーザーのユーザー情報がレスポンスオブジェクトの`created_by`フィールドに表示されていました。今回の更新により、そのユーザーがスーパーバイザまたは内部管理者である場合、レスポンスに一般的なユーザー情報が表示されるようになりました。
これまで、レスポンスの`created_by`フィールドは以下のように表示されていました。
```js theme={null}
"created_by": {
"type": "user",
"id": "2030401181",
"name": "sshah+iadev",
"login": "admin_sshah"
}
```
今回の更新により、同じレスポンスが以下のように表示されます。
```js theme={null}
"created_by": {
"type": "user",
"id": "box_support",
"name": "Box Support",
"login": "support@box.com"
}
```
## Java SDK v2.24.0のリリース
1. optionsオブジェクトのテストと実装を追加 ([#661](https://github.com/box/box-java-sdk/pull/661))
2. `BoxItem`のオブジェクトタイプを公開 ([#662](https://github.com/box/box-java-sdk/pull/662))
3. 接続ごとのタイムアウトを許可 ([#660](https://github.com/box/box-java-sdk/pull/660))
4. 最大リクエスト数のグローバル設定を追加 ([#657](https://github.com/box/box-java-sdk/pull/657))
5. `is_ongoing`フィールドにオーバーロードを追加し、`is_ongoing`にgetterを追加 ([#653](https://github.com/box/box-java-sdk/pull/653))
## 重大な変更
* Python 2.6はサポートされなくなりました。
* Python 3.3はサポートされなくなりました。
* `client.search()`により、検索APIを呼び出すための`query()`メソッドを公開する`Search`オブジェクトが返されるようになりました。`client.search(**search_params)`の代わりに`client.search().query(**search_params)`を使用してください。
* `client.get_memberships(...)`の署名が変更されました。他のSDKとの一貫性を保つため、制限パラメータとオフセットパラメータの位置が入れ替えられました。
* `client.groups(...)`が`client.get_groups`に変更されました。制限パラメータとオフセットパラメータの位置が入れ替えられました。
* `item.create_shared_link(...)`と`file.get_shared_link_download_url(...)`の`unshared_at`パラメータは、`datetime.date`ではなく`RFC3339-formatted ` `unicode`文字列を取得するようになりました。ユーザーは`v1.x`から移行する場合、`date`オブジェクト自体ではなく`date.isoformat()`の値を渡すことができます。
* `Events.get_events(...)`では、イベントを表す`dict`のリストではなく、`Event`インスタンスのリストが返されるようになりました。`Event`は`Mapping`から継承されますが、`dict`と同じ機能をすべて備えているとは限りません。
* `Events.get_events(...)`を使用していて、`Mapping`のリストではなく`dict`のリストを想定する場合、コードは影響を受けます。たとえば、`__setitem__` (`event['key'] = value`)、`update()`、`copy()`を使用する場合、またはコードが`Event`の`str`または`repr`に依存する場合がこれに該当します。`__getitem__` (`event['key']`)、`get()`、およびその他の`Mapping`メソッドの使用は影響を受けません。`Mapping`インスタンスでサポートされているメソッドについては、[Pythonドキュメント](https://docs.python.org/2.7/library/collections.html#collections-abstract-base-classes)を参照してください。
* 移行: まだ`Event`を`dict`として扱う必要がある場合は、`BaseAPIJSONObject`の新しいプロパティ`response_object`を使用して、元の`dict`のディープコピーを取得できます。
* `LoggingNetwork`は削除されました。ログ記録の呼び出しは`DefaultNetwork`クラスから行われるようになりました。さらに、このクラスのログ記録形式の文字列は、これらの文字列をオーバーライドしたアプリケーションのログ記録を中断する形で変更されました。位置指定のプレースホルダではなく、キーワード形式のプレースホルダが使用されるようになりました。今後、カスタム形式の文字列はすべて、同じキーワード形式のプレースホルダを使用する必要があります。これは重大な変更ですが、キーワード形式のプレースホルダを使用すると、今後の変更は自動的に後方互換性が維持されるという利点があります (キーワードの変更/削除を伴う変更が行われない限り)。
* `File.update_contents()`と`File.update_contents_with_stream()`では、適切な内部JSON構造を持つ`File`オブジェクトが正しく返されるようになりました。以前は、ファイルJSONが`file['entries'][0]`内で非表示になっている`File`オブジェクトが返されていました。これはバグ修正ですが、このバグを処理するコードをすでに作成しているクライアントにとっては重大な変更になります。
* Box IDが同じでもタイプが異なる2つのオブジェクト (例: `File`と`Folder`) を`==`で比較した場合に、`False`が正しく返されるようになりました。
* 次のメソッドでは、単一のページではなく、返されたオブジェクトのコレクション全体の反復子が返されるようになりました。
* `client.users()`
* `client.groups()`
* `client.search().query()`
* `folder.get_items()`
`folder.get_items()`が反復子を返すようになったため、`folder.get_items_limit_offset()`と`folder.get_items_marker()`は削除されました。マーカーベースのページングを`folder.get_items()`で使用するには、`use_marker=True`パラメータを渡し、オプションとして`marker`パラメータを指定して、コレクションのそのポイントからページングを開始します。
さらに、`group.membership()`は名前が`group.get_memberships()`に変更され、メンバーシップオブジェクトの反復子を返すようになりました。このメソッドでは、ページング情報を含むタプルを返すオプションが提供されなくなりました。
* `Translator`クラスが変更されました。`translator.get(...)`は引き続き、渡された型に対応するオブジェクトクラスのコンストラクタを返しますが、`translator.translate(...)`は、`Session`とレスポンスオブジェクトを直接受け取り、変換されたオブジェクトを生成します。また、このメソッドは、ネストされたオブジェクトが見つかった場合にもそれらを変換します。
* この変更により、`GroupMembership`にカスタムコンストラクタを使用する必要はなくなります。そのため、デフォルトの`BaseObject`コンストラクタが使用されるようになります。
## 機能
* 公開されているAPIエンドポイントとパラメータはすべて、SDKでサポートされるようになりました。
* オブジェクト変換システムの柔軟性が向上しました。
* 非グローバルの`Translator`インスタンスを作成できます。これにより、グローバルなデフォルトの`Translator`を拡張することも、拡張しないことも可能です。
* カスタム`Translator`で`BoxSession`を初期化できます。
* `BoxSession`または`Client`に関連付けられている`Translator`にカスタムサブクラスを登録できます。
* APIレスポンスのすべての変換で、グローバルなデフォルトの`Translator`を直接使用する代わりに、`BoxSession`で参照される`Translator`が使用されるようになりました。
* ネストされたオブジェクトは`translator.translate()`によって変換されるようになりました。
* `BoxSession`に対してリクエストメソッドのいずれかを呼び出すときに`auto_session_renewal`が`True`である場合、アクセストークンがないと、`BoxSession`は、リクエストを実行する*前に*トークンを更新します。これにより、APIコールが1回省略されます。
* 認証オブジェクトを閉じられるようになりました。これにより、これらのオブジェクトは新しいトークンのリクエストに使用できなくなります。また、既存のトークンも取り消されます (ただし、この機能は、`revoke=False`を渡すことで無効にできます)。加えて、終了時に認証オブジェクトを自動的に閉じる`closing()`コンテキストマネージャメソッドも導入されます。
* `JWTAuth`基本クラスに対するさまざまな機能強化:
* `authenticate_app_user()`メソッドは、管理対象ユーザーの認証にも使用できるようになったことを示すため、`authenticate_user()`という名前に変更されました。詳細については、メソッドの`docstring`を参照してください。`authenticate_app_user()`は、不要な後方非互換性が発生しないよう、`authenticate_user()`のエイリアスとなりました。
* `authenticate_user()`への`user`引数に、ユーザーID文字列と`User`インスタンスのいずれかを指定できるようになりました。以前は、`User`インスタンスを指定する必要がありました。
* コンストラクタは、`user`キーワード引数 (省略可) を受け取るようになりました。これには、ユーザーID文字列と`User`インスタンスのいずれかを指定できます。この引数が渡されると、`user`引数の値を渡さなくても`authenticate_user()`を呼び出すことができます。さらに重要なことに、これは、構築後すぐに`refresh()`を呼び出すことができることを意味します。その際、`authenticate_user()`を手動で呼び出す必要はありません。前述の`BoxSession`の`auto_session_renewal`機能の改善と組み合わせることで、最初のAPIコール時に、`JWTAuth`オブジェクトの認証を完全に自動で実行できます。
* コンストラクタは、RSA秘密キーの受け渡し方法を2つサポートしています。1つはファイルシステムパスを使用する方法 (既存の機能)、もう1つはキーデータを直接渡す方法 (新機能) です。`rsa_private_key_file_sys_path`パラメータは省略可能になりましたが、`rsa_private_key_file_sys_path`または`rsa_private_key_data`のどちらか1つを渡す必要があります。
* `JWTAuth`の`enterprise_id`引数を`None`にできることが文書化されました。
* `authenticate_instance()`は`enterprise`引数を受け取れるようになりました。これは、構築時に`None`が`enterprise_id`に渡された場合に、Enterpriseのサービスアカウントユーザーとして設定および認証するために使用できます。
* 有効期限が適切な期間に含まれないことが原因で失敗した認証は、Box APIレスポンスのDateヘッダーで指定された時間を使用して、自動的に再試行されるようになりました。これは、Box SDKを実行しているマシンのシステム時刻がBox APIサーバーのシステム時刻と一致しない場合に必然的に発生する可能性があります。
* `Event`クラスが追加されました。
* `metadata()`メソッドは`Folder`および`File`で使用できるように`Item`に移動されました。
* `BaseAPIJSONObject`基本クラス (すべてのAPIレスポンスオブジェクトのスーパークラス) が`__contains__`および`__iter__`をサポートするようになりました。これらの動作は`Mapping`と同じです。つまり、`__contains__`はオブジェクトのJSONキーをチェックし、`__iter__`はそのオブジェクトのすべてのキーを生成します。
* `RecentItem`クラスが追加されました。
* Box上でユーザーが最近アクセスした項目を取得する`client.get_recent_items()`が追加されました。
* 新しいコラボレーション作成時の`can_view_path`パラメータのサポートが追加されました。
* エンドポイントからのオブジェクトのページングをより直接的に管理できるように`BoxObjectCollection`とサブクラス`LimitOffsetBasedObjectCollection`および`MarkerBasedObjectCollection`が追加されました。これらのクラスは、エンドポイントへのリクエストを構成して結果を格納するロジックを管理し、結果に対して繰り返し適用される`__next__`を提供します。結果を1つずつ返すか結果の`Page`として返すオプションも提供されます。
* `downscope_token()`メソッドが`Client`クラスに追加されました。このメソッドによって生成されるトークンの権限は、指定されたスコープや、オプションとして指定された`File`または`Folder`に下げられています。
* 構成ファイルから`JWTAuth`を構成するためのメソッド`JWTAuth.from_settings_file`と`JWTAuth.from_settings_dictionary`が追加されました。
* `network_response`プロパティが`BoxOAuthException`に追加されました。
* APIの構成を`BoxSession`インスタンスごとに実行できるようになりました。
## \[その他]
* `BoxAPIException`に追加情報が加えられました。
* `collaboration()`メソッドが`Client`に追加されました。
* クラス階層が変更されました。これまで、`BaseEndpoint`は、すべてのスマートオブジェクトの親である`BaseObject`の親でした。今後、`BaseObject`は`BaseEndpoint`と`BaseAPIJSONObject`両方の子になります。`BaseObject`は、REST APIに含まれるすべてのオブジェクトの親です。`BaseAPIJSONObject`の別のサブクラスである`APIJSONObject`は、APIエンドポイントから直接アクセスできない`Event`など、疑似スマートオブジェクトを表すために作成されました。
* `network_response_constructor`が`Network`インターフェースの省略可能なプロパティとして追加されました。実装では、このプロパティを一時的に無効にし、これを使用して`NetworkResponse`インスタンスを構築することをお勧めします。このように、サブクラスの実装では、このプロパティを再度一時的に無効にすることで、`NetworkResponse`の機能を拡張できます。このプロパティは、`DefaultNetwork`実装で定義および使用されます。
* レスポンスログは新しい`LoggingNetworkResponse`クラスに移動されます (これは前述の`network_response_constructor`プロパティによって可能になります)。レスポンス本文をログに記録するかどうかは、呼び出し元がコンテンツを読み取るかストリーミングするかに基づき、SDKで決定されます。
* `LoggingNetwork`からのリクエスト/レスポンスログに情報が追加されました。
* `LoggingNetwork`にリクエスト例外のログ記録が追加されました。
* `JWTAuth.refresh()`の戻り値が認証インターフェースの戻り値と正確に一致するようバグが修正されました (そのために、アクセストークンのみではなく、((アクセストークン), (更新トークンまたはなし)) のタプルを返します)。特に、`JWTAuth`オブジェクトを更新しようとしたときに常に発生していた`BoxSession`の例外が修正されます。
* `ExtendableEnumMeta.__dir__()`から発生していた例外が修正されました。
* `CPython` 3.6のサポート。
* 必要最低限のバージョンが6から1.9.0に引き上げられました。
## Python SDK V2のリリース
[Box Python SDK](https://github.com/box/box-python-sdk)のメジャーアップデート (バージョン2.0) がリリースされ、重要な更新とAPI機能パリティが加えられました。完全なAPIリリースノートについては[こちらを参照してください](https://github.com/box/box-python-sdk/releases/tag/v2.0.0)。今回のリリースとともに、以下のドキュメントの変更が行われました。
* Pythonの[クイックスタートガイド](/guides/)の更新。
* Pythonの[APIリファレンス](/reference/)のコードサンプルの更新。
## 新しいBox Open With Sidebar UI Element
新しいBox UI Elementのオープンベータ版である「Open With」Elementがリリースされました。「Open With」を使用すると、開発者は、Boxに保存されたコンテンツを開くためのメニューをパートナーアプリケーションに埋め込むことができます。このベータリリースで利用可能なパートナーは、Adobe SignおよびG Suiteです。
この新しい要素のドキュメントと設定手順は、[こちら](/guides/embed/ui-elements)から入手できます。
## Java SDK v2.23.2のリリース
1. バッチヘッダーのパッチ ([#649](https://github.com/box/box-java-sdk/pull/649))
## Java SDK v2.23.1のリリース
1. 多数のリクエストを発行する際に開かれるTCP接続が多すぎる問題を修正 ([#646](https://github.com/box/box-java-sdk/pull/646))
## Excelファイルのプレビューで注釈が利用可能に
現在、注釈が有効 (`showAnnotations=true`) になっていても、[Box UI Content Preview Element](/guides/embed/ui-elements)または有効期限付き埋め込みリンクによる注釈機能がプレビューのExcelファイル内に表示されません。
**2018年9月13日**以降、ユーザーは他のファイルタイプ(PDF、doc、PPT)と同様に、Excelファイルに注釈を付けることができます。3つの注釈タイプ(ハイライト、ポイント、描画)のすべてがサポートされます。`showAnnotations`が`true`に設定されている場合、Excelファイルの注釈が表示されます。
## Windows .NET SDK v3.9.3のリリース
* アセンブリに厳密な名前付け
[`nuget.org/packages/Box.V2/3.9.3`](https://www.nuget.org/packages/Box.V2/3.9.3)
[`nuget.org/packages/Box.V2.Core/3.9.3`](https://www.nuget.org/packages/Box.V2.Core/3.9.3)
## Java SDK v2.23.0のリリース
1. メタデータカスケードポリシー ([#603](https://github.com/box/box-java-sdk/pull/603))
## フォルダを更新エンドポイントおよびフォルダ情報の取得エンドポイントに新しいフィールドを追加
[フォルダを更新APIエンドポイント](/reference/put-folders-id)の`is_collaboration_restricted_to_enterprise`に、2つのメジャーリリースが追加されました。これは、将来のコラボレーションをEnterprise内のみに制限するかどうかを設定するために作成されるブール値です。既存のコラボレーションには影響しません。このフィールドの値は、[フォルダ情報の取得エンドポイント](/reference/get-folders-id)を呼び出したときにも表示されます。
## Enterprise Eventに新しいaction\_byフィールドを追加
ユーザーアカウントで実行された管理者アクションをより適切に記録するために、Enterprise Eventのレスポンスデータに`action_by`ミニユーザーオブジェクトが追加されました。このフィールドには、該当する場合に、ユーザー操作を実行した管理者アカウントが表示されます。
Enterpriseの管理者の場合、これにはアカウントのID、ログイン、および名前が含まれます。Boxの内部管理者が実行したアクションの場合、これは以下のようになります。
* id: `box_support`
* login: `support@box.com`
* name: `Box Support`
追加のオブジェクトは、Enterpriseの[イベントオブジェクト属性](/reference/events-resources#event)内に記録されます。
## Box user\_idフィールドのサイズを変更
すべてのPlatformユーザー (管理対象ユーザー、外部管理ユーザー、App User) の追跡に使用される`user_id`フィールドは、まもなく現在の32ビット整数ではなく、64ビット整数の生成を開始するよう更新されます。
この更新は内部システムに影響するため、APIから生成された`user_id`文字列を32ビット整数フィールドに変換している場合には、新しい64ビット`user_id`の整数サイズをサポートするよう更新する必要があります。[APIドキュメント](/reference/users-resources#user)に従って、すべての`user_id`フィールドを文字列として保存することをお勧めします。
## Salesforce SDKに汎用メソッドを追加
Box for Salesforce Developer Toolkitは、パラメータとして[`HttpRequest`](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_classes_restful_http_httprequest.htm)オブジェクトを受け取り、[`HttpResponse`](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_classes_restful_http_httpresponse.htm#apex_classes_restful_http_httpresponse)オブジェクトを返すグローバルメソッド`sendRequest`を提供するようになりました。このメソッドは、サービスアカウントの認証の詳細を使用してBoxのAPIを呼び出すため、統合のビジネスロジックの組み込みに集中することができます。追加されたメソッドの詳細については、Salesforce Developer ToolkitドキュメントのBoxメタデータサイドバーの[メソッドの詳細](/guides/tooling/sdks/salesforce)および[サンプルコード](/guides/tooling/sdks/salesforce)を参照してください。
## Java SDK v2.22.0のリリース
1. 別のユーザーにコンテンツを転送するためのパッチ ([#632](https://github.com/box/box-java-sdk/pull/632))
## Relay Workflow APIの拡張
BoxとIBMで共同開発されたワークフローツール[Box Relay](https://www.box.com/collaboration/relay-workflow)の機能が、新しいWorkflow APIによって拡張されました。Relay Workflow APIを使用すると、Box Relayワークフローを起動し、アプリケーション内からそれらのワークフローのステータスを取得できます。また、Box Relayのインスタンスに直接ファイルで公開されているワークフローテンプレートを表示することもできます。APIの詳細については、Boxの[お知らせに関するブログ記事](https://medium.com/box-developer-blog/introducing-the-box-relay-workflow-api-f6eed1457711)を参照してください。
## Platform Activityの履歴のCSVレポート
ウェブサイトで新しいレポートが使用可能になりました。Box管理コンソールで、Enterpriseのプラットフォームリソースの過去の使用状況を表示するドキュメントを利用できます。このレポートには、2017年1月1日から2018年3月31日までのアプリケーションごとの月別の会社の月間アクティブユーザー、APIコール、および帯域幅消費が示されています。詳細については、[こちら](https://docs.box.com/en/box-admin-tools/reporting-and-insights/running-reports)を参照してください。
## Java SDK v2.21.0のリリース
1. `Sharedlink`パスワード ([#623](https://github.com/box/box-java-sdk/pull/623))
2. リンクを修正 ([#626](https://github.com/box/box-java-sdk/pull/626))
## Java SDK v2.20.2のリリース
1. レスポンスヘッダーで大文字と小文字の区別なし ([#620](https://github.com/box/box-java-sdk/pull/620))
## Box CLIの更新
[Box CLI](/guides/cli)への更新がリリースされました。このバージョンには以下の更新が含まれます。
* **[新しいマルチゾーンコマンド](https://github.com/box/boxcli/pull/91)**: データ保管場所用の[Box Multizones](https://blog.box.com/blog/multizones-storage-data-residency-compliance/)のサポートが追加されました。
* **[ユーザーによるCSV操作の修正](https://github.com/box/boxcli/pull/82)**: ユーザーがOpen With Elementを使用できなかったバグが修正されました。Open With Elementが、ユーザーデータのベータをCSVファイルに保存しなくなりました。
- **[フォルダの更新時に`can_non_owners_invite`を設定する機能](https://github.com/box/boxcli/pull/92)**: 所有者以外のユーザーが他のユーザーをフォルダでのコラボレーションに招待できるかどうかを設定できるようになりました。
* **[新しいCLI構成のダンプコマンド](https://github.com/box/boxcli/pull/83)**: 値をコピーして一般的な用途に使えるよう、Box構成ファイルを単一の文字列としてダンプする機能が追加されました。オプションで、エスケープ引用符を追加できます。Open Withは、環境変数または構成プロパティを (AWSの個別のボタンやAzureなどで) 提供します。
## Box Android SDK v4.2.0のリリース
このバージョンは、TLS 1.0のサポート終了後に16台以上のデバイスをサポートすることを目的としています。
## Windows .NET SDK v3.9.2のリリース
* コラボレータの招待をフォルダの所有者以外に許可するフラグの設定のサポートが追加されました。
[`nuget.org/packages/Box.V2/3.9.2`](https://www.nuget.org/packages/Box.V2/3.9.2)
[`nuget.org/packages/Box.V2.Core/3.9.2`](https://www.nuget.org/packages/Box.V2.Core/3.9.2)
## Windows .NET SDK v3.9.1のリリース
Xamarinアプリケーションの接続が切れるバグが修正されました。
[`nuget.org/packages/Box.V2/3.9.1`](https://www.nuget.org/packages/Box.V2/3.9.1)
[`nuget.org/packages/Box.V2.Core/3.9.1`](https://www.nuget.org/packages/Box.V2.Core/3.9.1)
## Java SDK v2.20.1のリリース
1. レスポンス例外でJSON解析エラーを処理 ([#615](https://github.com/box/box-java-sdk/pull/615))
2. `uploadNewVersion()`の戻りオブジェクトを修正 ([#614](https://github.com/box/box-java-sdk/pull/614))
## Java SDK v2.20.0のリリース
* メタデータフィールドの複数選択 ([#610](https://github.com/box/box-java-sdk/pull/610))
* 重複するas-userヘッダーのチェックを修正 ([#612](https://github.com/box/box-java-sdk/pull/612))
## Windows .NET SDK v3.9.0のリリース
* ストレージポリシーのサポートを追加
[`nuget.org/packages/Box.V2/3.9.0`](https://www.nuget.org/packages/Box.V2/3.9.0)
[`nuget.org/packages/Box.V2.Core/3.9.0`](https://www.nuget.org/packages/Box.V2.Core/3.9.0)
## Java SDK v2.19.0のリリース
1. マルチゾーン ([#598](https://github.com/box/box-java-sdk/pull/598))
2. `BoxCollaborator.Info`に`getLogin()`メソッドを追加 ([#602](https://github.com/box/box-java-sdk/pull/602))
3. メタデータでの`multiSelect`フィールドのサポートを追加 ([#597](https://github.com/box/box-java-sdk/pull/597))
## Windows .NET SDK v3.8.0のリリース
* ユーザーが`Xamarin`に`BoxClient`を作成できない問題を修正
* イベントの`BoxLock`オブジェクトにファイルプロパティを追加
* メタデータテンプレートを削除するための`MetadataManager.DeleteMetadataTemplate(string scope, string template)`を追加
* `BoxConfig`でAPI URLが変更可能に
* APIレスポンスエラーオブジェクト/メッセージを改善
[`nuget.org/packages/Box.V2/3.8.0`](https://www.nuget.org/packages/Box.V2/3.8.0)
[`nuget.org/packages/Box.V2.Core/3.8.0`](https://www.nuget.org/packages/Box.V2.Core/3.8.0)
## Java SDK v2.18.0のリリース
1. エラーオブジェクト ([#588](https://github.com/box/box-java-sdk/pull/588))
2. インターセプタの`request.toString()`のNPEのクイック修正 ([#595](https://github.com/box/box-java-sdk/pull/595))
3. レプリゼンテーションコンテンツ取得のサポートを追加 ([#583](https://github.com/box/box-java-sdk/pull/583))
4. `privateKeyPassword`が設定されていなかった`BoxConfig`コンストラクタメソッドを修正 ([#593](https://github.com/box/box-java-sdk/pull/593))
## Platform ActivityのCSVレポート
Box管理コンソールでEnterpriseのプラットフォームリソースの使用状況を表示するレポートを利用できるようになりました。このレポートの最初のバージョンでは、実効日である2018年4月1日までの、Boxの既存のContent APIに対するAPIコールの総数への統合が表示されます。このレポートの今後の反復では、サービスごとの追加のリソース消費(月間アクティブユーザー、帯域幅、ストレージ)が表示され、履歴データも含められます。詳細については、Box製品ドキュメントの記事レポートの実行を参照してください。
## Windows .NET SDK v3.7.0のリリース
1. メタデータテンプレートにリテンションポリシーを割り当てるためのサポートを追加
2. 列挙型に`CONTENT_ACCESS`イベントタイプを追加
[`nuget.org/packages/Box.V2/3.7.0`](https://www.nuget.org/packages/Box.V2/3.7.0)
[`nuget.org/packages/Box.V2.Core/3.7.0`](https://www.nuget.org/packages/Box.V2.Core/3.7.0)
## メタデータに基づくリテンションポリシー
[リテンションポリシーオブジェクト](/reference/retention-policies-resources#retention-policy)APIエクスプローラElementに、メタデータ駆動のリテンションポリシーをサポートする新しい機能が導入されました。この機能では、カスタムメタデータに基づいてリテンションポリシーを個々のファイルに適用できます。これにより、グローバルレベルおよびフォルダレベルに加えて、起動ファイルレベルでもリテンションポリシーを設定できます。これらの新しい拡張されたBox Governance機能は、Box管理コンソールを介してBox管理者に提供され、さらに[リテンションポリシー](/reference/retention-policies-resources#retention-policy)および[リテンションの割り当て](/reference/retention-policy-assignments-resources#retention-policy-assignment)API、BoxのJava、Node、および.NET [ SDK](/guides/tooling/sdks)でも使用できるようになります。
## Box CLI v1.2.0のリリース
* 次のコマンドの一括操作が作成されました:
* ユーザー
* 更新
* グループ
* 作成
* 更新
* 削除
* グループメンバーシップ
* 作成
* 更新
* 削除
* コラボレーション
* 追加
* 更新
* 削除
* イベントタイプによるフィルタを`box events get`および`box events poll`に追加
* ファイルやフォルダからメタデータテンプレートを削除するコマンドを追加
* 基になる`box-windows-sdk`を`v3.6.0`に昇格
* ファイルやフォルダのメタデータへの浮動小数点型の作成を妨げるバグが修正されました。
* `User-Agent` HTTPヘッダーが正しく割り当てられないバグが修正されました。
* すべてのエラーが`stderr`に報告されないバグを修正しました。
* メタデータテンプレートの一括作成に関するバグが修正されました。
* グループの`membership`コマンドでコマンドが重複するバグが修正されました。
* ユーザーの`tracking_codes`に間違ったオブジェクトが作成されるバグが修正されました。
* ユーザーの一括作成時にCSVファイルのIDが要求されるバグが修正されました。
## Java SDK v2.17.0のリリース
1. メタデータ駆動のリテンションポリシーのサポートを追加 ([#535](https://github.com/box/box-java-sdk/pull/535))
## メタデータテンプレートにmultiSelectフィールドタイプを追加
[メタデータテンプレート](/reference/metadata-templates-resources#metadata-template)に`multiSelect`と呼ばれる新しい属性タイプが導入されました。これは複数選択に変換されます。この新しい属性タイプにより、Adobe Sign、G Suite、またはフォルダでファイルコンテンツのテンプレートインスタンスを作成する際、チェックボックススタイルの値の複数選択が可能になります。
このフィールドの追加により[メタデータオブジェクト](/reference/metadata-templates-resources#metadata-template)(テンプレートインスタンス)が変更されます。これは、有効化されている`multiSelect`オプションが文字列値の配列を使用して表され、配列内の各文字列が`multiSelect`オプションのキーに対応しているためです。
## Java SDK v2.16.1のリリース
1. `CONTENT_ACCESS`イベントタイプを追加 ([#581](https://github.com/box/box-java-sdk/pull/581))
## Boxの注釈を更新
2018年3月5日に発表された注釈の更新が再び有効になりました。
## Windows .NET SDK v3.6.0のリリース
[変更ログ](https://github.com/box/box-windows-sdk-v2/blob/master/CHANGELOG.md#360)
[`nuget.org/packages/Box.V2/3.6.0`](https://www.nuget.org/packages/Box.V2/3.6.0)
[`nuget.org/packages/Box.V2.Core`](https://www.nuget.org/packages/Box.V2.Core)
## Java SDK v2.16.0のリリース
1. JWT有効期限の間隔を調整 ([#572](https://github.com/box/box-java-sdk/pull/572))
2. API接続でのカスタムヘッダーの設定を許可 ([#562](https://github.com/box/box-java-sdk/pull/562))
3. JWT再試行タイムスタンプ解析を修正 ([#575](https://github.com/box/box-java-sdk/pull/575))
4. ユーザー追跡コードのサポートを追加 ([#487](https://github.com/box/box-java-sdk/pull/487))
## Windows .NET SDK v3.5.2のリリース
.NET Coreパッケージを修正
[`nuget.org/packages/Box.V2/3.5.2`](https://www.nuget.org/packages/Box.V2/3.5.2)
[`nuget.org/packages/Box.V2.Core/3.5.2`](https://www.nuget.org/packages/Box.V2.Core/3.5.2)
## Windows .NET SDK v3.5.1のリリース
* SDKがレート制限またはサーバーエラーレスポンスを受信したときに指数バックオフに切り替えられました。
* Box APIへの接続のセキュリティを強化するため、可能な場合はTLS `v1.1`以上のサポートを強制します。
* ローカルのクロックとBoxサーバーのクロックが一致しない場合、およびJWT IDがすでに使用されている場合にJWT認証で変更された再試行を実行します。
* `RestoreTrashedAsync()`の`name`パラメータが省略可能になりました。
[`nuget.org/packages/Box.V2/3.5.1`](https://www.nuget.org/packages/Box.V2/3.5.1)
[`nuget.org/packages/Box.V2.Core/3.5.1`](https://www.nuget.org/packages/Box.V2.Core/3.5.1)
## Boxの注釈を更新
一部のユーザーからパフォーマンスの問題が報告されたため、重要なビジネスアプリケーションへの影響を防ぐために更新プログラムがロールバックされました。描画注釈およびポイント注釈モード機能は現在無効化されています。パフォーマンスの修正の予定やこれらの機能が再び有効になる時期は未定です。ご不便をおかけして申し訳ございません。
描画注釈機能を無効化される前に使用していたユーザーは、Edit. Documentation機能が再び有効化された時点で、作成した注釈にアクセスできるようになります。それまでの間、作成した注釈はアプリケーションデータストアに保存されますが、ビューアーには表示されません。
## Java SDK v2.15.0のリリース
1. コラボレーションフィールドの取得を許可 ([#570](https://github.com/box/box-java-sdk/pull/570))
2. IDによるメタデータテンプレートの取得を実装 ([#568](https://github.com/box/box-java-sdk/pull/568))
## Boxの注釈を更新
顧客がカスタムアプリケーションで使用するBox APIを介して使用できる注釈機能に、2つの拡張機能が加えられました。更新内容は以下のとおりです。
* **ポイント注釈モード**: ポイント注釈モードの導入により、ポイント注釈が強化されました。これにより、それぞれの注釈の後にポイント注釈アイコンを再選択しなくても、ドキュメントに注釈を追加できます。[こちら](/guides/embed/ui-elements)を参照してください。
* **有効期限付き埋め込みリンクによる描画注釈**: 2017年11月に描画注釈機能が追加されました。これにより、エンドユーザーがタッチ対応デバイスでタッチまたはスタイラスを使用して自由形式で描画できるようになりました。正式リリース版の注釈描画機能は、期限付き埋め込みリンクによって提供されます。Get Embed Link APIを経由して注釈を使用するユーザーは、Boxプレビューでまったく新しい表現方法を使用できるようになりました。
## Java SDK v2.14.1のリリース
1. 指数バックオフにランダム化を追加 ([#565](https://github.com/box/box-java-sdk/pull/565))
2. サポート対象時にTLSバージョン1.1以降を強制 ([#548](https://github.com/box/box-java-sdk/pull/548))
3. 連続するAPIコールを`EventStream`によって遅延 ([#564](https://github.com/box/box-java-sdk/pull/564))
## メタデータAPIへの重大な変更
2018年3月29日に、メタデータAPIエンドポイントのレスポンス本文に新しいデータ型 (文字列の配列) が導入されます。この変更は、Boxのメタデータテンプレートに`multiSelect`という新しいフィールドタイプを追加するために行われます。この新しいフィールドタイプは、ファイルまたはフォルダにテンプレートインスタンスを作成する際の、複数の値を選択するためのチェックボックスタイプを表します。このフィールドタイプでは、選択されたオプションが文字列の配列に格納されます。この配列内の各文字列が、選択された`multiSelect`オプションのキーに対応します。
以下にメタデータテンプレートのJSONレスポンス本文の例を示します。キー`audience1`の値は、この変更で導入される新しいデータ型 (文字列の配列) の例を示しています。
```js theme={null}
{
"audience1": ["internal", "internalEng"],
"documentType": "Q1 plans",
"competitiveDocument": "no",
"status": "active",
"author": "Jones",
"currentState": "proposal",
"$type": "marketingCollateral-d086c908-2498-4d3e-8a1f-01e82bfc2abe",
"$parent": "file_5010739061",
"$id": "2094c584-68e1-475c-a581-534a4609594e",
"$version": 0,
"$typeVersion": 0,
"$template": "marketingCollateral",
"$scope": "enterprise_12345"
}
```
## Java SDK v2.14.0のリリース
## Windows .NET SDK v3.21.0のリリース
1. コラボレーションオブジェクトに足りない`can_view_path`プロパティを修正 ([#560](https://github.com/box/box-java-sdk/pull/560))
2. 不足しているメソッドとドキュメントを追加 ([#559](https://github.com/box/box-java-sdk/pull/559))
3. 項目のタグを設定するためのサポートを追加 ([#554](https://github.com/box/box-java-sdk/pull/554))
## Java SDK v2.13.0のリリース
* メタデータ値の処理を改善 ([#553](https://github.com/box/box-java-sdk/pull/553))
## Java SDK v2.12.0のリリース
1. コラボレーション通知パラメータを修正 ([#545](https://github.com/box/box-java-sdk/pull/545))
2. OAuth 2.0トークン作成イベントタイプを追加 ([#533](https://github.com/box/box-java-sdk/pull/533))
3. Enterpriseへのユーザーの招待を実装 ([#504](https://github.com/box/box-java-sdk/pull/504))
4. 分析用の`X-Box-UA`ヘッダーに切り替え ([#536](https://github.com/box/box-java-sdk/pull/536))
5. 大きいファイルのアップロード時のメモリ使用量を削減 ([#543](https://github.com/box/box-java-sdk/pull/543))
## Windows .NET SDK v3.4.2のリリース
* `NuSpec`ファイルのBox SDKバージョンを更新し、`Box V2`および`Box V2.Core`の依存関係の問題を修正しました。
[`nuget.org/packages/Box.V2/3.4.2`](https://www.nuget.org/packages/Box.V2/3.4.2)
[`nuget.org/packages/Box.V2.Core/3.4.2`](https://www.nuget.org/packages/Box.V2.Core/3.4.2)
## Java SDK v2.11.0のリリース
1. 2GBを超えるファイルの分割アップロードを修正 ([#531](https://github.com/box/box-java-sdk/pull/531))
2. 更新されたファイルバージョンのアップロードエンドポイントを追加し、古いメソッドを廃止 ([#524](https://github.com/box/box-java-sdk/pull/524))
3. 一般的なJWTエラーを回避するためにJWT認証で変更された再試行を実行
## Java SDK v2.10.0のリリース
* ユーザーのメールエイリアスを追加するための`is_confirmed`パラメータ (省略可) を追加 ([#499](https://github.com/box/box-java-sdk/pull/499))
* トークン無効化のサポートを追加 ([#510](https://github.com/box/box-java-sdk/pull/510))
* メタデータテンプレートの削除 ([#512](https://github.com/box/box-java-sdk/pull/512))
## Windows .NET SDK v3.4.1のリリース
* [許可されたコラボレーションドメイン](https://developer.box.com/reference/resources/collaboration-allowlist-entry/)のサポートを追加
* イベントタイプ列挙型を追加
* `BoxRepresentationStatus`での逆シリアル化の問題を修正
[`nuget.org/packages/Box.V2/3.4.1`](https://www.nuget.org/packages/Box.V2/3.4.1)
[`nuget.org/packages/Box.V2.Core/3.4.1`](https://www.nuget.org/packages/Box.V2.Core/3.4.1)
## Java SDK v2.9.0のリリース
1. `readme`更新の検索 ([#506](https://github.com/box/box-java-sdk/pull/506))
2. アップロードの整合性のためにファイルの`SHA-1`ハッシュを渡すオプションを追加 ([#502](https://github.com/box/box-java-sdk/pull/502))
3. イベントログの制限 ([#507](https://github.com/box/box-java-sdk/pull/507))
4. サービス利用規約 ([#484](https://github.com/box/box-java-sdk/pull/484))
5. `wiremock`ポートの変更 ([#505](https://github.com/box/box-java-sdk/pull/505))
6. 冗長な`response.disconnect()`を`moveFolderToUser()`から削除 ([#485](https://github.com/box/box-java-sdk/pull/485))
7. イベントの`readme`のパッチ ([#503](https://github.com/box/box-java-sdk/pull/503))
8. 不足しているWebhookトリガーを列挙型に追加 ([#497](https://github.com/box/box-java-sdk/pull/497))
9. `MetadataTemplate.updateMetadataTemplate()`のタイプエラーを修正 ([#498](https://github.com/box/box-java-sdk/pull/498))
10. 欠落しているイベントタイプを列挙型に追加 ([#500](https://github.com/box/box-java-sdk/pull/500))
11. `modified_at`タイムスタンプを`BoxComment.Info`に追加 ([#501](https://github.com/box/box-java-sdk/pull/501))
12. コラボレーションホワイトリスト ([#492](https://github.com/box/box-java-sdk/pull/492))
13. 空の本文のごみ箱への移動のパッチ ([#495](https://github.com/box/box-java-sdk/pull/495))
14. nullの有効期限を許可することで無期限のBoxファイルロックのサポートを追加 ([#494](https://github.com/box/box-java-sdk/pull/494))
15. Batch APIに対するレスポンスの追加のテスト ([#474](https://github.com/box/box-java-sdk/pull/474))
16. `BoxDeveloperEditionAPIConnection - decryptPrivateKey() - PEMParser returns PrivateKeyInfo already - Invalid cast` [#470](https://github.com/box/box-java-sdk/pull/470)を修正 ([#471](https://github.com/box/box-java-sdk/pull/471))