次の方法で共有


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

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

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

キー リソースの種類

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

通話レコードの構造

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

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

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

完全な通話レコードを表すデータ構造の画像

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