重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
通話委任 API を使用して、通信ワークフローを合理化してカスタム アプリケーションに配置する方法について説明します。 これらの API を使用すると、代理人と委任者のクエリと管理を行って、共有回線の外観やプロキシ通話などの共同通話シナリオを強化できます。
前提条件
これらの API にアクセスするには、次の構成が必要です。
アクセス許可: アクセスするためのアプリケーションに委任されたスコープを割り当てます。 次の URL を使用して、管理者アカウントでサインインし、アクセス許可を割り当てます。
https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={Client-App-ID}&response_type=code&scope=https://graph.microsoft.com/CallDelegation.Readポリシー: PowerShell を使用して Microsoft Teams で
AllowDelegationポリシーを割り当てます。Set-CsTeamsCallingPolicy -AllowDelegation $true
Teams の委任の概要
Microsoft Teams の委任により、ユーザーは代理人を割り当てて通話責任を共有できます。 代理人は、通話の受信、他のユーザーの代理通話の発信、通話設定の管理などのアクションを実行できます。 この機能は、アシスタントまたはチーム メンバーが別のユーザーの通信を処理するシナリオで役立ちます。
Microsoft Graph を使用すると、開発者はプログラムで委任者と代理人を管理できます。 一般的なシナリオは次のとおりです。
- 共有回線の外観を設定する。
- 通話を発信および受信するためのアクセス許可の管理。
- Teams 内のコミュニケーション ワークフローを合理化します。
委任者とは
委任者とは、別のユーザー (代理人) に、自分の代わりに特定のアクションを実行する機能を付与するユーザーです。 これらのアクションには、通話の発信と受信、通話設定の管理、アクティブな通話への参加が含まれます。 通常、委任者は、コミュニケーションの責任を処理する際に支援を必要とするユーザーです。
代理人とは
代理人は、委任者によって責任が割り当てられたユーザーです。 代理人は、委任者に代わって通話への応答、通話の開始、通話設定の管理などの特定のアクションを実行できます。 この役割は、シームレスなコミュニケーション ワークフローを促進するためにアシスタントやチーム メンバーによって一般的に使用されます。
一般的なユース ケース
| 操作 | 戻り値の種類 | 説明 |
|---|---|---|
| すべての代理人を一覧表示する | delegationSettings コレクション | ユーザーのすべての代理人の一覧を取得します。 |
| ID によって委任を取得する | delegationSettings | 特定の代理人に関する詳細を取得します。 |
| すべての委任者の一覧表示 | delegationSettings コレクション | ユーザーのすべての委任者の一覧を取得します。 |
| ID によって委任者を取得する | delegationSettings | 特定の委任者に関する詳細を取得します。 |
次の手順
Microsoft Graph の呼び出し委任 API を使用して、Teams の代理人と委任者に対してクエリと管理を行います。 詳細情報
- 自分のシナリオに最も役立つリソースと方法を検討する。
- Graph エクスプローラーで API を試す。