AI
MicrosoftGraph
People

Microsoft Graph を使ってみよう : インテリジェント機能 - 人物と洞察リソース

ソーシャルインテリジェンス

人のつながりは、複数のコミュニケーションとコラボレーション パターン、およびビジネスのリレーションシップを基に構築することができ、Microsoft Graph ではそのような関係を取得するための API を提供しています。

これは組織構造による人の関係とは全く異なった視点でつながりを見れる、ユニークな機能です。

人物リソース

人物は、個人の連絡先、ソーシャル ネットワーキングの連絡先、組織のディレクトリ、最近 (メール、Skype などで) 連絡した人などになるため、社外の人物も含まれます。

主なシナリオ

  • 一覧を表示する
  • 特定の人物を取得する

人物の操作

いくつか代表的な操作を以下に紹介します。

関係する人物の一覧を表示する

GET: https://graph.microsoft.com/v1.0/me/people

C#
await graphClient.Me.People.Request().GetAsync();

人物を取得する

GET: https://graph.microsoft.com/v1.0/me/people/{id}

C#
await graphClient.Me.People["id"].Request().GetAsync();

人物を検索する

GET: https://graph.microsoft.com/v1.0/me/people?search=検索ワード

C#
await graphClient.Me.People.Request(new List<Option>()
{
    new QueryOption("search", "検索ワード")
}).GetAsync();

他のユーザーの関係を取得する
People.Read.All 権限があれば、他の人の関連を見ることも出来ます。

GET: https://graph.microsoft.com/v1.0/users/{id}/people

C#
await graphClient.Users["id"].People.Request().GetAsync();

洞察リソース

Microsoft Graph では、高度な分析と機械学習を活用し、ユーザーに関連するインサイトを収集しています。このインサイトにアクセスする API が公開されていますが、この記事を公開している時点ではまたベータ機能となります。

主なシナリオ

  • ユーザーに関連する人気上昇中のドキュメントを取得する
  • ユーザーが参照したり編集したドキュメントを取得する
  • ユーザーに共有されたドキュメントを取得する

洞察リソースの操作

いくつか代表的な操作を以下に紹介します。尚、C# SDK では洞察リソースがサポートされていないため、HttpClient を利用してください。

人気上昇中のドキュメントを取得する

GET: https://graph.microsoft.com/beta/me/insights/trending

参照したり編集したドキュメントを取得する

GET: https://graph.microsoft.com/beta/me/insights/used

共有されたドキュメントを取得する

GET: https://graph.microsoft.com/beta/me/insights/shared

まとめ

この機能のポイントは、膨大なデータを分析してこそ分かるデータを、簡単に入手できるところです。得られたデータを他のシナリオに追加するとより面白くなりますので是非試してください。

目次に戻る

参照

Microsoft Graph の People API を使用した最も関連のある人物に関する情報の取得
ソーシャル インテリジェンス:複数の人物
Microsoft Graph での洞察操作