Поделиться через

workplaceSensorDevice: ingestTelemetry

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Прием данных телеметрии датчика для устройства датчика на рабочем месте.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) PlaceDevice.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение PlaceDeviceTelemetry.ReadWrite.All PlaceDevice.ReadWrite.All

HTTP-запрос

POST /workplace/sensorDevices/ingestTelemetry

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление параметров в формате JSON.

Свойство sensorId можно опустить в объекте workplaceSensorDeviceTelemetry для устройств с уникальными типами датчиков. Если это свойство опущено, значение sensorType выступает в качестве идентификатора по умолчанию, соответствующего поведению при создании устройства без указанного sensorId.

В следующей таблице показаны параметры, которые можно использовать с этим действием.

Параметр Тип Описание
телеметрия коллекция workplaceSensorDeviceTelemetry Коллекция данных телеметрии, собираемых и сообщаемых датчиком на устройстве, таких как заполненность, количество людей, вывод о заполнении, температура и многое другое.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Примеры

Пример 1. Отправка данных телеметрии датчика для устройства с уникальными типами датчиков

В следующем примере показано, как отправлять данные телеметрии датчика для устройства с уникальными типами датчиков.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry
Content-Type: application/json

{
    "telemetry": [
        {
            "deviceId": "contoso_9D6816",
            "sensorType": "occupancy",
            "boolValue": false,
            "timestamp": "2021-03-31T09:36:05.144Z"
        }
    ]
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 204 No Content

Пример 2. Отправка данных телеметрии датчика для устройства с несколькими датчиками одного типа

В следующем примере показано, как отправлять данные телеметрии датчика для устройства с несколькими датчиками одного типа.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry
Content-Type: application/json

{
    "telemetry": [
        {
            "deviceId": "contoso_9D6816",
            "sensorId": "occupancy_1",
            "sensorType": "occupancy",
            "boolValue": false,
            "timestamp": "2021-03-31T09:36:05.144Z"
        },
        {
            "deviceId": "contoso_9D6816",
            "sensorId": "occupancy_2",
            "sensorType": "occupancy",
            "boolValue": false,
            "timestamp": "2021-03-31T09:36:05.144Z"
        }
    ]
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 204 No Content

Пример 3. Прием данных телеметрии для нескольких устройств

В следующем примере показано, как принимать данные телеметрии для нескольких устройств.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry
Content-Type: application/json

{
    "telemetry": [
        {
            "deviceId": "contoso_9D6816",
            "sensorType": "occupancy",
            "boolValue": false,
            "timestamp": "2021-03-31T09:36:05.144Z"
        },
        {
            "deviceId": "contoso_9D6817",
            "sensorType": "occupancy",
            "boolValue": false,
            "timestamp": "2021-03-31T09:36:05.144Z"
        }
    ]
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content