Die Smart Device Management API verwendet Standard-gRPC-Fehlercodes. Weitere Informationen zu diesen Codes finden Sie unter Fehlerbehandlung.
Eine Fehlermeldung in der API hat das folgende Format:
{
"error": {
"code": 404,
"message": "Device enterprises/project-id/devices/device-id not found.",
"status": "NOT_FOUND"
}
}
Verwenden Sie das Suchfeld in der Tabelle „Fehlercodes“, um API-Fehler sowie Tipps zur Fehlerbehebung und zugehörige Traits und Leitfäden zu finden. Sie können in jedem Feld der Tabelle nach Inhalten suchen.
| Fehlermeldung | HTTP | RPC | Fehlerbehebung |
|---|---|---|---|
| Das Kamerabild kann nicht mehr heruntergeladen werden. | 504 | DEADLINE_EXCEEDED |
Ereignisbilder laufen 30 Sekunden nach der Veröffentlichung des Ereignisses ab. Laden Sie das Bild vor Ablauf herunter. Weitere Informationen: Aufgabe „Kamerabild herunterladen“ Displaygerät Türklingel Leitfaden zu Ereignissen GenerateImage Trait „CameraMotion“ Trait „CameraPerson“ Trait „CameraSound“ Trait „DoorbellChime“ |
| Der Befehl wird für die Türklingel nicht unterstützt. | 400 | FAILED_PRECONDITION |
Ein WebRTC-Stream kann bei akkubetriebenen Türklingeln nicht verlängert werden. Wenn ein Stream auf einer Türklingel über die erste Sitzungslänge hinaus angesehen werden soll, beenden Sie den vorhandenen Stream und erstellen Sie einen neuen. Weitere Informationen: Aufgabe „Livestream verlängern“ ExtendWebRtcStream |
| Der Befehl ist im aktuellen Thermostatmodus nicht zulässig. | 400 | FAILED_PRECONDITION |
Einige Thermostatmodelle unterstützen laut dem Trait „ThermostatMode“ das Ändern des Eco-Modus nicht, wenn der Thermostatmodus „OFF“ ist. Der Thermostatmodus muss in „HEAT“, „COOL“ oder „HEATCOOL“ geändert werden, bevor der Eco-Modus geändert werden kann. Weitere Informationen: Aufgabe „Modus ändern“ SetMode Trait „ThermostatMode“ Trait „ThermostatTemperatureSetpoint“ |
| Der Befehl ist nicht zulässig, wenn sich der Thermostat im Modus „MANUAL_ECO“ befindet. | 400 | FAILED_PRECONDITION |
Der Temperatursollwert kann nicht festgelegt werden, wenn sich der Thermostat im manuellen Eco-Modus befindet. Weitere Informationen: Aufgabe „Temperatursollwerte ändern“ Trait „ThermostatEco“ Trait „ThermostatTemperatureSetpoint“ |
| Der Befehl wurde nicht angegeben. | 404 | NOT_FOUND |
Ein Befehl wurde ohne einen gültigen Befehlsnamen im Anfragetextkörper ausgeführt. Geben Sie einen gültigen Befehl ein. |
| Der Befehl wird nicht unterstützt. | 400 | INVALID_ARGUMENT |
Sie haben einen RTSP-Livestream-Befehl für eine Kamera verwendet, die WebRTC unterstützt, oder einen WebRTC-Livestream-Befehl für eine Kamera verwendet, die RTSP unterstützt. Weitere Informationen: Aufgabe „Kamerabild herunterladen“ |
| Enthält einen ungültigen Wert. | 400 | INVALID_ARGUMENT |
Ein Befehl wurde mit einem ungültigen Wert in den Argumenten gesendet. Senden Sie einen gültigen Wert. |
| Der Kühlwert muss größer als der Heizwert sein. | 400 | INVALID_ARGUMENT |
Achten Sie darauf, dass das heatCelsius Feld in Ihrem Befehl kleiner als das coolCelsius Feld ist.Weitere Informationen: Aufgabe „Temperatursollwerte ändern“ Trait „ThermostatTemperatureSetpoint“ |
| Gerät nicht gefunden. | 404 | NOT_FOUND |
Es wurde ein ungültiger oder fehlender Gerätename angegeben. Geben Sie ein gültiges Gerät an. Weitere Informationen: Trait „Connectivity“ |
| Unternehmen nicht gefunden. | 404 | NOT_FOUND |
Es wurde eine ungültige oder fehlende Project ID angegeben. Geben Sie eine gültige Project ID an. |
| Die Ereignis-ID gehört nicht zur Kamera. | 400 | FAILED_PRECONDITION |
Verwenden Sie die korrekte eventID die vom Kamera-Ereignis zurückgegeben wurde.Weitere Informationen: Kamera-Ereignisse verarbeiten Aufgabe Display Gerät Türklingel- und Kamera-Ereignisse verarbeiten Aufgabe Ereignisse Leitfaden CameraEventImage Trait CameraMotion Trait CameraPerson Trait CameraSound Trait DoorbellChime Trait |
| Antwort-SDP konnte aufgrund eines Zeitlimits nicht abgerufen werden. | 504 | DEADLINE_EXCEEDED |
Versuchen Sie noch einmal, den WebRTC-Livestream zu generieren. Weitere Informationen: |
| Das Feld ist in den Traits nicht vorhanden. | 400 | INVALID_ARGUMENT |
Für ein Trait wurde ein nicht unterstützter Befehl gesendet. |
| Ungültige Angebots-SDP: CRLF fehlt. | 400 | INVALID_ARGUMENT |
Beim Versuch, einen WebRTC-Stream zu generieren, fehlt das Zeilenumbruchzeichen am Ende des Strings offerSdp. Achten Sie darauf, dass der offerSdp String mit \r\n oder \n endet, und versuchen Sie noch einmal, den Stream zu generieren.Weitere Informationen: |
| Ungültige Angebots-SDP-m-Zeilen. | 400 | INVALID_ARGUMENT |
Die Angebots-SDP muss alle drei m-Zeilen für Audio, Video und Anwendung in dieser Reihenfolge enthalten. Weitere Informationen: |
| Ungültige Angebots-SDP. | 400 | INVALID_ARGUMENT |
Die Angebots-SDP-Audio muss auf a=recvonly (nur empfangen) festgelegt sein.Weitere Informationen: |
| Berechtigung verweigert. | 403 | PERMISSION_DENIED |
Der user hat dem developer
nicht die entsprechenden Berechtigungen auf Geräteebene im Partner Connections Manager (PCM) gewährt, die zum Ausführen eines
Befehls erforderlich sind. Beim Generieren eines WebRTC-Livestreams kann dieser Fehler auch bedeuten, dass die Audioeinstellung in der offerSdp falsch ist.Weitere Informationen: Aufgabe „Konto verknüpfen“ GenerateWebRtcStream |
| Limit erreicht. | 429 | RESOURCE_EXHAUSTED |
Für jeden Entwickler gibt es ein Kontingent, das die Anzahl der Aufrufe begrenzt. Wenn Sie mehr Aufrufe tätigen als Ihr Kontingent zulässt, wird die Meldung „Limit erreicht“ angezeigt. Um dieses Problem zu beheben, senden Sie den Aufruf noch einmal, nachdem das Kontingent abgelaufen ist. Weitere Informationen: Konzept „Ratenlimits für die Sandbox“ |
| Raum nicht gefunden. | 404 | NOT_FOUND |
Der Raum ist in der Struktur nicht vorhanden. Führen Sie einen Listenaufruf für die Ressource „rooms“ aus, um die Raum-ID zu überprüfen. |
| Struktur nicht gefunden. | 404 | NOT_FOUND |
Die Struktur ist im Projectnicht vorhanden. Führen Sie einen Listenaufruf für die Ressource „structure“ aus, um die Struktur-ID zu überprüfen. |
| Die Kamera ist für das Streaming nicht verfügbar. | 400 | FAILED_PRECONDITION |
Die Kamera ist entweder offline oder aufgrund eines technischen Problems nicht für das Streaming verfügbar. Weitere Informationen: Kamera Kamera (mit Akku) Kamera (mit Kabel) Türklingel (mit Akku) Türklingel (mit Kabel) GenerateWebRtcStream |
| Thermostatventilator nicht verfügbar. | 400 | FAILED_PRECONDITION |
Der Thermostat hat keine Ventilatorfunktion. Ventilatorbezogene Traits und Befehle können für dieses Gerät nicht verwendet werden. Weitere Informationen: Aufgabe „Ventilator ein- oder ausschalten“ Trait „Fan“ |