Dokumentacja kodu błędów interfejsu API

Interfejs Smart Device Management API używa standardowych kodów błędów gRPC. Więcej informacji o tych kodach znajdziesz w artykule Obsługa błędów.

Odpowiedź o błędzie w interfejsie API ma taki format:

{
  "error": {
    "code": 404,
    "message": "Device enterprises/project-id/devices/device-id not found.",
    "status": "NOT_FOUND"
  }
}

W polu wyszukiwania w tabeli kodów błędów znajdź błędy interfejsu API wraz ze wskazówkami dotyczącymi rozwiązywania problemów oraz powiązanymi cechami i przewodnikami. Możesz wyszukiwać treści w dowolnym polu w tabeli.

Komunikat o błędzie HTTP RPC Rozwiązywanie problemów
Obraz z kamery nie jest już dostępny do pobrania. 504 DEADLINE_EXCEEDED Obrazy wydarzeń wygasają 30 sekund po opublikowaniu wydarzenia. Pamiętaj, aby pobrać obraz przed wygaśnięciem.

Zobacz też:
  Pobieranie obrazu z kamery
  Wyświetlanie urządzenia
  Urządzenie Doorbell
  Przewodnik po zdarzeniach
  Polecenie GenerateImage
  cecha CameraMotion
  cecha CameraPerson
  cecha CameraSound
  cecha DoorbellChime
Polecenie nie jest obsługiwane w przypadku dzwonka. 400 FAILED_PRECONDITION Nie można przedłużyć strumienia WebRTC w przypadku dzwonków zasilanych bateryjnie. Jeśli strumień z dzwonka do drzwi musi być wyświetlany dłużej niż początkowa długość sesji, zatrzymaj istniejący strumień i wygeneruj nowy.

Zobacz też:
  Zadanie przedłużania transmisji na żywo
  ExtendWebRtcStream
Polecenie jest niedozwolone w bieżącym trybie termostatu. 400 FAILED_PRECONDITION Niektóre modele termostatów nie obsługują zmiany trybu Eko, gdy termostat jest wyłączony, zgodnie z atrybutem ThermostatMode . Przed zmianą trybu Eko należy zmienić tryb termostatu na OGRZEWANIE, CHŁODZENIE lub OGRZEWANIE/CHŁODZENIE.

Zobacz też:
  Zmienianie trybu
  SetMode
  Cechy urządzenia ThermostatMode
  Cechy urządzenia ThermostatTemperatureSetpoint
Polecenie jest niedozwolone, gdy termostat jest w trybie MANUAL_ECO. 400 FAILED_PRECONDITION Nastawy temperatury nie można ustawić, gdy termostat jest w ręcznym trybie Eko.

Zobacz też:
  Zmienianie nastaw temperatury
  ThermostatEco trait
  ThermostatTemperatureSetpoint trait
Nie podano polecenia. 404 NOT_FOUND Polecenie zostało wykonane bez prawidłowej nazwy polecenia w treści żądania. Wpisz prawidłowe polecenie.
Polecenie nie jest obsługiwane. 400 INVALID_ARGUMENT Użyto polecenia transmisji na żywo RTSP w przypadku kamery obsługującej WebRTC lub polecenia transmisji na żywo WebRTC w przypadku kamery obsługującej RTSP.

Zobacz też:
  Pobieranie obrazu z kamery
Zawiera nieprawidłową wartość. 400 INVALID_ARGUMENT Przesłano polecenie z nieprawidłową wartością w argumentach. Upewnij się, że wysyłasz prawidłową wartość.
Wartość chłodzenia musi być większa niż wartość ogrzewania. 400 INVALID_ARGUMENT Upewnij się, że wartość w polu heatCelsius jest mniejsza niż wartość w polu coolCelsius w poleceniu.

Zobacz też:
  Zmienianie nastawy temperatury
  ThermostatTemperatureSetpoint cecha
Nie znaleziono urządzenia. 404 NOT_FOUND Określono nieprawidłową lub brakującą nazwę urządzenia. Podaj prawidłowe urządzenie.

Zobacz też:
  cecha Connectivity
Nie znaleziono firmy. 404 NOT_FOUND Podano nieprawidłowy lub brakujący Project identyfikator. Podaj prawidłowy Project identyfikator.
Identyfikator zdarzenia nie należy do kamery. 400 FAILED_PRECONDITION Użyj prawidłowego eventID zwróconego przez zdarzenie kamery

.Zobacz też:
  Obsługa zdarzeń kamery
  Wyświetlanie urządzenia
  Obsługa zdarzeń dzwonka do drzwi i kamery
  Przewodnik po zdarzeniach
  CameraEventImage
  CameraMotion
  CameraPerson
  CameraSound
  DoorbellChime
Nie udało się pobrać SDP odpowiedzi z powodu przekroczenia limitu czasu. 504 DEADLINE_EXCEEDED Spróbuj ponownie wygenerować transmisję na żywo WebRTC.

Zobacz też:
Pola nie ma w atrybutach. 400 INVALID_ARGUMENT Wysłano nieobsługiwane polecenie dotyczące cechy.
Nieprawidłowa oferta SDP – brak CRLF. 400 INVALID_ARGUMENT Podczas próby wygenerowania strumienia WebRTC na końcu ciągu offerSdp brakuje znaku nowego wiersza. Sprawdź, czy ciąg offerSdp kończy się znakiem \r\n lub \n, i spróbuj ponownie wygenerować strumień.

Zobacz też:
Nieprawidłowe wiersze m w SDP oferty. 400 INVALID_ARGUMENT Oferta SDP musi zawierać wszystkie 3 wiersze m: audio, wideo i aplikacja w tej kolejności.

Zobacz też:
Nieprawidłowa oferta SDP. 400 INVALID_ARGUMENT Oferta SDP audio musi być ustawiona na a=recvonly (tylko odbieranie).

Zobacz też:
Odmowa dostępu. 403 PERMISSION_DENIED user nie przyznał developerodpowiednich uprawnień na poziomie urządzenia w Menedżerze połączeń z partnerami (PCM), które są wymagane do wykonania polecenia.

Podczas generowania transmisji na żywo WebRTC ten błąd może też oznaczać, że ustawienie dźwięku w offerSdp jest nieprawidłowe.

Zobacz też:
  Zadanie „Połącz konto”
  GenerateWebRtcStream
Ograniczona liczba żądań. 429 RESOURCE_EXHAUSTED Każdy deweloper ma limit określający liczbę wywołań, które może wykonać. Jeśli wykonasz więcej połączeń niż wynosi Twój limit, zobaczysz komunikat o ograniczeniu liczby połączeń. Aby to naprawić, prześlij wywołanie ponownie po wygaśnięciu limitu.

Zobacz też:
  Limity żądań w środowisku piaskownicy
Nie znaleziono pokoju. 404 NOT_FOUND Tego pomieszczenia nie ma w strukturze. Wywołaj listę zasobów pokoju, aby sprawdzić identyfikator pokoju.
Nie znaleziono struktury. 404 NOT_FOUND Struktura nie istnieje w  Project. Wykonaj wywołanie listy do zasobu struktury, aby sprawdzić identyfikator struktury.
Kamera nie jest dostępna do przesyłania strumieniowego. 400 FAILED_PRECONDITION Kamera jest offline lub niedostępna do przesyłania strumieniowego z powodu problemu technicznego.

Zobacz też:
  Kamera
  Kamera (na baterie)
  Kamera (przewodowa)
  Dzwonek (na baterie)
  Dzwonek (przewodowy)
  Polecenie GenerateWebRtcStream
Wentylator termostatu jest niedostępny. 400 FAILED_PRECONDITION Termostat nie ma funkcji wentylatora. W przypadku tego urządzenia nie można używać cech i poleceń związanych z wentylatorem.

Zobacz też:
  Włączanie i wyłączanie wentylatora
  Cecha wentylatora