日本時間5月16日のContent Cloud Summitで、カスタムアプリにBox AI APIを活用する方法を紹介します。

詳細を表示
Box Developerドキュメント
ログイン

ウェブアプリ統合の作成

ガイド アプリケーション ウェブアプリ統合 ウェブアプリ統合の作成

ウェブアプリ統合の作成

このガイドでは、カスタムアプリとのウェブアプリ統合を設定する方法について説明します。

サーバー側統合のサポートは終了しました。つまり、サーバー側の処理を使用するアプリケーションは引き続き動作しますが、事前コールバックのURLやBasic認証など、サーバー側の構成オプションを変更することはできなくなります。これらのオプションを無効化し、実装を新しいものに変更できます。

OAuth 2.0アプリケーションの作成

開発者コンソールに移動し、OAuth 2.0認証を利用するカスタムアプリを作成します。

新しい統合の作成

次に、[統合] タブに移動し、[ウェブアプリ統合を作成] をクリックします。

[統合] タブ

統合の構成

統合を構成するには、各値について、以下のガイダンスに従います。

アプリ情報

フィールド説明
統合名統合の名前。ユーザーがファイルまたはフォルダの [その他のオプション] > [統合] メニューを選択したときにBoxウェブアプリに表示されます。
説明Box App Centerに表示される統合の説明。
サポートされているファイル拡張子統合は、選択されているファイル拡張子の [その他のオプション] > [統合] メニューのオプションとしてのみ表示されます。
必要な権限ユーザーが統合を表示するために必要な権限を決定します。[ダウンロードの権限が必要] にした場合、ユーザーはファイルをダウンロードできますが、そのファイルを更新することはできません。[すべての権限が必要] にした場合、ユーザーはファイルのダウンロードと更新を行えます。
統合の範囲統合の範囲を指定します。統合の呼び出し元となるファイル/フォルダ、またはその親フォルダを指定します。
[共有ページで表示] の切り替え共有ページで外部ユーザーに統合を表示可能にするかどうかを決定します。有効にした場合、コンテンツでコラボレーションしていないユーザーが共有リンクを介して項目にアクセスすると、コンテキストメニューに統合が表示されます。
[ロックして、この統合を使用したファイルの上書きを現在のユーザーにのみ許可] の切り替え異なるウェブアプリ統合でファイルを同時に編集可能にするかどうかを決定します。
統合の種類必要な統合の種類を選択します。使用できるオプションは、[ファイル]、[フォルダ]、[両方] です。

コールバック構成

フィールド説明
クライアントコールバックのURLポップアップ統合での最初のリクエストの後に、Boxからの追加のコールバックリクエストを処理します。アプリケーションがRESTメソッドでファイルパラメータを指定した場合、事前コールバックのURLはクライアントから発信できません。そのため、必要なインターフェースをサーバーがユーザーに送信できるように、2番目のリクエストがクライアントからサーバーに送信される必要があります。
ユーザーエクスペリエンス統合が新しいウィンドウで開くことを通知します。
新しいウィンドウの設定アプリケーションを新しいタブで開くかどうかを決定します。

コールバックパラメータ

[コールバックパラメータ] セクションでは、ユーザーが確認プロンプトを受け入れるとBoxからコールバックURLに送信されるパラメータを構成します。この設定が構成されていない場合、BoxからコールバックURLにパラメータが送信されません。パラメータを追加するには、[メソッド] を選択し、[パラメータ名] を指定して、[パラメータ値] を追加します。使用可能なメソッドはGetとPostです。

Fileメソッドのサポートは終了しました。すでにこのメソッドを使用している場合は、その値を編集できません。FileメソッドをGetまたはPostに変更することはできますが、この操作を元に戻すことはできません。

例: Get - userid - #user_id#。

以下のパラメータ値が使用可能です。

パラメータ説明
user_idBoxユーザーID。この情報は、アクションを完了するためにユーザー認証が必要なポップアップ統合で使用されます。Box IDをアプリケーションに保存すると、統合からの後続の認証リクエストを有効にできます。
user_nameBoxユーザーのフルネームまたはメールアドレス。Boxユーザーが常に自分の名前を指定しているとは限りません。
file_idBoxファイルID。このIDを使用すると、ファイルを操作するBox APIコールを実行できます。
file_nameファイルの名前。
file_extensionファイルの拡張子。
auth_codeOAuth 2.0承認コード。これは、認証の成功時にBoxによって生成されます。その後、アプリケーションは、この承認コードをOAuth 2.0アクセストークンの代わりにBoxに指定する必要があります。有効なアクセストークンが含まれた承認ヘッダーをすべてのBox APIリクエストに含める必要があります。
redirect_to_box_urlポップアップ統合で、確認プロンプトによるリクエストの送信先となるURL。このURLを使用すると、ユーザーは [すべてのファイル] ページにリダイレクトされます。このパラメータにより、ポップアップパネルが閉じ、[すべてのファイル] ページは、統合による変更をすべて反映するよう更新されます。このパラメータをアプリケーションに追加しない場合は、URL全体を指定できます。成功: #redirect_to_box_url#&status=success&message=Your%20action%20was%20successful%2E。失敗: #redirect_to_box_url#&status=failure&message=Your%20action%20was%20unsuccessful%2E

統合ステータス

  • 開発: 統合は、[一般設定] タブで表示されるアプリケーションコラボレータのみが表示および使用できます。このオプションは、アプリケーションがまだ開発中でテストの実施中である場合に最もよく使用されます。
  • オンライン: 統合は、すべてのBoxユーザーが表示し、使用できます。このオプションは、開発が完了し、アプリケーションをApp Centerで公開する準備ができている場合に最もよく使用されます。
  • メンテナンス: 統合は、[一般設定] タブで表示されるアプリケーションコラボレータのみが表示し、使用できます。このオプションは、統合がApp Centerで公開された後、メンテナンスでの更新を実行したり問題をトラブルシューティングしたりする必要がある場合に最もよく使用されます。このオプションを使用すると、アプリケーションのコラボレータ以外のすべてのユーザーに対して統合が一時的にオフラインになります。

Box統合のユースケースの例

ユーザーがポップアップ統合を選択すると、Boxから事前コールバックのURLにコールバックリクエストが送信されます。これにより、構成済みのコールバックパラメータがサーバーに送信されます。クライアントが必要なデータを最初のリクエストからすべて取得できない場合は、Boxが2番目のリクエストを送信することもあります。

次の例では、クライアントコールバックのURLが必要ありません。

  • ポップアップ統合で、download_file_urlコールバックパラメータを使用してREST呼び出しを実行する。
  • ユーザーが確認プロンプトで [OK] をクリックしてポップアップを受け入れる。
  • Boxが次のURLにリクエストを送信する (事前コールバックのURLにコールバックパラメータを追加): http://www.doceditor.com/service?apikey=abc&file=&redirect=。
  • コールバックURLからのレスポンスにより、リクエストを送信したユーザーにユーザーインターフェースが表示される。ポップアップには、アクションを続行するために必要なすべての情報が表示されているため、追加のクライアントコールバックは必要ありません。

次の例では、クライアントコールバックのURLが必要です。

  • ポップアップ統合で、ファイルコールバックパラメータを使用してREST呼び出しを実行する。
  • ユーザーが確認プロンプトで [OK] をクリックしてポップアップを受け入れる。
  • ポップアップによって表示されたページで、Boxからリモートサーバーに、ファイルのコンテンツを含むPOSTリクエストとともにコールバックパラメータが送信される。
  • Boxがリモートサーバーからレスポンスを受信し、クライアントにクライアントコールバックのURLへのレスポンスを投稿するよう指示する。このURLで識別されたサーバーがレスポンスを解釈し、適切なセッションIDを持つユーザーをリダイレクトします。

クライアントコールバックのURLのリクエスト形式

BoxからクライアントコールバックのURLに送信されるPOSTリクエストは、事前コールバックのURLからレスポンスを取得し、元のコールバックと同じデータとともにレスポンスを同じURLに転送します。

クライアントコールバックのURL例
2つのGETパラメータと1つのPOSTパラメータ: http://your-client-callback-url.com/?get_param1=value1&get_param2=value2POST data: post_param1=value1initial_callback_response

クライアントコールバックリクエストへのレスポンスはHTTPステータス302で、ユーザーは正しいURLにリダイレクトされるか、UIのHTMLにリダイレクトされます。

ほとんどの場合、このURLは、ウェブアプリ統合のために開発された個々のAPIまたはカスタムスクリプトを指します。これは、事前コールバックのURLの結果を解析します。また、このURLは、インターネット上で一般公開する必要があることに注意してください。

統合の一般公開

Box統合を一般公開するには、統合をApp Centerに掲載する必要があります。詳細については、App Centerガイドに従ってください。