Microsoft Teamsのプレゼンスから部下がサボってないか監視しよう！～プレゼンスの取得～

【目次】Teamsプレゼンス可視化ツール

2. プレゼンスの取得

続いてはMicrosoft Graph APIからTeamsプレゼンスを取得します。これもPower Automate Desktopで実装します。

プレゼンスの取得は3つのアクションでできます。簡単です。

ユーザーリストの作成

ユーザのプレゼンスを取得するためには、対象ユーザのMicrosoft ID上のIDを取得する必要があります。IDを知るためのAPIエンドポイントは以下です。

GET https://graph.microsoft.com/v1.0/users/[userPrincipalName]

一番下の “id”: から始まる文字列がユーザを識別するIDです。

[userPrincipalName]はプリンシパル名を入れます。ほとんどの組織ではメールアドレスと同じです。

次はIDからプレゼンスを取得します。取得するAPIエンドポイントは以下です。

GET https://graph.microsoft.com/v1.0/users/[id]/presence

これでユーザのプレゼンスが取得できます。プレゼンスは”availability: “に表示されます。

このコマンドを人数分繰り返してもいいのですがまとめて取得することもできます。

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

{
    "ids": ["id1", "id2"]
}

まとめて取得する場合はPOSTメソッドで本文にJSON形式でidを並べたものを送ります。

PowerAutomate Desktopにこれらのリストをハードコーディングしてもいいのですが、人の増減に柔軟に対応できるよう以下のようなフォーマットでリストを作成しテキストファイルで保存しておくとメンテナンス性が向上します。

{
    "ids": [
	"c6eXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ9fd",
	"31cXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZf61",
	"84bXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZa5b",
	"46cXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZf41",
	"389XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ6e6",
	"810XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZc49",
	"14aXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ4c6",
	"7cdXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ335",
	"b1dXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ794",
	"cabXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZf3f",
	"743XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ0d4",
	"a82XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZcb3",
	"733XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ3f1",
	"672XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ31c",
	"c8bXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZbcb",
	"a1bXXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ450",
	"4a0XXXXX-AAAA-BBBB-CCCC-ZZZZZZZZZ2a6"
    ]
}

このファイルをid.txtとして適当な場所に保存します。

因みにJSONファイルの構文チェックはこちらのサイト利用すると間違いなく作成できます。

JSON Pretty Linter Ver3