Box UI Elements v13.0.0のリリース
Box UI Elements v13.0.0のリリース
13.0.0 (2021/04/22)
バグ修正と機能
このリリースでは、複数のバグが修正されます。全一覧については、リリースノートを参照してください。
Box iOS SDK v4.4.0のリリース
項目ダウンロードイベントの動作変更のお知らせ
項目ダウンロードイベントの動作変更のお知らせ
本日以降、アプリケーションがBoxのイベントAPIエンドポイントから項目ダウンロードイベントを使用した場合のこのイベントの動作に対する変更のリリースを開始します。
この変更はITEM_DOWNLOADユーザーイベントのみに影響し、既存のエンタープライズイベントには影響しません。この新しい動作により、既存のアプリケーション内でダウンタイムが発生することはありません。また、稼働時間の中断を防ぐためのアプリケーションの変更も必要ありません。
変更の概要
以前の動作では、イベントを使用した場合、ダウンロードされた項目イベントが、コンテンツの所有者およびコンテンツに割り当てられたすべてのコラボレータのイベントタイプITEM_DOWNLOADによって表示されました。つまり、2,000人のコラボレータが存在するファイルがダウンロードされた場合、このファイルの所有者に加えて2,000人のコラボレータ全員に、ファイルがダウンロードされたことを示すイベントが作成されます。
新しい動作では、項目のダウンロードに関する通知がコンテンツの所有者に対してのみ作成され、コラボレータに対しては生成されません。これは、コンテンツの所有者としていつ項目がダウンロードされたかを確認できるようにしたままイベントストリームのノイズを低減するのに役立ちます。
サポートを受けるには
問題がある場合やさらにガイドが必要な場合は、必要なサポートについて、Boxの開発者向けフォーラムにリクエストを投稿してください。
共有リンクを使用してトークンをダウンスコープするための新しいオプション
共有リンクを使用してトークンをダウンスコープするための新しいオプション
アクセストークンをリクエストする際、共有リンクを使用してそのトークンをファイルまたはフォルダにダウンスコープできるようになりました。
この新しいパラメータは、resourceパラメータの代わりに使用できます。このパラメータを使用すると、ファイルIDまたはフォルダIDを指定して同じ操作を実行できます。
更新内容
- 新しい
box_shared_linkリクエストパラメータをダウンスコープのドキュメントに追加しました。以下の方法で、共有リンクを指定してアクセストークンをダウンスコープできます。
{
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リファレンスに追加しました。
新しいメタデータクエリインデックスのエンドポイント
新しいメタデータクエリインデックスのエンドポイント
指定したテンプレートとスコープのメタデータクエリインデックスのリストを取得する新しいAPIエンドポイントが導入されました。
メタデータクエリを使用すると、ファイルやフォルダに追加されているメタデータを検索して、そのファイルやフォルダを見つけることができます。
10,000を超えるファイルやフォルダに対してメタデータクエリを実行する際に、クエリのパフォーマンスが悪いとHTTP 403エラーが発生する場合があります。検索インデックスを作成すれば、これらのクエリを大規模に実行して、このエラー状態を回避できます。また、検索インデックスは、クエリの処理中に自動的に適用されます。
この新しいエンドポイントにより、作成されたこれらの検索インデックスの参照が可能になります。
機能
このリリースでは、以下の新しいコンテンツと機能が導入されました。
- スコープやメタデータを指定してメタデータクエリインデックスのリストを取得するための新しいAPIエンドポイント。
- 新しいメタデータクエリインデックスの応答オブジェクト。
- 新しいメタデータクエリインデックス (複数) の応答オブジェクト。
更新内容
このリリースでは、次のように、コンテンツが更新されました。
- メタデータクエリインデックスのリストを取得する方法の詳細が記載されているメタデータクエリインデックスガイドを更新。
開発者コンソールへのサービスアカウントのメールアドレスの追加
開発者コンソールへのサービスアカウントのメールアドレスの追加
サーバー認証を利用するアプリケーションを管理者が承認すると、サービスアカウントの自動生成メールアドレスが開発者コンソールの [一般] タブに表示されるようになりました。その後、このメールアドレスは、Boxコンテンツでユーザーをコラボレータに設定するために使用できます。これは、必ずAutomationUser_AppServiceID_RandomString@boxdevedition.com形式になります (例: AutomationUser_123456_6jCo6Pqwo@boxdevedition.com)。
詳細については、ユーザータイプとサービスアカウントのガイドを参照してください。
機能
- サービスアカウントユーザーの自動生成メールアドレスを開発者コンソールに追加
新しいコレクションイベント
新しいコレクションイベント
外部のコレクションイベントがエンタープライズイベントストリームから使用可能になりました。
Boxのコレクションを使用すると、ファイル、フォルダ、ウェブリンクを1つのフォルダにまとめるのではなく、グループ化できます。これらの新しいイベントにより、社内で行われるコレクションの操作を監視することができます。
イベントは標準的なイベントオブジェクトスキーマに従っており、以下のようなものがあります。
COLLECTION_CREATE: コレクションが作成されましたCOLLECTION_DELETE: コレクションが削除されましたCOLLECTION_UPDATE: コレクションが更新されましたCOLLECTION_ITEM_CREATE: 項目がコレクションに追加されましたCOLLECTION_ITEM_DELETE: 項目がコレクションから削除されましたCOLLECTION_ITEM_UPDATE: コレクション内の項目が更新されました