Microsoft Teams や Skype for Business を使用している場合、通話レコードによって、組織内で行われる通話やオンライン会議に関する情報が提供されます。 呼び出しレコード API を使用して、通話レコードのサブスクライブ、通話レコードの一覧表示、ID による通話レコードの検索を行うことができます。 通話レコードは、通話または会議の終了後に作成され、レコードは 30 日間保持されます。
通話レコード API は、OData のサブ名前空間 microsoft.graph.callRecords で定義されています。
キー リソースの種類
通話レコードの構造
callRecord エンティティは、1 つのピアツーピア通話または複数の参加者間のグループ呼び出しを表します。これは、オンライン会議と呼ばれることもあります。
ピアツーピア通話には、2 人の通話の参加者の間の単一のセッションが含まれます。 グループ通話には、1 つ以上のセッション エンティティが含まれます。 グループ通話には、参加者とサービス エンドポイントの間のセッションがそれぞれあります。
各セッションには、1 つ以上のセグメント エンティティが含まれます。 セグメントは、2 つのエンドポイント間のメディア リンクを表します。 ほとんどの場合、各セッションには 1 つのセグメントのみが表示されますが、1 つ以上の中間エンドポイントがある場合もあります。
上の図の数字は、種類ごとに存在できる子の数を示しています。 たとえば、callRecord とセッションの間の 1..N リレーションシップは、1 つの callRecord インスタンスに 1 つ以上の セッション インスタンスを含めることができるという意味です。 同様に、セグメントとメディアの間の 1..N リレーションシップは、1 つのセグメント インスタンスには、1 つ以上のメディア ストリームを含めることができるという意味です。
PSTN とダイレクト ルーティング ログ
pstnCallLogRow および directRoutingLogRow リソースには、公衆交換電話網 (PSTN) インフラストラクチャを利用する通話に関する情報のみが含まれます。 この情報は、organizationでの呼び出し元製品の使用状況を理解するのに役立ちます。 ただし、これらのリソースは、大規模な通話または会議エクスペリエンスの一部のみを反映している場合があります。 たとえば、ログ行には、オンライン会議に参加するために PSTN 通話を発信するが、そのオンライン会議の他の参加者に関する情報は含まれていないユーザーに関する情報が含まれます。 ログ行は呼び出しレコード情報のサブセットでもあるため、特定のログ行の ID を使用して callRecord オブジェクトをフェッチすることはできません。