call リソースの種類

名前空間: microsoft.graph

重要

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

アプリケーションに関して着信が存在する場合か、アプリケーションによって app/calls で POST を介して発信が作成されると、call リソースが作成されます。

通話はピアツーピアまたはグループ通話として設定できます。 グループ通話の作成またはグループ通話への参加を行うには、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"}

メソッド

メソッド	戻り値の型	説明
Get	call	call オブジェクトのプロパティを読み取ります。
Delete	なし	アクティブな call を削除または切断します。
KeepAlive	なし	通話でアクティブな状態を継続させます。
Call 処理
応答する	なし	着信に応答します。
拒否する	なし	着信を拒否します。
リダイレクトする	なし	着信をリダイレクトします。
転送する	なし	通話の転送
グループ通話
参加者を一覧表示する	participant コレクション	participant オブジェクト コレクションを取得します。
参加者を招待する	commsOperation	アクティブな通話に参加者を招待します。
すべての参加者をミュートする	commsOperation	通話ですべての参加者をミュートします。
参加者をミュートする	muteParticipantOperation	グループ通話の参加者をミュートします。
オーディア ミキサーを構成する	commsOperation	マルチパーティ会話の音声を構成します。
audioRoutingGroup を作成する	audioRoutingGroup	audioRoutingGroups コレクションに投稿して、新しい audioRoutingGroup を作成します。
audioRoutingGroups を一覧表示する (List audioRoutingGroups)	audioRoutingGroup コレクション	audioRoutingGroup オブジェクト コレクションを取得します。
大規模なギャラリー ビュー	addLargeGalleryViewOperation	大規模なギャラリー ビューを呼び出しに追加します。
対話型音声応答
PlayPrompt	playPromptOperation	通話でプロンプトを再生します。
RecordResponse	recordOperation	呼び出し元からの短い音声応答を録音します。
CancelMediaProcessing	commsOperation	メディア処理を取り消します。
SubscribeToTone	commsOperation	DTMF トーンを登録します。
自分の参加に関する操作
ミュートする	muteParticipantOperation	通話で自分をミュートします。
ミュート解除する	unmuteParticipantOperation	通話で自分のミュートを解除します。
ChangeScreenSharingRole	なし	通話中に画面共有を開始および停止します。
レコーディング操作
UpdateRecordingStatus	updateRecordingStatusOperation	レコーディングの状態を更新します。
ログイン操作
デバイスの品質データのログ記録	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	読み取り専用です。 Azure Active Directory の tenantId。
terminationReason	String	読み取り専用です。
toneInfo	toneInfo	読み取り専用です。

リレーションシップ

リレーションシップ	型	説明
audioRoutingGroups	audioRoutingGroup コレクション	読み取り専用。Null 許容型です。
operations	commsOperationコレクション	読み取り専用。Null 許容型です。
participants	participant コレクション	読み取り専用。Null 許容型です。
contentSharingSessions	contentSharingSession コレクション	読み取り専用。Null 許容型です。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "activeModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "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": "incoming | outgoing",
  "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",
  "replacesContext": "String",
  "requestedModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["none | noMissedCall | disableForwardingExceptPhone | disableForwarding | preferSkypeForBusiness"],
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "incoming | establishing | ringing | established | hold | transferring | transferAccepted | redirecting | terminating | terminated",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}