Interfejs API zarządzania urządzeniami inteligentnymi używa standardowych kodów błędów gRPC. Więcej informacji o tych kodach znajdziesz w artykule obsługa błędów.
Odpowiedź z błędem w interfejsie API ma następujący format:
{
"error": {
"code": 404,
"message": "Device enterprises/project-id/devices/device-id not found.",
"status": "NOT_FOUND"
}
}
W polu wyszukiwania w tabeli Kody błędów możesz znaleźć błędy interfejsu API, a także wskazówki dotyczące rozwiązywania problemów oraz powiązane cechy i poradniki. Treści możesz wyszukiwać w dowolnym polu w tabeli.
| Komunikat o błędzie | HTTP | RPC | Rozwiązywanie problemów |
|---|---|---|---|
| Obraz z aparatu 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ż: Zadanie Pobieranie obrazu z kamery Urządzenie wyświetlające Urządzenie z domofonem Przewodnik po zdarzeniach GenerateImage Ruch w kamerze tryb poziomy Człowiek w kadrze tryb poziomy Dźwięk z kamerytryb poziomy Dzwonek domofonowytryb poziomy |
| Polecenie nie jest obsługiwane w przypadku dzwonka. | 400 | FAILED_PRECONDITION |
Strumień WebRTC nie może być rozszerzany na dzwonkach zasilanych bateryjką. Jeśli strumień na dzwonku ma być wyświetlany dłużej niż początkowa długość sesji, zatrzymaj i wygeneruj nowy strumień. Zobacz też: Zadanie „Przedłużanie transmisji na żywo” ExtendWebRtcStream |
| Polecenie niedozwolone w bieżącym trybie termostatu. | 400 | FAILED_PRECONDITION |
Niektóre modele termostatów nie obsługują zmiany trybu Eco, gdy tryb termostatu jest wyłączony, zgodnie z ThermostatMode w układach pionowych. Przed zmianą trybu Eco tryb termostatu należy zmienić na Ogrzewanie, Chłodzenie lub Ogrzewanie/Chłodzenie. Zobacz też: Zadanie Zmień tryb SetMode TrybTermostatu trybu TemperaturaUstawieniaTermostatu trybu |
| Polecenie niedozwolone, gdy termostat jest w trybie MANUAL_ECO. | 400 | FAILED_PRECONDITION |
Ustawienie temperatury nie jest możliwe, gdy termostat jest w ręcznym trybie Eco. Zobacz też: Zadanie Zmień ustawienie temperatury ThermostatEco trait ThermostatTemperatureSetpoint trait |
| Brak polecenia. | 404 | NOT_FOUND |
Polecenie zostało wykonane bez prawidłowej nazwy w treści żądania. Wpisz prawidłową komendę. |
| 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ż: Zadanie Pobieranie obrazu z kamery |
| Zawiera nieprawidłową wartość. | 400 | INVALID_ARGUMENT |
Przesłano polecenie z nieprawidłową wartością w argumentach. Pamiętaj, aby przesłać prawidłową wartość. |
| Wartość chłodzenia musi być większa niż wartość ogrzewania. | 400 | INVALID_ARGUMENT |
Upewnij się, że pole heatCelsius jest mniejsze niż pole coolCelsius w tym poleceniu.Zobacz też: Zadanie Zmień ustawienia temperatury ThermostatTemperatureSetpoint trait |
| Nie znaleziono urządzenia. | 404 | NOT_FOUND |
Podano nieprawidłową nazwę urządzenia lub nie podano jej wcale. Podaj prawidłowe urządzenie. Zobacz też: Połączenia tryb poziomy |
| Nie znaleziono organizacji. | 404 | NOT_FOUND |
Podano nieprawidłowy identyfikator lub nie podano go wcale. Project Podaj prawidłowy identyfikator Project . |
| Identyfikator zdarzenia nie należy do kamery. | 400 | FAILED_PRECONDITION |
Użyj prawidłowej wartości eventID zwracanej przez zdarzenie związane z kamerą.Zobacz też: Zadanie obsługi zdarzeń związanych z kamerą Wyświetlanie urządzenia Zadanie obsługi zdarzeń związanych z dzwonkiem i kamerą Przewodnik po zdarzeniach CameraEventImage trait CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait |
| Nie udało się pobrać odpowiedzi SDP z powodu przekroczenia limitu czasu. | 504 | DEADLINE_EXCEEDED |
Spróbuj ponownie wygenerować transmisję na żywo WebRTC. Zobacz też: |
| Pole nie występuje w cechach. | 400 | INVALID_ARGUMENT |
Wysłano nieobsługiwane polecenie dotyczące cechy. |
| Nieprawidłowa oferta SDP nie zawiera znaków CRLF. | 400 | INVALID_ARGUMENT |
Podczas próby wygenerowania strumienia WebRTC na końcu ciągu offerSdp brakuje znaku nowej linii. Upewnij się, że ciąg offerSdp kończy się na \r\n lub \n i spróbuj wygenerować strumień ponownie.Zobacz też: |
| Nieprawidłowe wiersze m-lines oferty SDP. | 400 | INVALID_ARGUMENT |
Oferta SDP musi zawierać wszystkie 3 wiersze m (w tej kolejności) dotyczące audio, wideo i aplikacji. Zobacz też: |
| Nieprawidłowa oferta SDP. | 400 | INVALID_ARGUMENT |
Usługa SDP audio musi być skonfigurowana na a=recvonly (tylko odbiór).Zobacz też: |
| Odmowa dostępu. | 403 | PERMISSION_DENIED |
user nie przyznał developerodpowiednich uprawnień na poziomie urządzenia w PCM wymaganych do wykonania polecenia. Podczas generowania strumienia na żywo WebRTC ten błąd może też oznaczać, że ustawienie dźwięku w offerSdp jest nieprawidłowe.Zobacz też: Zadania dotyczące łączenia kont GenerateWebRtcStream (generowanie strumienia WebRTC) |
| Ograniczenie liczby żądań. | 429 | RESOURCE_EXHAUSTED |
Każdy deweloper ma limit określający, ile wywołań może wykonać. Jeśli wykonasz więcej połączeń niż pozwala na to limit, otrzymasz komunikat o ograniczeniu stawki. Aby to naprawić, ponownie prześlij zgłoszenie, gdy upłynie limit. Zobacz też: koncepcja limitów stawek w piaskownicy |
| Nie znaleziono pokoju. | 404 | NOT_FOUND |
Pokój nie istnieje w strukturze. Aby zweryfikować identyfikator pokoju, wywołaj listę zasobu rooms. |
| Nie znaleziono struktury. | 404 | NOT_FOUND |
Struktura nie istnieje w Project. Aby sprawdzić identyfikator struktury, wywołaj listę zasobów struktury. |
| Kamera nie jest dostępna do przesyłania strumieniowego. | 400 | FAILED_PRECONDITION |
Kamera jest offline lub niedostępna do streamingu z powodu problemu technicznego. Zobacz też: Urządzenie z kamerą Urządzenie z kamerą (na baterie) Urządzenie z kamerą (na przewodzie) Urządzenie z dzwonkiem (na baterie) Urządzenie z dzwonkiem (na przewodzie) GenerateWebRtcStream |
| Wentylator termostatu niedostępny. | 400 | FAILED_PRECONDITION |
Termostat nie ma możliwości sterowania wentylatorem. Na tym urządzeniu nie można używać funkcji i komend związanych z wentylatorem. Zobacz też: Zadanie Włączanie i wyłączanie wentylatora Funkcja |