call リソースの種類

[アーティクル]
10/30/2023

名前空間: microsoft.graph

重要

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

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

通話はピアツーピアまたはグループ通話として設定できます。グループ通話の作成またはグループ通話への参加を行うには、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	グループ通話の参加者をミュートします。
audioRoutingGroup を作成する	audioRoutingGroup	audioRoutingGroups コレクションに投稿して、新しい audioRoutingGroup を作成します。
audioRoutingGroups を一覧表示する (List audioRoutingGroups)	audioRoutingGroup コレクション	audioRoutingGroup オブジェクトコレクションを取得します。
大規模なギャラリービュー	addLargeGalleryViewOperation	大規模なギャラリービューを呼び出しに追加します。
対話型音声応答
PlayPrompt	playPromptOperation	通話でプロンプトを再生します。
RecordResponse	recordOperation	呼び出し元からの短い音声応答を録音します。
CancelMediaProcessing	commsOperation	メディア処理を取り消します。
SubscribeToTone	commsOperation	DTMF トーンを登録します。
SendDtmfTones	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	読み取り専用です。 `tenantId`Microsoft 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",
  "replacesContext": "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"}
}