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 プロパティ |