2018 - Box Dev Docs

New featuresImpactful changesCLI

Box CLI V2のリリース

のメジャーバージョン (V2) がリリースされました。更新情報については次のリンクを参照してください。

リリースノート: 大きな修正の詳細、重大な変更、バグの修正。
コマンドの一覧: 新しいCLIで利用可能なすべてのコマンド。
: スタンドアロンインストーラとソースコードオプション。

WindowsSDKs

Windows .NET SDK v3.10.0のリリース

メタデータカスケードポリシーの機能を追加

nuget.org/packages/Box.V2 nuget.org/packages/Box.V2.Core

New featuresJavaSDKs

Java SDK v2.25.0のリリース

outputstreamを介したBoxへのコンテンツストリーミングを許可。#667

New featuresAPI

コラボレーションに未登録ユーザーを表示

ファイルまたはフォルダのコラボレータとして未登録ユーザーが追加されている場合のために、コラボレーション戻りオブジェクトにフィールドinvite_emailが追加されました。現在返されるaccessible_byオブジェクトでは未登録ユーザーの結果としてnullが表示されることから、この変更が加えられました。新しいフィールドには、ユーザーの招待に使用されたメールアドレスが表示されます。この変更は以下のエンドポイントに影響します。

これまで、未登録ユーザーを含むコラボレーションオブジェクトは以下のように表示されていました。

{
  "type": "collaboration",
  "id": "376164239",
  .....
  "accessible_by":  null
  .....
}

今回の更新により、返されるオブジェクトは以下のように表示されます。

{
  "type": "collaboration",
  "id": "376164239",
  ......
  "accessible_by":  null
  "invite_email": "sadfasdf@box.com",
  },
  ......
}

Impactful changesAPI

Enterprise Event APIにスーパーバイザ向けのcreated_byを追加

Box管理者などのスーパーバイザまたは内部管理者ユーザーがアクションを実行する場合のEnterprise Event APIエンドポイントのレスポンスオブジェクトに小さな変更が加えられました。この更新の前は、スーパーバイザまたは内部管理者ユーザーのユーザー情報がレスポンスオブジェクトのcreated_byフィールドに表示されていました。今回の更新により、そのユーザーがスーパーバイザまたは内部管理者である場合、レスポンスに一般的なユーザー情報が表示されるようになりました。これまで、レスポンスのcreated_byフィールドは以下のように表示されていました。

"created_by": {
  "type": "user",
  "id": "2030401181",
  "name": "sshah+iadev",
  "login": "admin_sshah"
}

今回の更新により、同じレスポンスが以下のように表示されます。

"created_by": {
  "type": "user",
  "id": "box_support",
  "name": "Box Support",
  "login": "support@box.com"
}

New featuresJavaSDKs

Java SDK v2.24.0のリリース

optionsオブジェクトのテストと実装を追加 (#661)
BoxItemのオブジェクトタイプを公開 (#662)
接続ごとのタイムアウトを許可 (#660)
最大リクエスト数のグローバル設定を追加 (#657)
is_ongoingフィールドにオーバーロードを追加し、is_ongoingにgetterを追加 (#653)

New featuresImpactful changesPythonSDKs

Python SDK v2.0.0 released

重大な変更

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 <https://tools.ietf.org/html/rfc3339#section-5.8> 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ドキュメントを参照してください。
- 移行: まだ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に引き上げられました。

New featuresImpactful changesPythonSDKs

Python SDK V2のリリース

Box Python SDKのメジャーアップデート (バージョン2.0) がリリースされ、重要な更新とAPI機能パリティが加えられました。完全なAPIリリースノートについてはこちらを参照してください。今回のリリースとともに、以下のドキュメントの変更が行われました。

Pythonのクイックスタートガイドの更新。
PythonのAPIリファレンスのコードサンプルの更新。

New featuresUI Elements

新しいBox UI Elementのオープンベータ版である「Open With」Elementがリリースされました。「Open With」を使用すると、開発者は、Boxに保存されたコンテンツを開くためのメニューをパートナーアプリケーションに埋め込むことができます。このベータリリースで利用可能なパートナーは、Adobe SignおよびG Suiteです。この新しい要素のドキュメントと設定手順は、こちらから入手できます。

JavaSDKs

Java SDK v2.23.2のリリース

バッチヘッダーのパッチ (#649)

JavaSDKs

Java SDK v2.23.1のリリース

多数のリクエストを発行する際に開かれるTCP接続が多すぎる問題を修正 (#646)

New featuresUI Elements

Excelファイルのプレビューで注釈が利用可能に

現在、注釈が有効 (showAnnotations=true) になっていても、Box UI Content Preview Elementまたは有効期限付き埋め込みリンクによる注釈機能がプレビューのExcelファイル内に表示されません。2018年9月13日以降、ユーザーは他のファイルタイプ(PDF、doc、PPT)と同様に、Excelファイルに注釈を付けることができます。3つの注釈タイプ(ハイライト、ポイント、描画)のすべてがサポートされます。showAnnotationsがtrueに設定されている場合、Excelファイルの注釈が表示されます。

WindowsSDKs

Windows .NET SDK v3.9.3のリリース

アセンブリに厳密な名前付け

nuget.org/packages/Box.V2/3.9.3 nuget.org/packages/Box.V2.Core/3.9.3

New featuresJavaSDKs

Java SDK v2.23.0のリリース

メタデータカスケードポリシー (#603)

New featuresAPI

フォルダを更新エンドポイントおよびフォルダ情報の取得エンドポイントに新しいフィールドを追加

フォルダを更新APIエンドポイントのis_collaboration_restricted_to_enterpriseに、2つのメジャーリリースが追加されました。これは、将来のコラボレーションをEnterprise内のみに制限するかどうかを設定するために作成されるブール値です。既存のコラボレーションには影響しません。このフィールドの値は、フォルダ情報の取得エンドポイントを呼び出したときにも表示されます。

New featuresAPI

Enterprise Eventに新しいaction_byフィールドを追加

ユーザーアカウントで実行された管理者アクションをより適切に記録するために、Enterprise Eventのレスポンスデータにaction_byミニユーザーオブジェクトが追加されました。このフィールドには、該当する場合に、ユーザー操作を実行した管理者アカウントが表示されます。Enterpriseの管理者の場合、これにはアカウントのID、ログイン、および名前が含まれます。Boxの内部管理者が実行したアクションの場合、これは以下のようになります。

id: box_support
login: support@box.com
name: Box Support

追加のオブジェクトは、Enterpriseのイベントオブジェクト属性内に記録されます。

Impactful changesAPI

Box user_idフィールドのサイズを変更

すべてのPlatformユーザー (管理対象ユーザー、外部管理ユーザー、App User) の追跡に使用されるuser_idフィールドは、まもなく現在の32ビット整数ではなく、64ビット整数の生成を開始するよう更新されます。この更新は内部システムに影響するため、APIから生成されたuser_id文字列を32ビット整数フィールドに変換している場合には、新しい64ビットuser_idの整数サイズをサポートするよう更新する必要があります。APIドキュメントに従って、すべてのuser_idフィールドを文字列として保存することをお勧めします。

SalesforceSDKs

Generic method added to the Salesforce SDK

Salesforce SDKに汎用メソッドを追加

Box for Salesforce Developer Toolkitは、パラメータとしてHttpRequestオブジェクトを受け取り、HttpResponseオブジェクトを返すグローバルメソッドsendRequestを提供するようになりました。このメソッドは、サービスアカウントの認証の詳細を使用してBoxのAPIを呼び出すため、統合のビジネスロジックの組み込みに集中することができます。追加されたメソッドの詳細については、Salesforce Developer ToolkitドキュメントのBoxメタデータサイドバーのメソッドの詳細およびサンプルコードを参照してください。

New featuresJavaSDKs

Java SDK v2.22.0のリリース

別のユーザーにコンテンツを転送するためのパッチ (#632)

API

Relay Workflow APIの拡張

BoxとIBMで共同開発されたワークフローツールBox Relayの機能が、新しいWorkflow APIによって拡張されました。Relay Workflow APIを使用すると、Box Relayワークフローを起動し、アプリケーション内からそれらのワークフローのステータスを取得できます。また、Box Relayのインスタンスに直接ファイルで公開されているワークフローテンプレートを表示することもできます。APIの詳細については、Boxのお知らせに関するブログ記事を参照してください。

Reports

Platform Activityの履歴のCSVレポート

ウェブサイトで新しいレポートが使用可能になりました。Box管理コンソールで、Enterpriseのプラットフォームリソースの過去の使用状況を表示するドキュメントを利用できます。このレポートには、2017年1月1日から2018年3月31日までのアプリケーションごとの月別の会社の月間アクティブユーザー、APIコール、および帯域幅消費が示されています。詳細については、こちらを参照してください。

New featuresJavaSDKs

Java SDK v2.21.0のリリース

Sharedlinkパスワード (#623)
リンクを修正 (#626)

JavaSDKs

Java SDK v2.20.2のリリース

レスポンスヘッダーで大文字と小文字の区別なし (#620)

CLI

Box CLIの更新

Box CLIへの更新がリリースされました。このバージョンには以下の更新が含まれます。

新しいマルチゾーンコマンド: データ保管場所用のBox Multizonesのサポートが追加されました。
ユーザーによるCSV操作の修正: ユーザーがOpen With Elementを使用できなかったバグが修正されました。Open With Elementが、ユーザーデータのベータをCSVファイルに保存しなくなりました。

フォルダの更新時にcan_non_owners_inviteを設定する機能: 所有者以外のユーザーが他のユーザーをフォルダでのコラボレーションに招待できるかどうかを設定できるようになりました。

新しいCLI構成のダンプコマンド: 値をコピーして一般的な用途に使えるよう、Box構成ファイルを単一の文字列としてダンプする機能が追加されました。オプションで、エスケープ引用符を追加できます。Open Withは、環境変数または構成プロパティを (AWSの個別のボタンやAzureなどで) 提供します。

New featuresSDKsAndroid

Box Android SDK v4.2.0のリリース

このバージョンは、TLS 1.0のサポート終了後に16台以上のデバイスをサポートすることを目的としています。

WindowsSDKs

Windows .NET SDK v3.9.2のリリース

コラボレータの招待をフォルダの所有者以外に許可するフラグの設定のサポートが追加されました。

nuget.org/packages/Box.V2/3.9.2 nuget.org/packages/Box.V2.Core/3.9.2

WindowsSDKs

Windows .NET SDK v3.9.1のリリース

Xamarinアプリケーションの接続が切れるバグが修正されました。nuget.org/packages/Box.V2/3.9.1 nuget.org/packages/Box.V2.Core/3.9.1

JavaSDKs

Java SDK v2.20.1のリリース

レスポンス例外でJSON解析エラーを処理 (#615)
uploadNewVersion()の戻りオブジェクトを修正 (#614)

New featuresJavaSDKs

Java SDK v2.20.0のリリース

メタデータフィールドの複数選択 (#610)
重複するas-userヘッダーのチェックを修正 (#612)

New featuresWindowsSDKs

Windows .NET SDK v3.9.0のリリース

ストレージポリシーのサポートを追加

nuget.org/packages/Box.V2/3.9.0 nuget.org/packages/Box.V2.Core/3.9.0

New featuresJavaSDKs

Java SDK v2.19.0のリリース

マルチゾーン (#598)
BoxCollaborator.InfoにgetLogin()メソッドを追加 (#602)
メタデータでのmultiSelectフィールドのサポートを追加 (#597)

New featuresWindowsSDKs

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 nuget.org/packages/Box.V2.Core/3.8.0

New featuresJavaSDKs

Java SDK v2.18.0のリリース

エラーオブジェクト (#588)
インターセプタのrequest.toString()のNPEのクイック修正 (#595)
レプリゼンテーションコンテンツ取得のサポートを追加 (#583)
privateKeyPasswordが設定されていなかったBoxConfigコンストラクタメソッドを修正 (#593)

New features

Platform ActivityのCSVレポート

Box管理コンソールでEnterpriseのプラットフォームリソースの使用状況を表示するレポートを利用できるようになりました。このレポートの最初のバージョンでは、実効日である2018年4月1日までの、Boxの既存のContent APIに対するAPIコールの総数への統合が表示されます。このレポートの今後の反復では、サービスごとの追加のリソース消費(月間アクティブユーザー、帯域幅、ストレージ)が表示され、履歴データも含められます。詳細については、Box製品ドキュメントの記事を参照してください。

New featuresWindowsSDKs

Windows .NET SDK v3.7.0のリリース

メタデータテンプレートにリテンションポリシーを割り当てるためのサポートを追加
列挙型にCONTENT_ACCESSイベントタイプを追加

nuget.org/packages/Box.V2/3.7.0 nuget.org/packages/Box.V2.Core/3.7.0

New featuresAPI

メタデータに基づくリテンションポリシー

リテンションポリシーオブジェクトAPIエクスプローラElementに、メタデータ駆動のリテンションポリシーをサポートする新しい機能が導入されました。この機能では、カスタムメタデータに基づいてリテンションポリシーを個々のファイルに適用できます。これにより、グローバルレベルおよびフォルダレベルに加えて、起動ファイルレベルでもリテンションポリシーを設定できます。これらの新しい拡張されたBox Governance機能は、Box管理コンソールを介してBox管理者に提供され、さらにリテンションポリシーおよびリテンションの割り当てAPI、BoxのJava、Node、および.NET SDKでも使用できるようになります。

New featuresCLI

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が要求されるバグが修正されました。

New featuresJavaSDKs

Java SDK v2.17.0のリリース

メタデータ駆動のリテンションポリシーのサポートを追加 (#535)

New featuresAPI

メタデータテンプレートにmultiSelectフィールドタイプを追加

メタデータテンプレートにmultiSelectと呼ばれる新しい属性タイプが導入されました。これは複数選択に変換されます。この新しい属性タイプにより、Adobe Sign、G Suite、またはフォルダでファイルコンテンツのテンプレートインスタンスを作成する際、チェックボックススタイルの値の複数選択が可能になります。このフィールドの追加によりメタデータオブジェクト(テンプレートインスタンス)が変更されます。これは、有効化されているmultiSelectオプションが文字列値の配列を使用して表され、配列内の各文字列がmultiSelectオプションのキーに対応しているためです。

JavaSDKs

Java SDK v2.16.1のリリース

CONTENT_ACCESSイベントタイプを追加 (#581)

API

Boxの注釈を更新

2018年3月5日に発表された注釈の更新が再び有効になりました。

New featuresWindowsSDKs

Windows .NET SDK v3.6.0のリリース

変更ログnuget.org/packages/Box.V2/3.6.0 nuget.org/packages/Box.V2.Core

New featuresJavaSDKs

Java SDK v2.16.0のリリース

JWT有効期限の間隔を調整 (#572)
API接続でのカスタムヘッダーの設定を許可 (#562)
JWT再試行タイムスタンプ解析を修正 (#575)
ユーザー追跡コードのサポートを追加 (#487)

WindowsSDKs

Windows .NET SDK v3.5.2のリリース

.NET Coreパッケージを修正nuget.org/packages/Box.V2/3.5.2 nuget.org/packages/Box.V2.Core/3.5.2

New featuresWindowsSDKs

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 nuget.org/packages/Box.V2.Core/3.5.1

Impactful changesUI Elements

Boxの注釈を更新

一部のユーザーからパフォーマンスの問題が報告されたため、重要なビジネスアプリケーションへの影響を防ぐために更新プログラムがロールバックされました。描画注釈およびポイント注釈モード機能は現在無効化されています。パフォーマンスの修正の予定やこれらの機能が再び有効になる時期は未定です。ご不便をおかけして申し訳ございません。描画注釈機能を無効化される前に使用していたユーザーは、Edit. Documentation機能が再び有効化された時点で、作成した注釈にアクセスできるようになります。それまでの間、作成した注釈はアプリケーションデータストアに保存されますが、ビューアーには表示されません。

New featuresJavaSDKs

Java SDK v2.15.0のリリース

コラボレーションフィールドの取得を許可 (#570)
IDによるメタデータテンプレートの取得を実装 (#568)

UI Elements

Boxの注釈を更新

顧客がカスタムアプリケーションで使用するBox APIを介して使用できる注釈機能に、2つの拡張機能が加えられました。更新内容は以下のとおりです。

ポイント注釈モード: ポイント注釈モードの導入により、ポイント注釈が強化されました。これにより、それぞれの注釈の後にポイント注釈アイコンを再選択しなくても、ドキュメントに注釈を追加できます。こちらを参照してください。
有効期限付き埋め込みリンクによる描画注釈: 2017年11月に描画注釈機能が追加されました。これにより、エンドユーザーがタッチ対応デバイスでタッチまたはスタイラスを使用して自由形式で描画できるようになりました。正式リリース版の注釈描画機能は、期限付き埋め込みリンクによって提供されます。Get Embed Link APIを経由して注釈を使用するユーザーは、Boxプレビューでまったく新しい表現方法を使用できるようになりました。

JavaSDKs

Java SDK v2.14.1のリリース

指数バックオフにランダム化を追加 (#565)
サポート対象時にTLSバージョン1.1以降を強制 (#548)
連続するAPIコールをEventStreamによって遅延 (#564)

Impactful changesAPI

メタデータAPIへの重大な変更

2018年3月29日に、メタデータAPIエンドポイントのレスポンス本文に新しいデータ型 (文字列の配列) が導入されます。この変更は、BoxのメタデータテンプレートにmultiSelectという新しいフィールドタイプを追加するために行われます。この新しいフィールドタイプは、ファイルまたはフォルダにテンプレートインスタンスを作成する際の、複数の値を選択するためのチェックボックスタイプを表します。このフィールドタイプでは、選択されたオプションが文字列の配列に格納されます。この配列内の各文字列が、選択されたmultiSelectオプションのキーに対応します。以下にメタデータテンプレートのJSONレスポンス本文の例を示します。キーaudience1の値は、この変更で導入される新しいデータ型 (文字列の配列) の例を示しています。

{
  "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"
}

New featuresJavaSDKs

Java SDK v2.14.0のリリース

Windows .NET SDK v3.21.0のリリース

コラボレーションオブジェクトに足りないcan_view_pathプロパティを修正 (#560)
不足しているメソッドとドキュメントを追加 (#559)
項目のタグを設定するためのサポートを追加 (#554)

New featuresJavaSDKs

Java SDK v2.13.0のリリース

メタデータ値の処理を改善 (#553)

New featuresJavaSDKs

Java SDK v2.12.0のリリース

コラボレーション通知パラメータを修正 (#545)
OAuth 2.0トークン作成イベントタイプを追加 (#533)
Enterpriseへのユーザーの招待を実装 (#504)
分析用のX-Box-UAヘッダーに切り替え (#536)
大きいファイルのアップロード時のメモリ使用量を削減 (#543)

WindowsSDKs

Windows .NET SDK v3.4.2のリリース

NuSpecファイルのBox SDKバージョンを更新し、Box V2およびBox V2.Coreの依存関係の問題を修正しました。

nuget.org/packages/Box.V2/3.4.2 nuget.org/packages/Box.V2.Core/3.4.2

New featuresJavaSDKs

Java SDK v2.11.0のリリース

2GBを超えるファイルの分割アップロードを修正 (#531)
更新されたファイルバージョンのアップロードエンドポイントを追加し、古いメソッドを廃止 (#524)
一般的なJWTエラーを回避するためにJWT認証で変更された再試行を実行

JavaSDKs

Java SDK v2.10.0のリリース

ユーザーのメールエイリアスを追加するためのis_confirmedパラメータ (省略可) を追加 (#499)
トークン無効化のサポートを追加 (#510)
メタデータテンプレートの削除 (#512)

New featuresWindowsSDKs

Windows .NET SDK v3.4.1のリリース

許可されたコラボレーションドメインのサポートを追加
イベントタイプ列挙型を追加
BoxRepresentationStatusでの逆シリアル化の問題を修正

nuget.org/packages/Box.V2/3.4.1 nuget.org/packages/Box.V2.Core/3.4.1

New featuresImpactful changesJavaSDKs

Java SDK v2.9.0のリリース

readme更新の検索 (#506)
アップロードの整合性のためにファイルのSHA-1ハッシュを渡すオプションを追加 (#502)
イベントログの制限 (#507)
サービス利用規約 (#484)
wiremockポートの変更 (#505)
冗長なresponse.disconnect()をmoveFolderToUser()から削除 (#485)
イベントのreadmeのパッチ (#503)
不足しているWebhookトリガーを列挙型に追加 (#497)
MetadataTemplate.updateMetadataTemplate()のタイプエラーを修正 (#498)
欠落しているイベントタイプを列挙型に追加 (#500)
modified_atタイムスタンプをBoxComment.Infoに追加 (#501)
コラボレーションホワイトリスト (#492)
空の本文のごみ箱への移動のパッチ (#495)
nullの有効期限を許可することで無期限のBoxファイルロックのサポートを追加 (#494)
Batch APIに対するレスポンスの追加のテスト (#474)
BoxDeveloperEditionAPIConnection - decryptPrivateKey() - PEMParser returns PrivateKeyInfo already - Invalid cast #470を修正 (#471)

​Box CLI V2のリリース

​Windows .NET SDK v3.10.0のリリース

​Java SDK v2.25.0のリリース

​コラボレーションに未登録ユーザーを表示

​Enterprise Event APIにスーパーバイザ向けのcreated_byを追加

​Java SDK v2.24.0のリリース

​重大な変更

​機能

​[その他]

​Python SDK V2のリリース

​新しいBox Open With Sidebar UI Element

​Java SDK v2.23.2のリリース

​Java SDK v2.23.1のリリース

​Excelファイルのプレビューで注釈が利用可能に

​Windows .NET SDK v3.9.3のリリース

​Java SDK v2.23.0のリリース

​フォルダを更新エンドポイントおよびフォルダ情報の取得エンドポイントに新しいフィールドを追加

​Enterprise Eventに新しいaction_byフィールドを追加

​Box user_idフィールドのサイズを変更

​Salesforce SDKに汎用メソッドを追加

​Java SDK v2.22.0のリリース

​Relay Workflow APIの拡張

​Platform Activityの履歴のCSVレポート

​Java SDK v2.21.0のリリース

​Java SDK v2.20.2のリリース

​Box CLIの更新

​Box Android SDK v4.2.0のリリース

​Windows .NET SDK v3.9.2のリリース

​Windows .NET SDK v3.9.1のリリース

​Java SDK v2.20.1のリリース

​Java SDK v2.20.0のリリース

​Windows .NET SDK v3.9.0のリリース

​Java SDK v2.19.0のリリース

​Windows .NET SDK v3.8.0のリリース

​Java SDK v2.18.0のリリース

​Platform ActivityのCSVレポート

​Windows .NET SDK v3.7.0のリリース

​メタデータに基づくリテンションポリシー

​Box CLI v1.2.0のリリース

​Java SDK v2.17.0のリリース

​メタデータテンプレートにmultiSelectフィールドタイプを追加

​Java SDK v2.16.1のリリース

​Boxの注釈を更新

​Windows .NET SDK v3.6.0のリリース

​Java SDK v2.16.0のリリース

​Windows .NET SDK v3.5.2のリリース

​Windows .NET SDK v3.5.1のリリース

​Boxの注釈を更新

​Java SDK v2.15.0のリリース

​Boxの注釈を更新

​Java SDK v2.14.1のリリース

​メタデータAPIへの重大な変更

​Java SDK v2.14.0のリリース

​Windows .NET SDK v3.21.0のリリース

​Java SDK v2.13.0のリリース

​Java SDK v2.12.0のリリース

​Windows .NET SDK v3.4.2のリリース

​Java SDK v2.11.0のリリース

​Java SDK v2.10.0のリリース

​Windows .NET SDK v3.4.1のリリース

​Java SDK v2.9.0のリリース

Box CLI V2のリリース

Windows .NET SDK v3.10.0のリリース

Java SDK v2.25.0のリリース

コラボレーションに未登録ユーザーを表示

Enterprise Event APIにスーパーバイザ向けのcreated_byを追加

Java SDK v2.24.0のリリース

重大な変更

機能

[その他]

Python SDK V2のリリース

新しいBox Open With Sidebar UI Element

Java SDK v2.23.2のリリース

Java SDK v2.23.1のリリース

Excelファイルのプレビューで注釈が利用可能に

Windows .NET SDK v3.9.3のリリース

Java SDK v2.23.0のリリース

フォルダを更新エンドポイントおよびフォルダ情報の取得エンドポイントに新しいフィールドを追加

Enterprise Eventに新しいaction_byフィールドを追加

Box user_idフィールドのサイズを変更

Salesforce SDKに汎用メソッドを追加

Java SDK v2.22.0のリリース

Relay Workflow APIの拡張

Platform Activityの履歴のCSVレポート

Java SDK v2.21.0のリリース

Java SDK v2.20.2のリリース

Box CLIの更新

Box Android SDK v4.2.0のリリース

Windows .NET SDK v3.9.2のリリース

Windows .NET SDK v3.9.1のリリース

Java SDK v2.20.1のリリース

Java SDK v2.20.0のリリース

Windows .NET SDK v3.9.0のリリース

Java SDK v2.19.0のリリース

Windows .NET SDK v3.8.0のリリース

Java SDK v2.18.0のリリース

Platform ActivityのCSVレポート

Windows .NET SDK v3.7.0のリリース

メタデータに基づくリテンションポリシー

Box CLI v1.2.0のリリース

Java SDK v2.17.0のリリース

メタデータテンプレートにmultiSelectフィールドタイプを追加

Java SDK v2.16.1のリリース

Boxの注釈を更新

Windows .NET SDK v3.6.0のリリース

Java SDK v2.16.0のリリース

Windows .NET SDK v3.5.2のリリース

Windows .NET SDK v3.5.1のリリース

Boxの注釈を更新

Java SDK v2.15.0のリリース

Boxの注釈を更新

Java SDK v2.14.1のリリース

メタデータAPIへの重大な変更

Java SDK v2.14.0のリリース

Windows .NET SDK v3.21.0のリリース

Java SDK v2.13.0のリリース

Java SDK v2.12.0のリリース

Windows .NET SDK v3.4.2のリリース

Java SDK v2.11.0のリリース

Java SDK v2.10.0のリリース

Windows .NET SDK v3.4.1のリリース

Java SDK v2.9.0のリリース