API-Fehlercode-Referenz

Die Smart Device Management API verwendet standardmäßige gRPC-Fehlercodes. Weitere Informationen finden Sie unter Fehlerbehandlung.

Eine Fehlerantwort wird in der API im folgenden Format angezeigt:

{
  "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 sowie zugehörige Traits und Leitfäden. Du kannst nach Inhalten suchen in einem beliebigen Feld der Tabelle.

Fehlermeldung	HTTP	RPC	Fehlerbehebung
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 dem Ablaufdatum herunter. Weitere Informationen: Aufgabe Kamerabild herunterladen Anzeige Türklingel Leitfaden für Ereignisse Befehl GenerateImage CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait
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 an einer Türklingel über die anfängliche Länge hinaus angesehen werden soll, beende den bestehenden Stream und erstelle einen neuen. Siehe auch: Aufgabe Livestream verlängern Befehl ExtendWebRtcStream
Dieser Befehl ist im aktuellen Thermostatmodus nicht zulässig.	400	FAILED_PRECONDITION	Laut der Eigenschaft Thermostatmodus kann bei einigen Thermostatmodellen der Eco-Modus nicht geändert werden, wenn der Thermostatmodus ausgeschaltet ist. Der Modus des Thermostats muss vor dem Ändern des Eco-Modus zu HEIZEN, KÜHLEN oder HEIZEN gewechselt werden. Weitere Informationen: Aufgabe Modus ändern SetMode-Befehl ThermostatMode trait ThermostatTemperatureSetpoint trait
Befehl nicht zulässig, wenn sich der Thermostat im MANUAL_ECO-Modus befindet.	400	FAILED_PRECONDITION	Im manuellen Eco-Modus kann der Temperatursollwert nicht festgelegt werden. Weitere Informationen: Aufgabe Temperatursollwerte ändern ThermostatEco trait ThermostatTemperatureSetpoint trait
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	Hat einen RTSP-Livestream-Befehl für eine Kamera verwendet, die WebRTC unterstützt, oder einen WebRTC-Livestream-Befehl für eine Kamera, 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. Achten Sie darauf, einen gültigen Wert zu senden.
Der Kühlwert muss größer als der Heizwert sein.	400	INVALID_ARGUMENT	Achten Sie darauf, dass das Feld heatCelsius kleiner ist als das Feld coolCelsius in Ihrem Befehl. Weitere Informationen: Aufgabe Temperatursollwerte ändern ThermostatTemperatureSetpoint trait
Gerät nicht gefunden.	404	NOT_FOUND	Der angegebene Gerätename ist ungültig oder fehlt. Geben Sie ein gültiges Gerät an. Siehe auch: Konnektivitäts- 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	Verwende den korrekten eventID, der vom Kameraereignis zurückgegeben wurde. Weitere Informationen: Aufgabe Kamera-Ereignisse verarbeiten Anzeigegerät Aufgabe Türklingel- und Kamera-Ereignisse verarbeiten Leitfaden für Ereignisse CameraEventImage trait CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait
Das Antwort-SDP konnte aufgrund einer Zeitüberschreitung nicht abgerufen werden.	504	DEADLINE_EXCEEDED	Versuchen Sie noch einmal, den WebRTC-Livestream zu generieren. Weitere Informationen:
Feld ist in Traits nicht vorhanden.	400	INVALID_ARGUMENT	Für ein Trait wurde ein nicht unterstützter Befehl gesendet.
Für den ungültigen Angebots-SDP fehlt eine CRLF.	400	INVALID_ARGUMENT	Das Zeilenvorschubzeichen fehlt am Ende des Strings offerSdp, wenn versucht wird, einen WebRTC-Stream zu generieren. Achten Sie darauf, dass der String offerSdp 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	Das Angebots-SDP muss alle drei Audio-, Video- und App-M-Zeilen in dieser Reihenfolge enthalten. Siehe auch:
Ungültige Angebots-SDP.	400	INVALID_ARGUMENT	SDP-Audio für das Angebot muss auf a=recvonly (nur Empfang) eingestellt sein. Siehe auch:
Berechtigung verweigert.	403	PERMISSION_DENIED	user hat developernicht gewährt. die entsprechenden Berechtigungen auf Geräteebene im Partner Connections Manager (PCM), die zum Ausführen einer Beim Generieren eines WebRTC-Livestreams kann dieser Fehler auch bedeutet, dass die Audioeinstellung in offerSdp falsch ist. Siehe auch: Aufgabe Konto verknüpfen GenerateWebRtcStream-Befehl
Ratenbegrenzung.	429	RESOURCE_EXHAUSTED	Jeder Entwickler hat ein Kontingent für die Anzahl der Aufrufe, die er tätigen kann. Wenn mehr Anrufe Ihr Kontingent überschreiten, erhalten Sie die Nachricht „Ratenbegrenzung“. Um dieses Problem zu beheben, reichen Sie den Aufruf noch einmal ein, sobald das Kontingent abgelaufen ist. Weitere Informationen: Konzept der Sandbox-Ratenbegrenzungen
Raum nicht gefunden.	404	NOT_FOUND	Der Raum ist im Gebäude nicht vorhanden. Rufen Sie die Raumressource mit einem Listenaufruf auf, um die Raum-ID zu prüfen.
Gebäude nicht gefunden.	404	NOT_FOUND	Die Struktur ist in Projectnicht vorhanden. Rufen Sie die Strukturressource in einem Listenaufruf auf, um die Struktur-ID zu überprüfen.
Die Kamera ist nicht zum Streamen verfügbar.	400	FAILED_PRECONDITION	Aufgrund eines technischen Problems ist die Kamera entweder offline oder kann nicht gestreamt werden. Weitere Informationen: Kameragerät Kamera (mit Akku) Kamera (mit Kabel) Türklingel (mit Akku) Türklingel (mit Kabel) Befehl GenerateWebRtcStream
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: Aufgabe Lüfter ein- oder ausschalten Fan trait