次の方法で共有


Graph API を使用して会議のトランスクリプトとレコーディングを取得する

注:

会議のトランスクリプトと録音をフェッチする API は、従量制課金 API です。 詳細については、「 会議 API の支払いモデル」を参照してください。

会議後のシナリオMicrosoft Teams会議のトランスクリプトと録音を取得するようにアプリを構成できるようになりました。 アプリでは、Microsoft Graph REST API を使用して、スケジュールされた Teams 会議用に生成されたトランスクリプトと記録にアクセスしてフェッチできます。

ユース ケース

Graph APIを使用して会議のトランスクリプトと録音をフェッチするためのユース ケースを次に示します。

ユース ケース API がどのように役立つか...
Sales 垂直の複数の会議から意味のある分析情報をキャプチャするために、トランスクリプトと記録を取得する必要があります。 すべての会議を追跡し、会議のトランスクリプトと録音を手動で取得するのは時間がかかり、非効率的です。 会議が終了したら、すべての会議の会話を調べて有用な情報を取得する必要があります。 アプリで Graph API を使用して、目的に関連するすべての会議から会議のトランスクリプトと記録を自動的に取得します。 アプリは会議の通知を受け取り、会議終了後に生成されたときにトランスクリプトと記録を取得できます。 その後、このデータを使用して次の情報を取得できます。
• 集計された分析情報とインテリジェンス分析
• 新しい潜在顧客とハイライト
• 会議のフォローアップと概要
人事イニシアチブとして、従業員の健康と生産性を理解し、改善するためのブレーンストーミング セッションを開催しています。 会議後の概要を提供するために継続的にメモを取る必要があると、考えの流れが妨げられ、すべての貴重な提案をキャプチャできない場合があります。 セッションの後は、改善計画を立てるために、ディスカッションを分析してデータ ポイントを収集する必要があります。 アプリで Graph API を使用してトランスクリプトとレコーディングをフェッチすると、会議後にあなたと参加者がディスカッションに完全に集中できるようになります。 会議のトランスクリプトと記録の内容は、次の目的で利用できます。
• エンゲージメントとセンチメントの分析
• タスクまたは問題のリスト
• フォローアップ会議と通知
大手ハイテク企業の営業担当者は、クライアントとつながり、取引を成立させなければなりません。 Teams と Outlook の予定表を通じて多数の会議がスケジュールされているため、すべての通話に出席し、ディスカッションや最新の更新プログラムを常に更新することが重要です。 次の機能を使用してアプリを作成します。
• Teams または Outlook の予定表を使用して会議がスケジュールされている場合に通知します。
• アプリでこれらの会議の AutoRecording=true を設定できるようにします。
• 会議の参加者としてボットを追加して、会議が記録されていること、およびコンテンツがアプリによって分析に使用されていることを示すバナーを表示します。
•アプリが会議の記録やトランスクリプトにアクセスすることを許可します。
•これらのアクセス許可の管理者の承認を取得するには時間がかかる可能性がありますように、 OnlineMeetingRecording.Read.All のアクセス許可の管理者の承認を必要とせずにアプリを許可します。
このユース ケース シナリオを紹介する サンプル アプリ を次に示します。

会議のトランスクリプトと録音を取得する

特定の会議のトランスクリプトと記録を取得するには:

  1. トランスクリプトと記録にアクセスするためのMicrosoft Entra IDに対するアクセス許可を構成する
  2. 会議のトランスクリプトと録音が利用可能になったときに通知を受け取る
  3. Graph API を使用してトランスクリプトをフェッチする
  4. Graph API を使用して記録をフェッチする

トランスクリプトと記録にアクセスするためのMicrosoft Entra IDに対するアクセス許可を構成する

アプリには、トランスクリプトと記録をフェッチするために必要なアクセス許可が必要です。 Organization全体のアプリケーションのアクセス許可または特定の会議のリソース固有の同意 (RSC) アプリケーションのアクセス許可を使用して、Teams 会議のトランスクリプトと記録にアクセスして取得できます。

組織全体のアプリケーションのアクセス許可を使用する

テナント全体で会議のトランスクリプトと録音にアクセスするようにアプリを構成できます。 この場合、会議の開催者は Teams 会議チャットにアプリをインストールする必要はありません。 管理者がorganization全体のアプリケーションアクセス許可を承認すると、アプリはテナント内のすべての会議のトランスクリプトと記録を読み取り、アクセスできます。

アプリに付与できるorganization全体のアプリケーションアクセス許可の詳細については、「オンライン会議のアクセス許可」を参照してください。

会議固有の RSC アプリケーションのアクセス許可を使用する

アプリがインストールされている Teams 会議のトランスクリプトと録音のみを取得する場合は、アプリの会議固有の RSC アクセス許可を構成します。 承認されたユーザーは、会議チャットでアプリをインストールできます。 会議が終了すると、アプリで API 呼び出しを行って、その会議のトランスクリプトと記録を取得できます。

会議固有の RSC アクセス許可の詳細については、「 チャットまたは会議の RSC アクセス許可」を参照してください。

トランスクリプトまたは記録が利用可能になったときに通知を受け取る

アクセス許可を構成したら、利用可能な場合、またはすべての関連する会議イベントのトランスクリプトと録音の 変更通知 を受け取るアプリを構成します。 通知には、トランスクリプトのコンテンツへのアクセスと記録に役立つ会議 ID と開催者 ID が含まれています。 アプリは、会議の終了後に生成されたときに、会議のトランスクリプトと記録をフェッチできます。 トランスクリプトの内容は、 .vtt ファイルとして使用できます。 会議の記録は、 .mp4 ファイルとして使用できます。

アプリには、次の種類の変更通知を使用できます。

サブスクリプション スコープ 説明 サポートされるリソースのパス
テナントのレベル トランスクリプトまたは記録は、テナントのオンライン会議で使用できます。 • organization内のすべてのトランスクリプト:communications/onlineMeetings/getAllTranscripts
•organization内のすべての録音:communications/onlineMeetings/getAllRecordings
会議レベル トランスクリプトまたはレコーディングは、特定のオンライン会議で利用できます。 • 特定の会議のすべてのトランスクリプト: communications/onlineMeetings/{onlineMeetingId}/transcripts
• 特定の会議のすべての録音: communications/onlineMeetings/{onlineMeetingId}/recordings
ユーザー スコープ トランスクリプトまたはレコーディングは、特定のユーザーが開催するオンライン会議で使用できます。 • 特定のユーザーが開催した会議で利用できる通話トランスクリプト: users/{userId}/onlineMeetings/getAllTranscripts
• 特定のユーザーが開催した会議で使用可能になる通話記録: users/{userId}/onlineMeetings/getAllRecordings
アプリスコープ トランスクリプトまたはレコーディングは、特定の Teams アプリがインストールされている会議で使用できます。 • 特定の Teams アプリがインストールされている会議で使用できる通話トランスクリプト: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts
• 特定の Teams アプリがインストールされている会議で使用可能になる通話記録: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

オンライン会議が終了した後にトランスクリプトまたはレコーディングを利用できるタイミングをアプリで認識する方法の詳細については、「 トランスクリプトと録音が使用可能になったときに通知を受け取る」を参照してください。

会議がいつ終了するかをアプリで認識する方法の詳細については、「 変更通知をサブスクライブする 」および 「Bot Framework を使用して会議 ID と開催者 ID を取得する」を参照してください。

注:

Graph API を呼び出してトランスクリプトと記録にアクセスおよび取得するプロセスは、会議固有の RSC アプリケーションのアクセス許可とorganization全体のアプリケーションのアクセス許可の両方で変わりません。 これらの API は、ベータ版でのみプライベート チャット会議とチャネル会議をサポートします。

AI で生成された会議の概要を取得する

アプリでは、会議AI 分析情報 API を使用して、会話の概要、アクション アイテム、メンションなど、AI によって生成された会議の概要を直接フェッチできます。 詳細については、「会議AI 分析情報 API を使用して会議の分析情報を取得する」を参照してください。

コード サンプル

サンプルの名前 説明 Node.js C#
会議トランスクリプト ボット このサンプル アプリでは、Microsoft Graph APIを使用して会議のトランスクリプトを取得し、ダイアログに表示します。 表示 表示
会議のトランスクリプトの記録 このサンプル アプリでは、Graph API を使用して Teams 会議のトランスクリプトとレコーディングを取得します。 表示 表示

次の手順

関連項目