Microsoft Graph で API を選択してオンライン会議を作成して参加する

Microsoft Graph には、Microsoft Teams または Skype でオンライン会議を調整して参加する 2 つの API セットが用意されています:

• カレンダー API: イベント リソースを使用します。
• クラウド通信 API: onlineMeeting リソースを使用します。

選択の範囲:

• Outlook カレンダーでオンライン会議を設定し、参加者がクリックして会議に参加し、Teams または Skype での操作を継続できる便利なプログラムによる方法。
• さらに、よりカスタマイズされたエクスペリエンスを実現する、アプリ内の Teams または Skype 機能のより充実したプログラム的統合。

シナリオ用の API を選択する際の考慮事項

カレンダー API を選択すると、Outlook カレンダーとの合理化されたビルトイン統合を実現し、Outlook カレンダー内でオンライン会議イベントを生成できます:

• プログラムによるサポート:
  • アプリは、Outlook カレンダー イベントに参加 Teams 会議の BLOB を挿入して、Outlook カレンダーのオンライン会議としてイベントを直接作成または更新できます。
  • アプリは、インターネット経由またはダイヤル インによって、会議に参加するためのプロパティを取得します。
• プログラムで作成されたカレンダー イベントを使用した参加者の UI エクスペリエンスは、Outlook UI を介して作成されたすべてのイベントと完全に同等です。
  • 参加者は、オンラインで、または直接会うことを選択できます。
  • 参加者は、参加 Teams 会議の BLOB をクリックして、インターネット経由またはダイヤル インによって会議に参加できます。
  • 参加者は、構成されている場合、ビデオ会議や会議ロビーなど、Teams の他の豊富な機能を使用できます。

注:

Outlook カレンダーとの統合は、管理者が Outlook をオンライン会議用に設定していることを前提としています。 API を使用する前に、サポートを 確認 します。

柔軟性と幅広いプログラムのサポートのためにクラウド通信 API を選択します:

• アプリには、API の結果を基幹業務やその他のアプリとさらに統合するための柔軟性があります。 API は特定のカレンダーと分離されており、どのカレンダーにもイベントを作成しません。
• アプリは、参加者に次の機能を提供できます:
  • ロケールベースの結合情報。
  • インターネット経由またはダイヤル インによって、会議に参加。
  • ビデオ会議。
  • 会議ロビーや参加者の自動承諾 (プレビュー) などの追加のセキュリティ機能。
  • Microsoft Teams チャットを使用した会議の関連付け。

API の比較

次の表では、API レベルの違いについて説明します。

オンライン会議機能	カレンダー API (イベント リソース)	クラウド コミュニケーション API (onlineMeeting リソース)
主な API メンバー	イベント リソース: - isOnlineMeeting プロパティ onlineMeetingInfo タイプの - onlineMeeting プロパティ - onlineMeetingProvider プロパティ カレンダー リソース: - allowedOnlineMeetingProviders プロパティ - defaultOnlineMeetingProvider プロパティ	onlineMeeting リソース audioConferencing リソース
カレンダー アイテムとの統合	- イベント API を作成または更新すると、結果の Outlook 予定表イベントがオンライン会議として自動的に設定されます。 - 返された Outlook カレンダー イベント の isOnlineMeeting、onlineMeeting、onlineMeetingProvider プロパティを使用します。	API を - 作成 すると、特定のカレンダーの種類に依存しない onlineMeeting リソースを返します。 - Outlook のイベントは作成または更新されません。 - 返された onlineMeeting リソース情報を、シナリオに適したアプリ エクスペリエンスに統合します。 - createOrGet を使用して、指定した externalId 値を持つオンライン会議を返します。または、まだ存在しない場合は会議を作成して、その会議を効率的にサードパーティのカレンダーに埋め込みます。
オフライン会議に変更	- いいえ - オンラインに参加するために イベント を有効にした後は、イベントを更新してオフラインの会議にすることはできません。 - onlineMeetingProvider プロパティを変更することも、isOnlineMeeting を false に設定してオンラインで会議を無効にすることもできなくなります。	いいえ - onlineMeeting リソースを作成した後は、削除することはできますが、オフラインの会議に変更することはできません。
ロケールベースの結合情報	直接の API 統合はありません。	- オンライン会議を作成するときに、Accept-Language HTTP ヘッダーを使用します。 - 例 を参照してください。
インターネット (VoIP) を経由した結合	onlineMeeting プロパティを使用して、joinUrl にアクセスします。	joinWebUrl プロパティを使用します。
ダイヤルインでの参加	onlineMeeting プロパティを使用して、アクセスします: - conferenceId、quickDial、phones、tollFreeNumbers、tollNumber。	audioConferencing プロパティを使用して、アクセスします: - conferenceId、tollFreeNumber、tollNumber。 サードパーティ製のアプリとの統合を容易にするダイヤルイン情報を含む、外部からアクセス可能な Web ページの - dialinUrl プロパティ。
ビデオ会議 (オーディオとビデオ) による参加	直接の API 統合はありません。	videoTeleconferenceId プロパティを使用します。
会議ロビーとオンライン会議への参加者の自動承認	- 直接の API 統合はありません。 - イベントの挿入された参加 Teams 会議の BLOB で、参加者は管理者によって有効にされている場合、[ミーティング オプション] リンクをクリックして会議ロビーにアクセスできます。	- API は、参加者を主催者の会社や連合会社、および匿名の参加者を含む他の参加者と区別します。 - lobbyBypassSettings プロパティを使用します 。
Teams チャットに関連	直接の API 統合はありません。	chatInfo プロパティを使用します。