Freigeben über


workplaceSensorDevice: ingestTelemetry

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erfassen von Sensortelemetriedaten für ein Arbeitsplatzsensorgerät.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) PlaceDevice.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung PlaceDeviceTelemetry.ReadWrite.All PlaceDevice.ReadWrite.All

HTTP-Anforderung

POST /workplace/sensorDevices/ingestTelemetry

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

Die sensorId-Eigenschaft kann im workplaceSensorDeviceTelemetry-Objekt für Geräte mit eindeutigen Sensortypen ausgelassen werden. Wenn diese Eigenschaft nicht angegeben wird, dient der sensorType-Wert als Standardbezeichner, der mit dem Verhalten übereinstimmt, wenn Sie ein Gerät ohne angegebene sensorId erstellen.

Die folgende Tabelle zeigt die Parameter, die Sie mit dieser Aktion verwenden können.

Parameter Typ Beschreibung
Telemetrie workplaceSensorDeviceTelemetry-Sammlung Eine Sammlung der Telemetriedaten, die von einem Sensor auf einem Gerät gesammelt und gemeldet werden, z. B. Belegung, Anzahl von Personen, abgeleitete Belegung, Temperatur und mehr.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Beispiel 1: Senden von Sensortelemetriedaten für ein Gerät mit eindeutigen Sensortypen

Das folgende Beispiel zeigt, wie Sensortelemetriedaten für ein Gerät mit eindeutigen Sensortypen gesendet werden.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Senden von Sensortelemetriedaten für ein Gerät mit mehreren Sensoren desselben Typs

Das folgende Beispiel zeigt, wie Sensortelemetriedaten für ein Gerät gesendet werden, das über mehrere Sensoren desselben Typs verfügt.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 3: Erfassen von Telemetriedaten für mehrere Geräte

Das folgende Beispiel zeigt, wie Telemetriedaten für mehrere Geräte erfasst werden.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content