Microsoft Graph で通話レコード API を操作する

重要

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

Microsoft Teams や Skype for Business を使用している場合、通話レコードによって、組織内で行われる通話やオンライン会議に関する情報が提供されます。 呼び出しレコード API を使用して、通話レコードのサブスクライブ、通話レコードの一覧表示、ID による通話レコードの検索を行うことができます。 通話レコードは、通話または会議の終了後に作成され、レコードは 30 日間保持されます。

通話レコード API は、OData のサブ名前空間 microsoft.graph.callRecords で定義されています。

キー リソースの種類

Resource	メソッド
callRecord	callRecords を一覧表示する callRecord の取得
directRoutingLogRow	getDirectRoutingCalls
participant	リスト participants_v2
pstnBlockedUsersLogRow	getPstnBlockedUsersLog
pstnCallLogRow	getPstnCalls
pstnOnlineMeetingDialoutReport	getPstnOnlineMeetingDialoutReport
segment	セッションの一覧 callRecord の取得
セッション	セッションの一覧 callRecord の取得
smsLogRow	getSmsLog

通話レコードの構造

callRecord エンティティは、1 つのピアツーピア通話または複数の参加者間のグループ呼び出しを表します。これは、オンライン会議と呼ばれることもあります。

ピアツーピア通話には、2 人の通話の参加者の間の単一のセッションが含まれます。 グループ通話には、1 つ以上のセッション エンティティが含まれます。 グループ通話には、参加者とサービス エンドポイントの間のセッションがそれぞれあります。

各セッションには、1 つ以上のセグメント エンティティが含まれます。 セグメントは、2 つのエンドポイント間のメディア リンクを表します。 ほとんどの場合、各セッションには 1 つのセグメントのみが表示されますが、1 つ以上の中間エンドポイントがある場合もあります。

上の図の数字は、種類ごとに存在できる子の数を示しています。 たとえば、callRecord とセッションの間の 1..N リレーションシップは、1 つの callRecord インスタンスに 1 つ以上の セッション インスタンスを含めることができるという意味です。 同様に、セグメントとメディアの間の 1..N リレーションシップは、1 つのセグメント インスタンスには、1 つ以上のメディア ストリームを含めることができるという意味です。

関連コンテンツ

• Webhook サブスクリプション