次の方法で共有


call リソースの種類

名前空間: microsoft.graph

重要

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

呼び出しリソースは、アプリケーションの着信呼び出しがある場合、またはアプリケーションがapp/callsPOSTを介して新しい発信呼び出しを作成するときに作成されます。

通話はピアツーピアまたはグループ通話として設定できます。 グループ通話の作成またはグループ通話への参加を行うには、chatInfomeetingInfo を指定します。 これらが指定されていない場合は、新しいグループ呼び出しが自動的に作成されます。 着信の場合、高可用性ストアにこれらの値が記録されるので、アプリケーションがクラッシュしたときに、アプリケーションが通話に再度参加できるようになります。

同じ 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 レコーディングの状態を更新します。
ログイン操作
遠隔会議デバイスの品質データをログに記録する teleconferenceDeviceQuality ビデオ遠隔会議デバイスの品質データをログに記録します。

プロパティ

プロパティ 説明
activeModalities modality コレクション アクティブなモダリティの一覧。 可能な値は、unknownaudiovideovideoBasedScreenSharingdata です。 読み取り専用です。
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 organizerMeetingInfotokenMeetingInfo、または joinMeetingIdMeetingInfo 会議の情報。 会議のシナリオに必要な情報。
文字起こし callTranscriptionInfo 通話の文字起こし情報。 読み取り専用です。
myParticipantId String 読み取り専用です。
requestedModalities modality コレクション 要求されたモダリティの一覧。 可能な値は、unknownaudiovideovideoBasedScreenSharingdata です。
resultInfo resultInfo 結果の情報。 たとえば、結果は終了理由を保持できます。 読み取り専用です。
ringingTimeoutInSeconds Int32 発信ピア ツー ピア通話の呼び出しタイムアウト (秒単位)。 この属性の最大値は 115 秒です。
routingPolicies routingPolicy コレクション このプロパティは、ピア ツー ピア通話にのみ適用されます。 使用可能な値: nonenoMissedCalldisableForwardingExceptPhonedisableForwardingpreferSkypeForBusinessunknownFutureValue
source participantInfo 通話の発信者。
state callState 通話状態。 可能な値は、incomingestablishingringingestablishedholdtransferringtransferAcceptedredirectingterminatingterminated です。 読み取り専用です。
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"}
}