📈

Microsoft Graph のプレゼンス情報 API が Public Preview になりました

に公開
Microsoft Graph
tech

今回の記事はこちらの記事を参考にしています。

https://developer.microsoft.com/en-us/graph/blogs/microsoft-graph-presence-apis-are-now-available-in-public-preview?WT.mc_id=M365-MVP-5002941

これまでプレゼンス情報を取得するには、Skype for Business の Unified Communications Web API (UCWA) を使う必要がありました。今回のアップデートにより、より簡単にプレゼンス情報を取得できるようになりました。もちろん Microsoft Teams のプレゼンス情報にも対応しています。

Graph Explorer を使って API を実行してみます。アクセス許可に Presence.Read および Presence.Read.All が増えているので、許可するのを忘れないようにしてください。

POST https://graph.microsoft.com/beta/communications/getPresencesByUserId
Content-Type: application/json

{
    "ids": ["4b34f1e2-0c77-4fbd-a8cf-94a4606021ee"]
}

このように実行すると、以下のような結果が返ってきます。

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(presence)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.presence",
            "availability": "Offline",
            "activity": "Offline",
            "id": "4b34f1e2-0c77-4fbd-a8cf-94a4606021ee"
        }
    ]
}

オンラインになっている場合は、ステータスが変わります。

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(presence)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.presence",
            "availability": "Available",
            "activity": "Available",
            "id": "4b34f1e2-0c77-4fbd-a8cf-94a4606021ee"
        }
    ]
}

getPresencesByUserId は ID を複数指定できるため、プレゼンス情報を一覧表示することも簡単にできるようになります。とても便利です。

Discussion