call リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
呼び出しリソースは、アプリケーションの着信呼び出しがある場合、またはアプリケーションがapp/callsのPOSTを介して新しい発信呼び出しを作成するときに作成されます。
通話はピアツーピアまたはグループ通話として設定できます。 グループ通話の作成またはグループ通話への参加を行うには、chatInfo と meetingInfo を指定します。 これらが指定されていない場合は、新しいグループ呼び出しが自動的に作成されます。 着信の場合、高可用性ストアにこれらの値が記録されるので、アプリケーションがクラッシュしたときに、アプリケーションが通話に再度参加できるようになります。
同じ ID を複数回招待することはできませんが、アプリケーションが同じ会議に複数回参加する可能性があります。 アプリケーションが参加を求める際は、毎回異なる ID を指定する必要があります。これにより、別々の参加者としてクライアントに表示されます。
注: 参加 URL は、Microsoft Teams を使用してスケジュールを行った会議から入手できます。 次に示される方法で、
chatInfoおよびmeetingInfoとして入力するためのデータを URL から抽出します。
https://teams.microsoft.com/l/meetup-join/19%3ameeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%224b444206-207c-42f8-92a6-e332b41c88a2%22%7d
次のようになります。
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk@thread.v2/0?context={"Tid":"72f988bf-86f1-41af-91ab-2d7cd011db47","Oid":"4b444206-207c-42f8-92a6-e332b41c88a2"}
注:
このリソースには、次の既知の問題が関連付けられています。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | 通話 | 呼び出しを作成すると、ボットは新しい発信ピアツーピア通話またはグループ通話を作成したり、既存の会議に参加したりできます。 |
| Get | call | call オブジェクトのプロパティを読み取ります。 |
| 削除/切断する | なし | アクティブな call を削除または切断します。 |
| キープ アライブ | なし | 通話でアクティブな状態を継続させます。 |
| Call 処理 | ||
| 応答する | なし | 着信に応答します。 |
| 拒否する | なし | 着信を拒否します。 |
| リダイレクトする | なし | 着信をリダイレクトします。 |
| 転送する | なし | 通話の転送 |
| グループ通話 | ||
| List | participant コレクション | participant オブジェクト コレクションを取得します。 |
| 参加者を招待する | commsOperation | アクティブな通話に参加者を招待します。 |
| すべての参加者をミュートする | commsOperation | 通話ですべての参加者をミュートします。 |
| 参加者をミュートする | muteParticipantOperation | グループ通話の参加者をミュートします。 |
| Create | audioRoutingGroup | audioRoutingGroups コレクションに投稿して、新しい audioRoutingGroup を作成します。 |
| オーディオ ルーティング グループを一覧表示する | audioRoutingGroup コレクション | audioRoutingGroup オブジェクト コレクションを取得します。 |
| 大規模なギャラリー ビュー | addLargeGalleryViewOperation | 大規模なギャラリー ビューを呼び出しに追加します。 |
| 対話型音声応答 | ||
| prompt を再生する | playPromptOperation | 通話でプロンプトを再生します。 |
| 応答を記録する | recordOperation | 呼び出し元からの短い音声応答を録音します。 |
| メディア処理を取り消す | commsOperation | メディア処理を取り消します。 |
| トーンを登録する | commsOperation | DTMF トーンを登録します。 |
| DTMF トーンを送信する | commsOperation | 通話で DTMF トーンを送信します。 |
| 自分の参加に関する操作 | ||
| アプリケーションをミュートする | muteParticipantOperation | 通話で自分をミュートします。 |
| アプリケーションのミュートを解除する | unmuteParticipantOperation | 通話で自分のミュートを解除します。 |
| 画面の共有の役割を変更する | なし | 通話中に画面共有を開始および停止します。 |
| レコーディング操作 | ||
| 記録状態を更新する | updateRecordingStatusOperation | レコーディングの状態を更新します。 |
| 記録を開始する | startRecordingOperation | 通話の録音を開始します。 |
| 記録を停止する | stopRecordingOperation | 通話の録音を停止します。 |
| 文字起こしを開始する | startTranscriptionOperation | 呼び出しの文字起こしを開始します。 |
| 文字起こしを停止する | stopTranscriptionOperation | 呼び出しの文字起こしを停止します。 |
| ログイン操作 | ||
| 遠隔会議デバイスの品質データをログに記録する | teleconferenceDeviceQuality | ビデオ遠隔会議デバイスの品質データをログに記録します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| activeModalities | modality コレクション | アクティブなモダリティの一覧。 可能な値は、unknown、audio、video、videoBasedScreenSharing、data です。 読み取り専用です。 |
| answeredBy | participantInfo | 通話に応答した参加者。 読み取り専用です。 |
| callRoutes | callRoute コレクション | 再通話したときのルーティング情報。 読み取り専用です。 |
| callbackUri | String | コールバック時のコールバック URL。
https である必要があります。 |
| callChainId | String | 1 つの会議におけるすべての参加者の通話を表す一意識別子、または P2P 通話における 2 人の参加者の通話を表す一意識別子。 これは、Microsoft.Graph.Call.CallChainId からコピーする必要があります。 |
| callOptions | outgoingCallOptions | 通話のオプション機能が含まれています。 |
| chatInfo | chatInfo | チャット情報。 会議のシナリオに必要な情報。 |
| 方向 | callDirection | 通話方向。 使用可能な値は、 incoming または outgoingです。 読み取り専用です。 |
| id | String | 通話 ID。読み取り専用。 |
| incomingContext | incomingContext | 着信通話に関連付けられたコンテキスト。 読み取り専用です。 サーバーによって生成されます。 |
| mediaConfig | appHostedMediaConfig または serviceHostedMediaConfig | メディア構成。 ピア ツー ピア通話の作成または会議への参加に必要な情報。 |
| mediaState | callMediaState | 読み取り専用です。 通話メディアの状態。 |
| meetingCapability | meetingCapability | 会議の機能が含まれます。 読み取り専用です。 |
| meetingInfo | organizerMeetingInfo、 tokenMeetingInfo、または joinMeetingIdMeetingInfo | 会議の情報。 会議のシナリオに必要な情報。 |
| 文字起こし | callTranscriptionInfo | 通話の文字起こし情報。 読み取り専用です。 |
| myParticipantId | String | 読み取り専用です。 |
| requestedModalities | modality コレクション | 要求されたモダリティの一覧。 可能な値は、unknown、audio、video、videoBasedScreenSharing、data です。 |
| resultInfo | resultInfo | 結果の情報。 たとえば、結果は終了理由を保持できます。 読み取り専用です。 |
| ringingTimeoutInSeconds | Int32 | 発信ピア ツー ピア通話の呼び出しタイムアウト (秒単位)。 この属性の最大値は 115 秒です。 |
| routingPolicies | routingPolicy コレクション | このプロパティは、ピア ツー ピア通話にのみ適用されます。 使用可能な値: none、noMissedCall、disableForwardingExceptPhone、disableForwarding、preferSkypeForBusiness、unknownFutureValue。 |
| source | participantInfo | 通話の発信者。 |
| state | callState | 通話状態。 可能な値は、incoming、establishing、ringing、established、hold、transferring、transferAccepted、redirecting、terminating、terminated です。 読み取り専用です。 |
| subject | String | 会話の件名。 |
| Targets | invitationParticipantInfo コレクション | 通話対象。 ピア ツー ピア通話の作成に必要な情報。 |
| tenantId | String | 読み取り専用です。
tenantIdMicrosoft Entra ID。 |
| terminationReason | String | 読み取り専用です。 |
| toneInfo | toneInfo | 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| audioRoutingGroups | audioRoutingGroup コレクション | 読み取り専用です。 Null 許容型。 |
| operations | commsOperationコレクション | 読み取り専用です。 Null 許容型。 |
| 参加者 | participant コレクション | 読み取り専用です。 Null 許容型。 |
| contentSharingSessions | contentSharingSession コレクション | 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"activeModalities": ["String"],
"answeredBy": {"@odata.type": "#microsoft.graph.participantInfo"},
"callRoutes": [{"@odata.type": "#microsoft.graph.callRoute"}],
"callbackUri": "String",
"callChainId": "String",
"callOptions": {"@odata.type": "#microsoft.graph.outgoingCallOptions"},
"chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
"contentSharingSessions": [{ "@odata.type": "microsoft.graph.contentSharingSession" }],
"direction": "String",
"id": "String (identifier)",
"incomingContext": {"@odata.type": "#microsoft.graph.incomingContext"},
"mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
"mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
"meetingCapability": {"@odata.type": "#microsoft.graph.meetingCapability"},
"meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
"transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
"myParticipantId": "String",
"requestedModalities": ["String"],
"resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
"ringingTimeoutInSeconds": 99,
"routingPolicies": ["String"],
"source": {"@odata.type": "#microsoft.graph.participantInfo"},
"state": "String",
"subject": "String",
"targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
"tenantId": "String",
"terminationReason": "String",
"toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}