Die Smart Device Management API verwendet standardmäßige gRPC-Fehlercodes. Weitere Informationen zu diesen Codes finden Sie unter Fehlerbehandlung.
Eine Fehlerantwort 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 Merkmale und Anleitungen 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 des Gültigkeitszeitraums herunter. Weitere Informationen finden Sie unter: Aufgabe Kamerabild herunterladen Display Türklingel Leitfaden zu Ereignissen Befehl GenerateImage CameraMotion Merkmal CameraPerson Merkmal CameraSound Merkmal DoorbellChime Merkmal |
| Befehl wird für Türklingeln nicht unterstützt. | 400 | FAILED_PRECONDITION |
Ein WebRTC-Stream kann bei akkubetriebenen Türklingeln nicht erweitert werden. Wenn ein Stream einer Türklingel über die ursprüngliche Sitzungsdauer hinaus angesehen werden soll, beenden Sie den vorhandenen Stream und generieren Sie einen neuen. Weitere Informationen finden Sie unter: Aufgabe Livestream verlängern Befehl ExtendWebRtcStream |
| Befehl ist im aktuellen Thermostatmodus nicht zulässig. | 400 | FAILED_PRECONDITION |
Einige Thermostatmodelle unterstützen laut dem Attribut ThermostatMode nicht, den Eco-Modus zu ändern, wenn der Thermostatmodus deaktiviert ist. Der Thermostatmodus muss auf „HEIZEN“, „KÜHLEN“ oder „HEIZEN/KÜHLEN“ gestellt sein, bevor der Eco-Modus geändert werden kann. Siehe auch: Aufgabe Modus ändern Befehl SetMode ThermostatMode ThermostatTemperatureSetpoint |
| Befehl 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. Siehe auch: Aufgabe Temperatursollwerte ändern ThermostatEco ThermostatTemperatureSetpoint |
| Befehl nicht angegeben. | 404 | NOT_FOUND |
Ein Befehl wurde ohne gültigen Befehlsnamen im Anfragetext ausgeführt. Geben Sie einen gültigen Befehl ein. |
| Befehl wird nicht unterstützt. | 400 | INVALID_ARGUMENT |
Sie haben einen RTSP-Livestreambefehl für eine Kamera verwendet, die WebRTC unterstützt, oder einen WebRTC-Livestreambefehl für eine Kamera verwendet, die RTSP unterstützt. Weitere Informationen finden Sie unter: Aufgabe Kamerabild herunterladen |
| Enthält einen ungültigen Wert. | 400 | INVALID_ARGUMENT |
Ein Befehl mit einem ungültigen Wert in den Argumenten wurde gesendet. Achten Sie darauf, einen gültigen Wert zu senden. |
| Der Wert für „Kühlen“ muss größer als der Wert für „Heizen“ sein. | 400 | INVALID_ARGUMENT |
Das Feld heatCelsius muss kleiner als das Feld coolCelsius in Ihrem Befehl sein.Siehe auch: Aufgabe „Temperaturen ändern“ ThermostatTemperatureSetpoint -Attribut |
| 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 finden Sie unter: Konnektivität Merkmal |
| Unternehmen nicht gefunden. | 404 | NOT_FOUND |
Es wurde eine ungültige oder fehlende Project ID angegeben. Gib eine gültige Project ID an. |
| Ereignis-ID gehört nicht zur Kamera. | 400 | FAILED_PRECONDITION |
Verwenden Sie die richtige eventID, die vom Kameraereignis zurückgegeben wird.Weitere Informationen finden Sie unter: Aufgabe Kameraereignisse verarbeiten Display Aufgabe Türklingel- und Kameraereignisse verarbeiten Leitfaden zu Ereignissen CameraEventImage Merkmal CameraMotion Merkmal CameraPerson Merkmal CameraSound Merkmal DoorbellChime Merkmal |
| Das Antwort-SDP konnte aufgrund einer Zeitüberschreitung nicht abgerufen werden. | 504 | DEADLINE_EXCEEDED |
Versuche noch einmal, den WebRTC-Livestream zu generieren. Weitere Informationen: |
| Das Feld ist in den Merkmalen nicht vorhanden. | 400 | INVALID_ARGUMENT |
Für ein Attribut wurde ein nicht unterstützter Befehl gesendet. |
| Im ungültigen Angebots-SDP fehlt CRLF. | 400 | INVALID_ARGUMENT |
Am Ende des offerSdp-Strings fehlt das Zeilenumbruchzeichen, wenn versucht wird, einen WebRTC-Stream zu generieren. Achte darauf, dass der offerSdp-String auf \r\n oder \n endet, und versuche noch einmal, den Stream zu generieren.Weitere Informationen: |
| Ungültige SDP-M-Zeilen des Angebots | 400 | INVALID_ARGUMENT |
Das Angebots-SDP muss alle drei M-Linien für Audio, Video und Anwendung in dieser Reihenfolge enthalten. Weitere Informationen finden Sie hier: |
| Ungültiges SDP-Angebot. | 400 | INVALID_ARGUMENT |
Das SDP-Audio des Angebots muss auf a=recvonly (nur empfangen) festgelegt sein.Weitere Informationen finden Sie unter |
| Berechtigung verweigert. | 403 | PERMISSION_DENIED |
Der user hat dem developernicht 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 im offerSdp falsch ist.Weitere Informationen finden Sie unter: Aufgabe Konto verknüpfen Befehl GenerateWebRtcStream |
| Ratenbegrenzung. | 429 | RESOURCE_EXHAUSTED |
Für jeden Entwickler gilt ein Kontingent, das die Anzahl der Aufrufe begrenzt. Wenn Sie mehr Anrufe als Ihr Kontingent starten, erhalten Sie die Meldung „Anzahl der Anrufe begrenzt“. Um dieses Problem zu beheben, reichen Sie den Aufruf noch einmal ein, sobald das Kontingent abgelaufen ist. Siehe auch: Konzept der Sandbox-Ratenbegrenzung |
| Der Raum wurde nicht gefunden. | 404 | NOT_FOUND |
Der Raum ist im Gebäude nicht vorhanden. Rufe die Ressourcenliste für „rooms“ auf, um die Raum-ID zu überprüfen. |
| Gebäude nicht gefunden. | 404 | NOT_FOUND |
Die Struktur ist in der Projectnicht vorhanden. Rufen Sie die Strukturressource auf, um die Gebäude-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 finden Sie unter: Kamera Kamera (mit Akku) Kamera (mit Kabel) Türklingel (mit Akku) Türklingel (mit Kabel) GenerateWebRtcStream-Befehl |
| Lüfter des Thermostats nicht verfügbar. | 400 | FAILED_PRECONDITION |
Der Thermostat hat keine Lüfterfunktion. Fan-bezogene Traits und Befehle können für dieses Gerät nicht verwendet werden. Siehe auch: Lüfter ein- oder ausschalten Fan Trait |