Microsoft Graph でクラウド コミュニケーション API を操作する

  • [アーティクル]

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

Microsoft Graph のクラウド通信 API により、アプリとサービスのコアコミュニケーション機能が使用可能になり、自分および組織と他のユーザーの対話に新たな一面が加わります。 この API を使用して、呼び出しの作成および受信、会議座標の作成および取得、ユーザーの存在の確認を行うことができます。

クラウド通信 API を使用して、通話の参加者のように動作し、ユーザーに代わって会議を作成および取得するサービス アプリケーション (ボット) を構築し、プレゼンスの可用性とアクティビティを確認できます。 この API は、呼び出し機能と、オンライン会議を作成および取得する機能を提供します。 この API でサービス アプリケーション (ボット) を使用できます。ボットは、たとえば VoIP 通話や Microsoft Teams 会議の参加者として機能できます。

重要

Cloud Communications API を使用して、アプリケーションがアクセスする通話や会議、またはそのメディア コンテンツから派生したデータからメディア コンテンツを記録したり、保持したりすることはできません。 データ保護および通信の秘密に関する領域の法律および規制を必ず遵守してください。 詳細については、利用規約 を確認して、法律顧問にご相談ください。

承認

クラウド コミュニケーション API へのアクセスには、次のいずれかのアクセス許可が必要です。 これらのアクセス許可は管理者が承認する必要があります。

シナリオ アクセス許可
通話レコード CallRecords.Read.All
通話 Calls.JoinGroupCallAsGuest.All、Calls.JoinGroupCall.All、Calls.Initiate.All、Calls.InitiateGroupCall.All、Calls.AccessMedia.All
会議 OnlineMeetings.ReadWrite.All、OnlineMeetings.Read.All
プレゼンス Presence.Read、Presence.Read.All
仮想イベント VirtualEvent.Read、VirtualEvent.ReadWrite

一般的なユース ケース

次の表に、クラウド コミュニケーション API の一般的な用途の一部を示します。

ユース ケース REST リソース 関連項目
1-1 およびグループ通話の作成と参加 通話 通話の方法
IVR 通話 IVR の方法
通話コントロール (参加者) participant
会議 オンライン会議 会議の方法
プレゼンス プレゼンス プレゼンスのメソッド
通話レコードの取得 callRecord Webhook サブスクリプション
仮想イベント virtualEvent virtualEventTownhall のメソッド、 virtualEventWebinar のメソッド

共通プロパティ

リソース プロパティ
通話 通話プロパティ
参加者 参加者プロパティ
オンライン会議 オンライン会議プロパティ
プレゼンス プレゼンス プロパティ
callRecord callRecord プロパティ

関連コンテンツ