ディープ リンクの作成
ディープ リンクは、ユーザーが Teams および Teams アプリ内の機能や情報に接続するのに役立つナビゲーション メカニズムです。 ディープ リンクの作成が役立つシナリオは次のとおりです:
- アプリのタブの 1 つにあるコンテンツにユーザーを移動します。 たとえば、アプリには、ユーザーに重要なアクティビティを通知するメッセージを送信するボットを含めることができます。 ユーザーが通知をタップすると、ディープ リンクがタブに移動し、ユーザーがアクティビティの詳細を表示できるようになります。
- アプリは、特定のユーザー タスクを自動化または簡略化します。 ディープ リンクに必要なパラメーターを事前に設定することで、チャットを作成したり、会議をスケジュールしたりできます。 これにより、ユーザーが手動で情報を入力する必要がなくなります。
Microsoft Teams JavaScript クライアント ライブラリ (TeamsJS) を使用すると、ナビゲーションのプロセスが簡略化されます。 タブ内のコンテンツや情報への移動やチャット ダイアログの起動など、多くのシナリオで使用できます。 TeamsJS には、エクスペリエンスが向上し、ディープ リンクの使用を置き換えることができる型指定された API が用意されています。 これらの API は、他のホスト (Outlook、Microsoft 365 アプリ) で実行される可能性がある Teams アプリに推奨されます。また、使用されている機能がそのホストでサポートされていることを確認する方法も提供されます。
注:
このトピックでは、Microsoft Teams JavaScript クライアント ライブラリ (TeamsJS) のバージョン 2.0.x を反映しています。 以前のバージョンを使用している場合は、 最新の TeamsJS と以前のバージョンの違いに関するガイダンスについては、TeamsJS ライブラリの概要を参照してください。
アプリケーション プロファイル ダイアログを開き、アプリ内を移動し、ディープ リンクを生成し、 アプリケーションへのディープ リンクを使用してタブに移動できます。
チャネルの会話、チャット メッセージ、およびチャットへの ディープ リンクを通じてチャネル内のファイルに移動できます。
新しいチャットの作成、スケジュール 設定ダイアログの開き、音声ビデオ通話への移動など、Teams で 特定のタスクを実行するためのディープ リンク を作成できます。
注:
ディープ リンクの動作は、さまざまな要因に依存します。 次の一覧では、Teams エンティティに対するディープ リンクの動作の概要を示します。
タブ:
✔ ディープ リンク URL に直接移動します。
ボット:
✔ カード本体のディープリンク: 最初にブラウザで開きます。
✔ アダプティブ カードの OpenURL アクションに追加されたディープリンク: ディープリンク URL に直接移動します。
✔カード内のハイパーリンク マークダウン テキスト: 最初にブラウザで開 きます。
チャット
✔ テキスト メッセージのハイパー リンク マークダウン: ディープリンクの URL に直接移動します。
✔ 一般的なチャット会話に貼り付けられたリンク: ディープリンクの URL に直接移動します。
Microsoft 365 (Outlook/Microsoft 365 アプリ) 全体で拡張された Teams アプリのナビゲーション動作は、次の 2 つの要因に依存します。
- ディープ リンクが指すターゲット。
- Teams アプリが実行されているホスト。
Teams アプリがディープ リンクの対象となるホスト内で実行されている場合、アプリはホスト内で直接開きます。 ただし、Teams アプリがディープ リンクをターゲットとする別のホストで実行されている場合は、最初にブラウザーでアプリが開きます。