Tham chiếu mã lỗi API

API Quản lý thiết bị thông minh sử dụng mã lỗi gRPC tiêu chuẩn. Thông tin khác trên các mã đó, hãy xem phần xử lý lỗi.

Phản hồi lỗi trong API sẽ xuất hiện ở định dạng sau:

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

Sử dụng hộp tìm kiếm trong bảng Mã lỗi để tìm các lỗi API, cùng với các mẹo khắc phục sự cố, đặc điểm và hướng dẫn có liên quan. Bạn có thể tìm nội dung vào trường bất kỳ trong bảng.

Thông báo Lỗi HTTP RPC Khắc phục sự cố
Hình ảnh camera không còn có sẵn để tải xuống. 504 DEADLINE_EXCEEDED Hình ảnh sự kiện sẽ hết hạn sau 30 giây kể từ khi sự kiện được xuất bản. Đừng quên tải hình ảnh xuống trước khi hết hạn.

Xem thêm:
Nhiệm vụ Tải hình ảnh camera xuống
Thiết bị hiển thị
Thiết bị chuông cửa
Hướng dẫn về Sự kiện
Lệnh GenerateImage
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
Không hỗ trợ lệnh thoại cho chuông cửa. 400 FAILED_PRECONDITION Không thể kéo dài luồng WebRTC trên chuông cửa chạy bằng pin. Nếu cần xem một luồng phát trên chuông cửa sau thời lượng của phiên ban đầu, hãy dừng luồng hiện có rồi tạo một luồng mới.

Xem thêm:
Tác vụ Mở rộng sự kiện phát trực tiếp
Lệnh ExtendWebRtcStream
Không dùng được lệnh ở chế độ máy điều nhiệt hiện tại. 400 FAILED_PRECONDITION Một số mẫu máy điều nhiệt không hỗ trợ thay đổi chế độ Tiết kiệm năng lượng khi chế độ máy điều nhiệt TẮT, theo tính năng ThermostatMode . Bạn phải chuyển máy điều nhiệt thành SƯỞI ẤM, LÀM MÁT hoặc SƯỞI ẤM trước khi thay đổi chế độ Tiết kiệm năng lượng.

Xem thêm:
Tác vụ Thay đổi chế độ
Lệnh SetMode
ThermostatMode trait
ThermostatTemperatureSetpoint trait
Không được phép dùng lệnh khi máy điều nhiệt ở chế độ MANUAL_ECO. 400 FAILED_PRECONDITION Không thể đặt điểm đặt nhiệt độ khi máy điều nhiệt ở chế độ Tiết kiệm năng lượng thủ công.

Xem thêm:
Tác vụ Thay đổi điểm đặt nhiệt độ
ThermostatEco trait
ThermostatTemperatureSetpoint trait
Chưa cung cấp lệnh. 404 NOT_FOUND Một lệnh được thực thi mà không có tên lệnh hợp lệ trong phần nội dung yêu cầu. Nhập một lệnh hợp lệ.
Không hỗ trợ lệnh. 400 INVALID_ARGUMENT Dùng lệnh phát trực tiếp RTSP cho máy quay có hỗ trợ WebRTC hoặc dùng lệnh phát trực tiếp qua WebRTC cho máy quay có hỗ trợ RTSP.

Xem thêm:
Nhiệm vụ Tải hình ảnh camera xuống
Chứa một giá trị không hợp lệ. 400 INVALID_ARGUMENT Bạn đã gửi một lệnh có giá trị không hợp lệ trong các đối số. Hãy đảm bảo bạn gửi một giá trị hợp lệ.
Giá trị làm mát phải lớn hơn giá trị nhiệt. 400 INVALID_ARGUMENT Đảm bảo trường heatCelsius nhỏ hơn trường coolCelsius trong lệnh của bạn.

Xem thêm:
Tác vụ Thay đổi điểm đặt nhiệt độ
ThermostatTemperatureSetpoint trait
Không tìm thấy thiết bị. 404 NOT_FOUND Bạn đã chỉ định tên thiết bị không hợp lệ hoặc bị thiếu. Hãy chỉ định một thiết bị hợp lệ.

Xem thêm:
Khả năng kết nối lợi ích
Không tìm thấy Enterprise. 404 NOT_FOUND Bạn đã chỉ định mã nhận dạng Project không hợp lệ hoặc bị thiếu. Hãy chỉ định mã nhận dạng Project hợp lệ.
Mã sự kiện không thuộc về camera. 400 FAILED_PRECONDITION Sử dụng đúng eventID do sự kiện máy ảnh trả về.

Xem thêm:
Xử lý các sự kiện liên quan đến camera
Thiết bị hiển thị
Xử lý sự kiện liên quan đến chuông cửa và camera
Hướng dẫn về Sự kiện
CameraEventImage trait
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
Không truy xuất được SDP câu trả lời do hết thời gian chờ. 504 DEADLINE_EXCEEDED Hãy thử tạo lại sự kiện phát trực tiếp WebRTC.

Xem thêm:
Trường không xuất hiện trong đặc điểm. 400 INVALID_ARGUMENT Đã gửi một lệnh không được hỗ trợ để tìm một trait.
SDP ưu đãi không hợp lệ bị thiếu CRLF. 400 INVALID_ARGUMENT Thiếu ký tự dòng mới ở cuối chuỗi offerSdp khi cố gắng tạo luồng WebRTC. Đảm bảo chuỗi offerSdp kết thúc bằng \r\n hoặc \n rồi thử tạo lại sự kiện phát trực tiếp.

Xem thêm:
Đường liên kết trực tiếp đến SDP cho ưu đãi không hợp lệ. 400 INVALID_ARGUMENT SDP của ưu đãi phải chứa cả ba dòng âm thanh, video và ứng dụng theo thứ tự đó.

Xem thêm:
SDP của ưu đãi không hợp lệ. 400 INVALID_ARGUMENT Bạn phải đặt âm thanh SDP của ưu đãi thành a=recvonly (chỉ nhận).

Xem thêm:
Không được cấp quyền. 403 PERMISSION_DENIED user chưa cấp developer các quyền thích hợp ở cấp thiết bị trong Trình quản lý kết nối đối tác (PCM) cần thiết để thực thi một .

Khi bạn tạo một sự kiện phát trực tiếp WebRTC, lỗi này cũng có thể có nghĩa là chế độ cài đặt âm thanh trong offerSdp không chính xác.

Xem thêm:
Nhiệm vụ Liên kết tài khoản
Lệnh GenerateWebRtcStream
Mức giới hạn. 429 RESOURCE_EXHAUSTED Mỗi nhà phát triển có một hạn mức giới hạn số lượng lệnh gọi mà họ có thể thực hiện. Nếu thực hiện nhiều cuộc gọi hơn hạn mức, bạn sẽ nhận được thông báo Bị giới hạn tốc độ. Để khắc phục vấn đề này, hãy gửi lại cuộc gọi sau khi hết hạn mức.

Xem thêm:
Khái niệm về Giới hạn số lượng của hộp cát
Không tìm thấy phòng. 404 NOT_FOUND Phòng không tồn tại trong nhà. Gọi danh sách đến tài nguyên của phòng để xác minh mã phòng.
Không tìm thấy cấu trúc. 404 NOT_FOUND Cấu trúc này không tồn tại trong Project. Thực hiện lệnh gọi danh sách đến tài nguyên cấu trúc để xác minh mã nhận dạng cấu trúc.
Camera không dùng được để phát trực tuyến. 400 FAILED_PRECONDITION Camera không có kết nối mạng hoặc không phát trực tuyến được do vấn đề kỹ thuật.

Xem thêm:
Thiết bị máy ảnh
Thiết bị Máy ảnh (pin)
Thiết bị Máy ảnh (có dây)
Thiết bị chuông cửa (pin)
Thiết bị chuông cửa (có dây)
Lệnh GenerateWebRtcStream
Không dùng được quạt điều nhiệt. 400 FAILED_PRECONDITION Máy điều nhiệt không có chức năng quạt. Không dùng được các lệnh và đặc điểm liên quan đến quạt trên thiết bị này.

Xem thêm:
Việc cần làm là Bật hoặc tắt quạt
Fan trait