Microsoft Graph 仮想イベント ウェビナー API を使用すると、Teams ウェビナー データを取得し、プログラムによって Teams ウェビナーを作成、更新、キャンセルできます。
Graph 仮想イベント ウェビナー API を最大限に活用するには、Teams ウェビナー エクスペリエンスにアクセスするユーザーのペルソナを理解しておくと役立ちます。
- 開催者は、ウェビナーを管理する従業員 (organization内) です。 彼らはスケジュールと参加者の権限です。 タイトル、テーマ、出席者エクスペリエンス、電子メール ルールなどのウェビナー属性を構成します。
- 発表者は、従業員 (organization) またはウェビナーをリードするゲストです。
- 登録者は、ウェビナーに登録したユーザー (organization内または外部) です。 登録、待機リスト、拒否を行うことができます。 ウェビナーの登録を取り消すことができます。
- 出席者 は、ウェビナーに参加した登録者です。 ポータルを使用して登録し、登録の質問に回答する必要があります。
- Teams テナント管理者 は、適切なアクセス許可を持つカスタム アプリケーションを承認する必要があります。
次のリソースの種類を使用して、ウェビナー ソリューションを構築できます。
- virtualEventWebinar – Teams ウェビナーの作成、取得、更新、発行、取り消し、一覧表示に使用されます。
- virtualEventRegistration – ウェビナーの登録者の登録レコードを作成、取得、取り消し、一覧表示するために使用されます。 登録された登録者の一意の Teams ウェビナー参加 URL を提供します。
- virtualEventRegistrationQuestion – ウェビナーに登録するときに、登録者が回答するカスタム登録の質問または定義済みの登録の質問を作成、一覧表示、削除するために使用されます。
- virtualEventRegistrationConfiguration – ウェビナーの登録ポータル URL を格納するウェビナー登録構成に関する情報が含まれます。
- virtualEventPresenter – Teams ウェビナーの発表者を作成、取得、一覧表示、更新、削除するために使用されます。
- virtualEventSession – Microsoft Graph API を介して作成されたウェビナーには、オンライン会議のプロパティを継承するセッションが 1 つだけです。
- meetingAttendanceReport – ウェビナーが終了するたびに、セッションの出席レポートが生成されますが、出席者データは含まれません。
- attendanceRecord – 出席レポートにウェビナーの出席者データを提供します。
- 仮想イベント Webhook – ウェビナー、ウェビナーの登録、セッション、出席レポートなどの変更に関する通知を受け取ることができます。
構築できるソリューション
次の表に、Teams クライアントと Microsoft Graph ウェビナー API と Webhook を使用して構築できるソリューションの一覧を示します。
| ソリューション | Description |
|---|---|
| 作成/更新/取り消し | Teams ウェビナーをプログラムで作成、更新、取り消します。 |
| データの同期 | カスタム アプリケーション (出席者、登録の質問、出席レポートなど) で Teams ウェビナー データをプルします。 |
| 登録 | Teams ウェビナー用に独自の登録ポータル エクスペリエンスをホストし、登録データを Teams クライアントに同期します。 |
| Email通信 | 独自の電子メール インフラストラクチャを使用して、ウェビナー関連の通知メールを送信します。 |
注:
Microsoft Graph ソリューションをビルドするには、アプリケーションに適切なアクセス許可を登録して付与する必要があります。 詳細については、「 認証と承認の基本」を参照してください。
仮想イベントに対するリソース固有の同意 (RSC)
リソース固有の同意 (RSC) を使用すると、アプリはグローバル管理者特権を必要とするのではなく、特定のウェビナーまたはタウン ホールにスコープを設定したアクセス許可を要求できます。 RSC のアクセス許可により、セキュリティが向上し、同意フローが簡素化され、開発者は組織の境界を尊重する統合を構築できます。
有効な Microsoft Graph 仮想イベント API と RSC アクセス許可
| RSC アクセス許可 | API | Description |
|---|---|---|
| VirtualEvent.Read.Chat | ウェビナー と タウン ホール | スケジュール、講演者、イベント設定、ウェビナーの登録など、このウェビナーまたはタウン ホールの情報をお読みください。 |
| OnlineMeetingArtifact.Read.Chat | 出席レポート と 出席記録 | このウェビナーまたはタウン ホールの出席レポートと出席記録を読む。 |
| VirtualEventRegistration-Anon.ReadWrite.Chat | 仮想イベント登録 | 出席者を登録し、このウェビナーの登録を取り消します。 |
従来の認証フロー
RSC が不要または実現可能な場合は、次の従来の OAuth フローを使用できます。
- アプリ専用トークン フロー: ユーザー コンテキストなしでアプリが動作するバックエンド サービスまたは自動化シナリオに使用します。
- 委任された (ユーザー) トークン フロー: アクションにユーザー コンテキストと同意が必要な場合に使用します。
RSC と従来のトークン フローを使用するタイミング
| シナリオ | 推奨されるアプローチ |
|---|---|
| アプリは、特定のウェビナーまたはタウン ホールにのみアクセスする必要があります | RSC |
| アプリでは、複数のイベントへのテナント全体のアクセスが必要です | アプリ専用トークン フロー |
| イベントを管理する開催者などのユーザー主導のアクション | 委任されたトークン フロー |
| コンプライアンスまたはセキュリティの要件には最小限の特権が必要です | RSC |
RSC アクセス許可の使用の概要
次の手順では、アプリの設定と RSC アクセス許可の使用を開始する方法について説明します。
- アプリを登録し、アプリ マニフェストで RSC アクセス許可を定義します。
- Teams 開発者ポータルまたはパートナー センターを使用してアプリを発行します。
- 管理は、Teams 管理センターで RSC を許可します。
- スコープ付きアクセス許可を持つウェビナーやタウン ホールには、Microsoft Graph API を使用します。
作成/更新/取り消し
-
ウェビナー API の作成を使用してイベントの下書きを作成し、続いてウェビナー API を発行して作成を完了し、対象ユーザーに表示します。
- Microsoft Graph API を使用して作成されたウェビナーは、Teams クライアントで表示および編集できる Teams ウェビナーです。
- Teams と同様に、開催者のみがウェビナー イベントを作成、発行、取り消すことができます。 ウェビナー作成 API では、開催者に代わって委任されたアクセス許可のみがサポートされます。
- Teams と同様に、共同組織はウェビナーを更新できます。 ウェビナーを更新するには、共同組織に代わって委任されたアクセス許可を持つ ウェビナー API の更新 を使用します。
- 変更通知をサブスクライブして、ウェビナーに加えられた変更に関する更新を取得します。
データの同期
- 変更通知をサブスクライブして、ウェビナーに加えられた変更に関する更新を取得します。
- ウェビナーの出席レポート データを取得するには、[ 出席レコードの一覧表示] または [ クエリ オプションを使用して出席レコードを取得する] を使用します。
- 特定のウェビナーのデータを取得し、テナント内のすべてのウェビナーを一覧表示し、ユーザーがオーガナイザーまたは共同開催者であるウェビナーを一覧表示し、指定したユーザーが開催者または共同組織であるウェビナーを一覧表示します。
- ウェビナーの Teams ウェビナー登録ポータル URL を取得するには、 ウェビナー登録構成の取得を使用します。
登録
- [ 登録の作成] を 使用して、プログラムによってユーザーをウェビナーに登録します。 開催者、共同編集者、発表者は登録する必要はありません。 登録者にMicrosoft Entraアカウントがあるかどうかは、API を呼び出すために必要なアクセス許可に影響します。
- CREATE 登録の質問 (定義済みまたはカスタム) の出席者は、登録中に必要な質問に回答する必要があります。
- 登録者がウェビナーに登録したら、 List セッション を使用してウェビナーの一意の
joinWebURLを取得します。