分析の構築

[アーティクル]
11/14/2024

従業員がオフィスに入る意図を示し、実際の建物の占有率データと組み合わせ、不動産や施設管理者に建物のスペースの使用を理解、分析、最適化するための貴重なツールを提供する作業計画設定。

従業員の意図を反映した作業計画データと実際の占有率データを比較することで、計画空間と実際のスペース使用量の間の不一致を特定できます。

分析の構築に使用されるシグナルを次に示します。

オフィスに入る意図に基づいて使用を構築する 分析の構築では、従業員の作業計画を使用して、意図主導型のスペースの使用を評価します。
実際の占有率に基づく建物の使用 建物分析では、バッジデータを使用して建物に存在する従業員の数を推測し、実際の建物の占有率を測定します。
PeopleデータMicrosoft Places分析では、外部コネクタを介してMicrosoft Entra ID データからソース化されたユーザープロファイル API データを使用して、特定の建物に割り当てられた従業員と特定のリーダーの従業員を分析します。このデータは、ユーザーを特定の建物にマッピングし、分析を構築するためのデータカバレッジを向上させるのに役立ちます。

分析シグナルの構築

使用する意図に基づいて使用率を構築する

建物分析では、作業計画データを使用して、意図された建物の占有率と予想されるハイブリッド傾向を追跡し、オフィス訪問に関する従業員の好みに関する分析情報を提供します。

作業計画データのソースは、Microsoft Placesおよび Outlook アプリのユーザーが使用できるフレキシブル勤務時間 (FWH) 設定から取得されます。作業計画データは、(ユーザープロファイルデータセットからの) ユーザーデータの可用性に依存します。 Peopleデータは、従業員データで建物を割り当てられた建物として選択せずに作業計画を設定する従業員のマッピングに役立ちます。

実際の占有率に基づく建物の使用率

建物分析では、占有率データを使用して、建物内のユーザーの実際の存在を検出します。現時点では、次の建物占有率データがサポートされています。

バッジアクセスデータ

注:

建物分析ダッシュボードで正確な値を表示するには、ユーザーデータを Mirosoft Placesにオンボードされている建物にマップする必要があります。

次のセクションでは、ユーザーデータのオンボードに関する詳細と、占有データのオンボードの構築について説明します。

ユーザーデータのオンボード

一般情報

Microsoft Places分析では、ユーザープロファイル API データを使用して、ユーザーを特定の場所/建物に関連付けます。 Peopleプロファイルデータは通常、Microsoft Entra IDからデータを取得し、Microsoft 365 アプリケーションにユーザーデータを取り込むコネクタを追加した場合、関連するデータは people プロファイルデータセットに反映されます。

建物分析で割り当てられた人員は、従業員から建物のマッピングに派生します。
リーダーフィルター機能を正確に機能させるには、従業員プロファイルデータセットで従業員マネージャーマッピングを使用できる必要があります。

データ形式

Microsoft Places分析では、従業員プロファイルデータセット内の特定のフィールドセットを検索して、従業員、割り当てられた建物、およびマネージャー間のマッピングを作成します。

OfficeLocationこれは、従業員を建物に関連付けるためにPlacesによって使用される people プロファイル API プロパティです。

注:

このプロパティは、マッピングを正確に作成するには、Places ディレクトリに設定されている建物名と一致する必要があります。

支配人これは、ユーザーをリーダー/マネージャーに関連付けるためにPlacesによって使用されるユーザープロファイル API プロパティです。

プロファイル API の詳細については、データ形式に関するページを参照してください。 Microsoft Graph のプロファイル API を使用して、自分または別のユーザーに関する情報を取得する方法に関するページを参照してください。

Microsoft Entra IDへのデータ更新

ユーザープロファイルデータと出席データを照合するには、Microsoft Entra IDの場所を更新する必要があります。これは、次のいずれかの方法を使用して実行できます。

Azure portal

Azure portalにアクセスする: Azure portalに移動し、資格情報でサインインします。
[Azure Active Directory] に移動します。左側のナビゲーションウィンドウで、[ Azure Active Directory] を選択します。
ユーザーの検索: [ 管理] で [ ユーザー] を選択し、更新する場所を持つユーザーを検索します。
ユーザー情報の編集: ユーザーの名前を選択してプロファイルを開き、[ 編集 ] を選択して情報を更新します。
場所を更新する: [ ジョブ情報 ] セクションで、ユーザーの場所の詳細を更新できます。変更は必ず保存してください。
更新マネージャー: [ ジョブ情報 ] セクションで、ユーザーのマネージャーの詳細を更新できます。変更は必ず保存してください。

Microsoft Entra IDデータの更新の詳細については、Microsoft Entra 管理センターでユーザーのプロファイル情報と設定を追加または更新する方法に関するページを参照してください。

PowerShell スクリプトを使用してMicrosoft Entra ID属性を更新する

# Connect to Azure AD 
Connect-AzureAD

ユーザーの場所を更新する

Update-AzADUser -UPNOrObjectId user@domain.com -OfficeLocation “18/2111”

詳細については、「 Update-AzADUser」を参照してください。

Graph APIを使用してMicrosoft Entra ID属性を更新する

まず、ユーザーリソースの種類を理解します。詳細については、「ユーザーリソースの種類」を参照してください。

Graph Explore にサインインします。詳細については、「Graph エクスプローラー」を参照してください。
Update ユーザーを呼び出します。詳細については、「ユーザーの更新」を参照してください。

見本：

PATCH https://graph.microsoft.com/v1.0/users/{id} 
Content-type: application/json 
{ 
  "officeLocation": "18/2111" 
}

データの検証とトラブルシューティング

Microsoft Places分析ダッシュボードのヘッドカウントプロパティには、期待される値が必要です。
リーダーは、Places分析の [Building analytics]\(分析の構築\) ページでフィルター処理し、適切なリーダーのデータを入力する必要があります。
ユーザーの場所またはマネージャーを更新して変更を加える場合は、3 日から 4 日間でPlaces分析に反映する必要があります。
発生した Microsoft の問題を送信するには、アプリケーションのフィードバックオプションを使用します。

セキュリティとプライバシーの考慮事項

Microsoft Places分析では、常にデータポイントが集計され、建物の使用番号が表示されます。ユーザーは、特定の個々の従業員に関する情報を特定できません。 Microsoft Placesは、他の Microsoft 365 アプリケーションで使用されるユーザープロファイルデータを使用します。

オンボードバッジデータ

既存のバッジアクセスシステムを使用して、占有ダッシュボードの構築に関するPlaces Analytics レポートを強化できます。

バッジデータを有効にするプロセス

手順 1: バッジアクセスデバイスをMicrosoft Placesに追加します (省略可能ですが、強くお勧めします)。
手順 2: バッジデータテレメトリをMicrosoft Placesにアップロードする。

注:

Peopleバッジデータをオンボードする前に、Microsoft Placesの関心のある建物でデータを使用できるようにする必要があります。バッジデータは、People データに対して検証されます。システムは、Microsoft Placesにマップされていないユーザーのバッジデータを除外します。

手順 1: バッジアクセスデバイスをMicrosoft Placesに追加する

最初の手順では、バッジアクセスデバイスのメタデータをアップロードし、Microsoft Placesの PlaceId にデバイスをマッピングします。この手順は、バッジシグナルがMicrosoft Placesに達したときにコンテキスト化するのに役立ちます。バッジアクセスデバイスをMicrosoft Placesに追加するには、次の 2 つのオプションを使用します。

オプション 1: PowerShell コマンドレットを使用する
オプション 2: Microsoft Graph API の使用

オプション 1: PowerShell コマンドレットを使用する

PowerShell コマンドレットは、Microsoft Placesでデバイスを管理するために使用できます。 Microsoft Placesコマンドレットの詳細については、PowerShell 用の Microsoft Places コマンドレットモジュールに関するページを参照してください。

注:

コマンドレットを実行するには、TenantPlacesManagement ロールが割り当てられている必要があります。

コマンドレットのデバイスデータ形式

列	説明	Notes	例
DeviceId (必須)	デバイスの一意識別子 (推奨: Manufacturer_DeviceUniqueId)。	送信されるテレメトリの ID と一致する必要があります。	Manuf1_3455
DisplayName	デバイスの表示名。	該当する場合は、フレンドリ名を使用できます。	Manuf1_3455
説明	デバイスの説明。
MacAddress	デバイスの Mac アドレス。	提供されたサプライヤー (使用可能な場合)。
製造元 (必須)	デバイスの製造元。	IT 管理者が提供します。	Manuf1
IPV4Address	デバイスの IPV4Address。	提供されたサプライヤー (使用可能な場合)。
IPV6Address	デバイスの IPV6Address。	提供されたサプライヤー (使用可能な場合)。
PlaceId	デバイスがPlacesにマップされる PlaceId。	IT 管理者は、会議室の一覧から DeviceID を DisplayName フィールドにマップします。	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	検索に役立つデバイスに関連付けられているカスタムタグの一覧。		["IsVirtual_False","Building_121"]
Sensor.SensorId	デバイス内のセンサーの一意識別子。	標準のテレメトリペイロードに含まれている必要があります。	バッジ
Sensor.DisplayName	センサーの表示名。	フレンドリ名 (該当する場合) を使用できます。	クリップ
Sensor.SensorType (必須)	センサーの種類。	検証済みリスト (例を参照)。	バッジ
Sensor.PlaceId	センサーによって提供される場所の一意の識別子 (センサーがデバイスの場所とは異なる場所にある場合にのみ、この情報を提供する必要があります)。		76fe540f-01a9-425e-acd5-5d7d1da44fbf

コマンドレットを使用してバッジアクセスデバイスをMicrosoft Placesに追加する

[!div class="mx-tdBreakAll"]

コマンドレット名	説明	パラメーター
New-PlaceDevice	新しいデバイスを作成します。	DeviceId (必須)、DisplayName、Description、MACAddress、製造元 (必須)、IPV4Address、IPV6Address、PlaceId (必須)、TagsSensors (必須)
Remove-PlaceDevice	デバイスを削除します。	ID (必須)
Set-PlaceDevice	デバイスをUpdatesします。	ID (必須)、DeviceId (必須)、DisplayName、Description、MACAddress、製造元 (必須)、IPV4Address、IPV6Address、PlaceId、タグ、センサー (必須)
Get-PlaceDevice	デバイスを取得します。	ID、フィルター、上部

手順: PowerShell コマンドレットを使用する

PowerShell 7 (管理者としてではなく) を開きます。
次のWindows PowerShell コマンドレットを実行して、Microsoft Placesをインストールします。 Microsoft Placesインストールの詳細については、Microsoft Places PowerShell ギャラリーを参照してください。
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
次のWindows PowerShell コマンドレットを実行して、Microsoft Places モジュールをインポートします。
```
Import-Module -Name MicrosoftPlaces 
```
モジュールをインストールしてインポートした後、次の Microsoft Places PowerShell コマンドレットを実行して、Microsoft Places モジュールに接続します。
```
Connect-MicrosoftPlaces
```

New-PlaceDevice コマンドレットを使用して、バッジアクセスデバイスを追加します。

New-PlaceDevice -DeviceId "contoso_9D6816" -DisplayName "Contoso 9D6816 Device" -Description "Contoso 9D6816 Device" -MACAddress "00:0A:95:9D:68:16" -Manufacturer "Contoso" -IPV4Address "192.168.1.100" -IPV6Address "2001:db8::ff00:42:8329" -PlaceId "acfa3bc0- 2b83-425b-8910-84a0250e9671" -Tags "BuildingA" -Sensors (New-Object MicrosoftPlaces.PlacesDevices.Sensor -Property @{SensorType="badge"})

注:

この例の Sensors パラメーターは、サンプルで説明されているフィールドを持つ MicrosoftPlaces.PlacesDevices.Sensor 型のオブジェクトです。

Get-PlaceDevice を使用して、デバイスの一覧を表示します。既定では、10 台のデバイスが返されます。より多くのデバイスを返すには、この例に示すように -top パラメーターを追加します。
```
Get-PlaceDevice -top 100 
```

Set-PlaceDevice を使用して、既存の ID でデバイスを更新します。

Set-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e" -DeviceId "contoso_7D6816" -DisplayName "Contoso 7D6816 Device" -Description "Contoso 9D6816 Device" -MACAddress "00:0A:95:9D:68:16" -Manufacturer "Contoso" -IPV4Address "192.168.1.100" -IPV6Address "2001:db8::ff00:42:8329" -PlaceId "acfa3bc0- 2b83-425b-8910-84a0250e9671" -Tags "BuildingA" -Sensors (New-Object MicrosoftPlaces.PlacesDevices.Sensor -Property @{SensorType="badge"})

注:

デバイスの更新中に、すべてのパラメーターの詳細 (必須と省略可能の両方) を指定します。パラメーター値がない場合は、値を既定の空の値にリセットします。

Remove-PlaceDevice を使用してデバイスを削除します。

Remove-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e"

手順: Microsoft Graph APIの使用

バッジアクセスデバイスの登録とオンボードを自動化するアプリケーションを構築するために、API は Microsoft Graph から入手できます。 API を使用するには、次の手順に従います。

Microsoft Entraでアプリ登録を作成します。 PlaceDeviceRead.All および PlaceDevice.ReadWrite.All のアクセス許可の詳細については、「 Microsoft Graph のアクセス許可リファレンス」を参照してください。
アプリケーションをビルドしてデプロイし、Microsoft Placesとパートナー間でデバイス情報を同期します。

Microsoft Graph APIで使用されるデバイスデータ形式

列	説明	Notes	例
DeviceId (必須)	デバイスの一意識別子 (推奨: Manufacturer_DeviceUniqueId)。	送信されるテレメトリの ID と一致する必要があります。	Manuf1_3455
DisplayName	デバイスの表示名。	該当する場合は、フレンドリ名を使用できます。	Manuf1_3455
説明	デバイスの説明。
MacAddress	デバイスの Mac アドレス。	提供されたサプライヤー (使用可能な場合)。
製造元 (必須)	デバイスの製造元。	IT 管理者が提供します。	Manuf1
IPV4Address	デバイスの IPV4Address。	供給者が提供する場合。
IPV6Address	デバイスの IPV6Address。	供給者が提供する場合。
PlaceId (必須)	デバイスがMicrosoft Placesにマップされる PlaceId。	IT 管理者は、会議室の一覧から DeviceID を DisplayName フィールドにマップします。	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	検索に役立つデバイスに関連付けられているカスタムタグの一覧。		["IsVirtual_False","Building_121"]
Sensor.SensorId (必須)	デバイス内のセンサーの一意識別子。	標準のテレメトリペイロードに含まれている必要があります。	バッジ
Sensor.DisplayName	センサーの表示名。	フレンドリ名 (該当する場合) を使用できます。	クリップ
Sensor.SensorType (必須)	センサーの種類。	検証済みリスト (例を参照)。	バッジ
Sensor.PlaceId	センサーによって提供される場所の一意の識別子 (センサーがデバイスの場所とは異なる場所にある場合にのみ、この情報を提供する必要があります)。		76fe540f-01a9-425e-acd5-5d7d1da44fbf

センサーデバイスの詳細については、次の Microsoft Graph API を参照してください。

バッジアクセスデバイスの表示: sensorDevices を一覧表示します。

GET https://graph.microsoft.com/beta/workplace/sensorDevices

新しいバッジアクセスデバイスの作成: workplaceSensorDevice を作成します。

POST https://graph.microsoft.com/beta/workplace/sensorDevices 

{ 
    "deviceId": "contoso_7D6816", 
    "displayName": "Contoso 7D6816 Device", 
    "description": "Contoso 7D6816 Device", 
    "macAddress": "00:0A:95:9D:68:16", 
    "manufacturer": "Contoso", 
    "ipV4Address": "192.168.1.100", 
    "ipV6Address": "2001:db8::ff00:42:8329", 
    "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671", 
    "tags": [ 
        "BuildingA" 
    ], 
    "sensors": [ 
        { 
            "sensorId": "Badge", 
            "displayName": null, 
            "sensorType": "badge", 
            "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671" 
        } 
    ] 
}

特定のデバイスを表示する: workplaceSensorDevice を取得します。

GET https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b

既存のバッジアクセスデバイスを更新する: workplaceSensorDevice を更新します。

PATCH https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b 

{ 
    "deviceId": "contoso_7D6816", 
    "displayName": "Contoso 7D6816 Device", 
    "description": "Contoso 7D6816 Device", 
    "macAddress": "00:0A:95:9D:68:16", 
    "manufacturer": "Contoso2", 
    "ipV4Address": "192.168.1.100", 
    "ipV6Address": "2001:db8::ff00:42:8329", 
    "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671", 
    "tags": [ 
         "BuildingA" 
     ], 
    "sensors": [ 
        { 
            "sensorId": "Badge", 
            "displayName": null, 
            "sensorType": "badge", 
            "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671" 
        } 
    ] 
}

デバイスを削除するには: workplaceSensorDevice を削除します。

DELETE https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b GET https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b

バッジデータテレメトリをMicrosoft Placesにアップロードする

バッジ入力システムからデータをアップロードして、Places Analytics で建物の占有ダッシュボードを生成します。

DeviceId は、バッジイベントを特定の建物と照合するために使用されます。 DeviceId がない場合は、LocationHint が使用されます。建物の占有率を正確にマップするために、デバイスをオンボードすることを強くお勧めします。
デバイスをMicrosoft Placesにオンボードしていない場合、LocationHint はMicrosoft Places ディレクトリ内の建物名と一致する必要があります。
バッジデータのユーザーは、(プロファイル API から) Peopleデータに対して検証され、[Building analytics]\(分析の構築\) ページで使用できるようにします。

オプション 1: Push-Dataset コマンドレットを使用する

バッジデータをMicrosoft Placesにプッシュするには、次の手順が必要です。

既存のシステムからバッジデータをダウンロードします。
次のセクションのバッジデータ形式に従って CSV ファイルを準備します。
準備した CSV データをMicrosoft Placesにプッシュします。

CSV ファイルを準備する

バッジデータ形式: バッジ情報をアップロードするときは、次のスキーマを使用します。

列	種類	説明
DeviceId	String	省略可能。デバイス ID は、信号を生成したデバイスを示します。
EventType	文字列	センサーの種類によって異なるバッジのアクション。値には BadgeIn を指定できます。
UserID	String	省略可能。バッジ付きユーザー ID。
UserName	String	省略可能。バッジ付きユーザー名。
UserEmail	String	バッジ付きユーザーのメールアドレス。
LocationHint	String	建物名。バッジ信号が記録された場所からの場所。
IngestionTime	Timestamp	イベントが発生したタイミングを示すバッジシグナルのタイムスタンプ。

このデータのアップロード中に CSV 列ヘッダーをスキップします。
CSV 列の値は、前に説明したスキーマに合わせて指定する必要があります。
マッピングロジックをPlacesするユーザーの場所:

DeviceId が使用できないが、LocationHint が使用可能な場合は、People ディレクトリに LocationHint と PlaceName をマップし、マップされない場所を除外します。

LocationHint と DeviceId の両方が使用可能な場合は、People ディレクトリに LocationHint と PlaceName をマップします。マップされない場合は、PlaceIdFromDeviceInventory でマップします。それ以外の場合は、マップされないものがフィルター処理されます。

CSV サンプルファイルの内容:

次の例は、CSV ファイル内の 2 つのエントリを示しています。

BadgeEntry1_BANGALORE-FERNS_MIRPL,BadgeIn,167b4de9-05c8-422e-916e-9d5be5b381b2,AlexW,AlexW@SkelligeIsland.OnMicrosoft.com,BANGALORE-FERNS_MIRPL,2024-06-28T09:36:05.144Z 

BadgeEntry1_BANGALORE-FERNS_MIRPL,BadgeIn,167b4de9-05c8-422e-916e-9d5be5b381b2,AllanD,AllanD@SkelligeIsland.OnMicrosoft.com,BANGALORE-FERNS_MIRPL,2024-06-28T10:36:05.144Z

コマンドレットを使用してバッジデータ信号をMicrosoft Placesにプッシュする

Microsoft Placesコマンドレットの詳細については、PowerShell 用の Microsoft Places コマンドレットモジュールに関するページを参照してください。

注:

コマンドレットMicrosoft Places実行するには、TenantPlacesManagement ロールが割り当てられている必要があります。

PowerShell 7 (管理者としてではなく) を開きます。
次のWindows PowerShell コマンドレットを実行して、Microsoft Placesをインストールします。インストールMicrosoft Places詳細については、Microsoft Places PowerShell ギャラリーを参照してください。
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
次のWindows PowerShell コマンドレットを実行して、Microsoft Places モジュールをインポートします。
```
Import-Module -Name MicrosoftPlaces
```
次の Places PowerShell コマンドレットを実行して、Microsoft Places モジュールに接続します。
```
Connect-MicrosoftPlaces 
```
次の Microsoft Places PowerShell コマンドレットを実行して、(フォルダーとパスを使用して) デバイス上の場所からバッジデータセットをアップロードします。
```
Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
```

これは CreateOrOverwrite 操作です。たとえば、新しいバッジデータは現在の日付フォルダーに上書きされます。

オプション 2: Microsoft Graph APIを使用して自動化する

Graph APIを使用してバッジデータをMicrosoft Placesにプッシュするには、次の手順が必要です。

既存のシステムからバッジデータをダウンロードします。
次のセクションのバッジデータ形式を使用して API 要求を準備します。

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry 
{ 
    "telemetry": [ 
        { 
            "deviceId": "BadgeEntry1_BANGALORE-FERNS_MIRPL", 
            "sensorType": "badge", 
            "eventValue": { 
                "eventType": "badgeIn", 
                "user": { 
                    "id": "167b4de9-05c8-422e-916e-9d5be5b381b2", 
                    "displayName": "AlexW", 
                    "email": "AlexW@SkelligeIsland.OnMicrosoft.com" 
                } 
             }, 
             "locationHint": "BANGALORE-FERNS_MIRPL", 
             "timestamp": "2024-06-28T09:36:05.144Z" 
        } 
    ] 
}

API を実行して、データをMicrosoft Placesにプッシュします。

バッジデータシグナルデータ形式

パラメーター	型	説明
テレメトリ (必須)	workplaceSensorDeviceTelemetry, collectionText	バッジデバイス上のセンサーによって収集および報告されるテレメトリデータのコレクション。
deviceId	String	作成時に指定されたデバイスのユーザー定義の一意識別子。デバイスのシステム生成識別子を使用しないでください。
locationHint	String	デバイスの場所を示す追加情報。
timestamp (必須)	DateTimeOffset	センサーがその値を測定して報告した日時。タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。たとえば、2024 年 1 月 1 日の午前 0 時 UTC は 2024-01-01T00:00:00Z です。
sensorType (必須)	workplaceSensorType	センサーの種類。使用可能な値は、バッジです。
eventValue (必須)	workplaceSensorEventValue	バッジシグナルに関連付けられている追加の値。
eventValue.eventType (必須)	workplaceSensorEventType	可能なセンサーイベント値の種類。使用可能な値は、badgeIn です。
eventValue.user (必須)	emailIdentity	ユーザーの一意識別子。電子メールまたはMicrosoft Entra IDを指定できます。
eventValue.user.displayName	String	ユーザーの表示名。 ID から継承されます。
eventValue.user.email (必須)	String	ユーザーのアドレスをEmailします。
eventValue.user.id	String	ユーザーの一意の識別子。 ID から継承されます。

Microsoft Graph API を使用してバッジデータ信号をMicrosoft Placesにプッシュする

自動化するアプリケーションを構築し、テレメトリをアップロードするために、API は Microsoft Graph を通じて利用できます。 API を使用するには、次の手順に従います。

Microsoft Entraでアプリ登録を作成します。

PlaceDeviceRead.All および PlaceDevice.ReadWrite.All のアクセス許可の詳細については、「 Microsoft Graph のアクセス許可リファレンス」を参照してください。
アプリケーションを構築してデプロイし、Microsoft Placesとパートナー間でテレメトリを同期します。
IngestTelemetry API を使用して、バッジデータをMicrosoft Placesにプッシュします。

詳細については、「 workplaceSensorDevice」を参照してください。

例:

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry  

{ 
    "telemetry": [ 
        { 
            "deviceId": "BadgeEntry1_BANGALORE-FERNS_MIRPL", 
            "sensorType": "badge", 
            "eventValue": { 
            "eventType": "badgeIn", 
                "user": { 
                    "id": "167b4de9-05c8-422e-916e-9d5be5b381b2", 
                    "displayName": "AlexW", 
                    "email": "AlexW@SkelligeIsland.OnMicrosoft.com" 
                } 
             }, 
            "locationHint": "BANGALORE-FERNS_MIRPL", 
            "timestamp": "2024-06-28T09:36:05.144Z" 
        } 
    ] 
}

データ検証とトラブルシューティングによる分析の構築

オンボードされたユーザー電子メール ID が、Microsoft Entra IDのユーザー電子メール ID と一致していることを確認します。
ユーザーの場所がMicrosoft Entra IDのユーザーの場所と一致していることを確認します。
バッジデータをオンボードすると、48 時間以内に建物の占有率ベースのダッシュボードが点灯します。

分析を構築するためのセキュリティとプライバシーに関する考慮事項

アップロードされたバッジデータの保持期間は 28 日です。集計された処理されたデータは、90 日間保存されます。
データは、プライバシーに準拠した Azure Data Lake に格納されます。
メンバーが 10 人未満のリーダーは、プライバシーリスクのためにリーダー階層に表示されません。
建物に来るメンバーが 10 人未満の日数は、プライバシーリスクのため、実際の建物の占有ダッシュボードには表示されません。

次の方法で共有

分析の構築

分析シグナルの構築

使用する意図に基づいて使用率を構築する

実際の占有率に基づく建物の使用率

ユーザーデータのオンボード

一般情報

データ形式

Microsoft Entra IDへのデータ更新

Azure portal

PowerShell スクリプトを使用してMicrosoft Entra ID属性を更新する

ユーザーの場所を更新する

Graph APIを使用してMicrosoft Entra ID属性を更新する

データの検証とトラブルシューティング

セキュリティとプライバシーの考慮事項

オンボードバッジデータ

バッジデータを有効にするプロセス

手順 1: バッジアクセスデバイスをMicrosoft Placesに追加する

オプション 1: PowerShell コマンドレットを使用する

コマンドレットのデバイスデータ形式

コマンドレットを使用してバッジアクセスデバイスをMicrosoft Placesに追加する

手順: PowerShell コマンドレットを使用する

手順: Microsoft Graph APIの使用

Microsoft Graph APIで使用されるデバイスデータ形式

バッジデータテレメトリをMicrosoft Placesにアップロードする

オプション 1: Push-Dataset コマンドレットを使用する

CSV ファイルを準備する

コマンドレットを使用してバッジデータ信号をMicrosoft Placesにプッシュする

オプション 2: Microsoft Graph APIを使用して自動化する

バッジデータシグナルデータ形式

Microsoft Graph API を使用してバッジデータ信号をMicrosoft Placesにプッシュする

データ検証とトラブルシューティングによる分析の構築

分析を構築するためのセキュリティとプライバシーに関する考慮事項

フィードバック

その他のリソース

次の方法で共有

分析の構築

分析シグナルの構築

使用する意図に基づいて使用率を構築する

実際の占有率に基づく建物の使用率

ユーザー データのオンボード

一般情報

データ形式

Microsoft Entra IDへのデータ更新

Azure portal

PowerShell スクリプトを使用してMicrosoft Entra ID属性を更新する

ユーザーの場所を更新する

Graph APIを使用してMicrosoft Entra ID属性を更新する

データの検証とトラブルシューティング

セキュリティとプライバシーの考慮事項

オンボード バッジ データ

バッジ データを有効にするプロセス

手順 1: バッジ アクセス デバイスをMicrosoft Placesに追加する

オプション 1: PowerShell コマンドレットを使用する

コマンドレットのデバイス データ形式

コマンドレットを使用してバッジ アクセス デバイスをMicrosoft Placesに追加する

手順: PowerShell コマンドレットを使用する

手順: Microsoft Graph APIの使用

Microsoft Graph APIで使用されるデバイス データ形式

バッジ データ テレメトリをMicrosoft Placesにアップロードする

オプション 1: Push-Dataset コマンドレットを使用する

CSV ファイルを準備する

コマンドレットを使用してバッジ データ信号をMicrosoft Placesにプッシュする

オプション 2: Microsoft Graph APIを使用して自動化する

バッジ データシグナルデータ形式

Microsoft Graph API を使用してバッジ データ信号をMicrosoft Placesにプッシュする

データ検証とトラブルシューティングによる分析の構築

分析を構築するためのセキュリティとプライバシーに関する考慮事項

フィードバック

その他のリソース

ユーザーデータのオンボード

オンボードバッジデータ

バッジデータを有効にするプロセス

手順 1: バッジアクセスデバイスをMicrosoft Placesに追加する

コマンドレットのデバイスデータ形式

コマンドレットを使用してバッジアクセスデバイスをMicrosoft Placesに追加する

Microsoft Graph APIで使用されるデバイスデータ形式

バッジデータテレメトリをMicrosoft Placesにアップロードする

コマンドレットを使用してバッジデータ信号をMicrosoft Placesにプッシュする

バッジデータシグナルデータ形式

Microsoft Graph API を使用してバッジデータ信号をMicrosoft Placesにプッシュする