Microsoft Graph 仮想イベントのタウン ホール API を使用すると、Teams タウン ホールのデータを取得し、プログラムによって Teams タウン ホールを作成、更新、キャンセルできます。
Microsoft Graph 仮想イベントタウン ホール API を最大限に活用するには、Teams タウン ホールエクスペリエンスにアクセスするユーザーのペルソナを理解しておくと役立ちます。
- 開催者は、町役場を管理する従業員 (organization内) です。 彼らは、市庁舎がいつ行われ、誰が参加するかを知る権限です。 タイトル、テーマ、出席者エクスペリエンス、電子メール ルールなどのタウン ホールの詳細を構成します。
- 発表者は、従業員 (organization) または市庁舎を率いるゲストです。
- 出席者は、従業員 (organization内) またはタウン ホールに参加し、メールで招待されるゲスト、またはタウン ホール イベントへのリンクが共有されているゲストのいずれかです。
- Teams テナント管理者 は、適切なアクセス許可を持つカスタム アプリケーションを承認する必要があります。
次のリソースの種類を使用して、タウン ホール ソリューションを構築できます。
- virtualEventTownhall – Teams タウン ホールの作成、取得、更新、発行、取り消しに使用されます。
- virtualEventPresenter – Teams タウン ホールの発表者を作成、取得、一覧表示、更新、削除するために使用されます。
- virtualEventSession – Microsoft Graph API を介して作成されたタウン ホールには、オンライン会議のプロパティを継承する 1 つのセッションがあります。
構築できるソリューション
次の表に、Teams クライアントと Microsoft Graph タウン ホール API と Webhook を使用して構築できるソリューションの一覧を示します。
| ソリューション | Description |
|---|---|
| 作成/更新/取り消し | 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 を使用します。
作成/更新/取り消し
-
Create townhall API を使用してイベントの下書きを作成し、その後に発行タウンホール API を使用して作成を完了し、対象ユーザーに表示します。
- Microsoft Graph API を介して作成されたタウン ホールは、Teams クライアントで表示および編集できる Teams タウン ホール イベントです。
- Teams と同様に、タウン ホールを作成、発行、取り消すことができるのは、開催者だけです。 create townhall API では、開催者に代わって委任されたアクセス許可のみがサポートされます。
- Teams と同様に、共同組織はタウン ホールを更新できます。 タウン ホールを更新するには、共同組織に代わって委任されたアクセス許可を持つ タウンホール API の更新 を使用します。
データの同期
- Get townhall API を使用して、招待されたユーザー、タウン ホールを作成したユーザー、共同組織であるユーザーなど、特定のタウン ホールに関するデータをプルします。
- ユーザーがオーガナイザーまたは共同組織であるタウン ホールを含め、テナント内のすべてのタウン ホールを一覧表示します。 このシナリオは、 委任された アクセス許可と アプリケーション のアクセス許可でサポートされています。 これらの API は現在、ベータ エンドポイントでのみ使用できます。
Email通信
タウン ホールを作成するときに、出席者へのメール通信をオフにすることができます。
settings プロパティで、[isAttendeeEmailNotificationEnabled] を [false] に設定します。電子メールは、開催者、共同組織、発表者 (内部および外部) に引き続き送信されます。