次の方法で共有

sensorDevices の一覧表示

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

テナント用に作成されたすべてのワークプレース センサー デバイスの一覧を取得します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ❌ ❌ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) PlaceDevice.Read.All PlaceDevice.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション PlaceDevice.Read.All PlaceDevice.ReadWrite.All

HTTP 要求

GET /workplace/sensorDevices

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズに役立つ $filter、 $top、 $select、 $skipTokenOData クエリ パラメーター をサポートします。 $filterは、deviceId、displayName、description、macAddress、manufacturer、ipV4Address、ipV6Address、タグの各プロパティで使用できます。

サポートされているクエリ パターン

パターン 構文 メモ
サーバー側の改ページ位置の自動修正 @odata.nextLink 結果セットが複数のページにまたがる場合は、応答で継続トークンを取得します。
Filter /workplace/sensorDevices?$filter=Tags/Any(x: cast(x, 'String') eq 'Building A') タグに基づいてデバイスをフィルター処理します。
Filter /workplace/sensorDevices?$filter=cast(manufacturer, 'String') eq 'Contoso' デバイスの製造元に基づいてデバイスをフィルター処理します。
Filter /workplace/sensorDevices?$filter=cast(deviceId, 'String') eq 'contoso_9D6816' ユーザーが指定したデバイス識別子に基づいてデバイスをフィルター処理します。
ページの制限 /workplace/sensorDevices?$top=20 ページ サイズが 20 のデバイスを取得します。 既定のページ サイズは 10 です。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文の workplaceSensorDevice オブジェクトのコレクションを返します。

例

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices",
    "@odata.nextLink": "https://graph.microsoft.com/beta/workplace/sensorDevices?$top=1&$skiptoken=aHR0cHM6Ly9vdXRsb29rLXNkZi5vZmZpY2UuY29tL2FwaS92Mi4wL09yZ1BhcnRpdGlvbnMoJ0FwcDpQbGFjZXNEZXZpY2VzXzIxNmFlZThkLTNjYzgtNDJhYi1hYmU4LTM0ZGRhZTE1MWI3M0BkNzQ4NTRiNy0zZjFjLTRlM2MtYjJlYy1kOTZlMDY3ZWEwYTYnKS9DdXJyZW50Q29sbGVjdGlvbnMoJ0RldmljZXNDb2xsZWN0aW9uJykvSXRlbXM%2fJTI0dG9wPTEmJTI0c2tpcHRva2VuPU15WlJWa1pDVVZWR1FsRlZSWFpNZVRoMlRIazRka3g1T0haUFJVcENVVlZHUWxOR1RYWldNVnB1WWpBNVFrMUZkRlZTYmxKU1pHcENXV0V6UlRCa2VqQTU%3d",
    "value": [
        {
            "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7",
            "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": [
                "Building A",
                "Floor 3",
                "Room 301",
                "Conference Room"
            ],
            "sensors": [
                {
                    "sensorId": "Occupancy",
                    "displayName": null,
                    "sensorType": "occupancy",
                    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671"
                },
                {
                    "sensorId": "PeopleCount",
                    "displayName": null,
                    "sensorType": "peopleCount",
                    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671"
                }
            ]
        }
    ]
}