Tham chiếu mã lỗi API

Smart Device Management API sử dụng mã lỗi gRPC tiêu chuẩn. Để biết thêm thông tin về các mã này, hãy xem phần xử lý lỗi.

Phản hồi lỗi trong API 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 lỗi API, cùng với các mẹo khắc phục sự cố và các đặc điểm cũng như hướng dẫn liên quan. Bạn có thể tìm kiếm nội dung trong bất kỳ trường nào trong bảng.

Thông báo Lỗi HTTP RPC Khắc phục sự cố
Bạn không thể tải hình ảnh từ camera xuống nữa. 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. Hãy nhớ tải hình ảnh xuống trước khi hết hạn.

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

Xem thêm:
  Kéo dài sự kiện phát trực tiếp
  Lệnh ExtendWebRtcStream
Không được phép dùng lệnh này ở chế độ hiện tại của máy điều nhiệt. 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 máy điều nhiệt ở chế độ TẮT, theo đặc điểm ThermostatMode . Bạn phải thay đổi chế độ của máy điều nhiệt thành SƯỞI ẤM, LÀM MÁT hoặc SƯỞI ẤM LÀM MÁT trước khi thay đổi chế độ Tiết kiệm năng lượng.

Xem thêm:
  Thay đổi chế độ
  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 Bạn 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:
  Thay đổi điểm đặt nhiệt độ
  ThermostatEco trait
  ThermostatTemperatureSetpoint trait
Không có 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 nội dung yêu cầu. Nhập một lệnh hợp lệ.
Lệnh không được hỗ trợ. 400 INVALID_ARGUMENT Đã dùng lệnh phát trực tiếp qua giao thức RTSP cho một camera hỗ trợ WebRTC hoặc đã dùng lệnh phát trực tiếp qua WebRTC cho một camera hỗ trợ RTSP.

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

Xem thêm:
  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. Chỉ định một thiết bị hợp lệ.

Xem thêm:
  Đặc điểm kết nối
Không tìm thấy doanh nghiệp. 404 NOT_FOUND Bạn đã chỉ định một Project ID không hợp lệ hoặc bị thiếu. Chỉ định một 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 eventID chính xác do sự kiện camera trả về.

Xem thêm:
  Xử lý sự kiện camera
  Hiển thị thiết bị
  Xử lý sự kiệ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 phản hồ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 bằng WebRTC.

Xem thêm:
Trường không có trong đặc điểm. 400 INVALID_ARGUMENT Đã gửi một lệnh không được hỗ trợ cho một đặc điểm.
SDP đề xuất không hợp lệ bị thiếu CRLF. 400 INVALID_ARGUMENT Ký tự dòng mới bị thiếu ở cuối chuỗi offerSdp khi cố gắng tạo một 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 luồng.

Xem thêm:
Dòng m SDP đề xuất không hợp lệ. 400 INVALID_ARGUMENT SDP của nội dung cung cấp phải chứa cả 3 dòng m của âm thanh, video và ứng dụng theo thứ tự đó.

Xem thêm:
SDP đề xuất không hợp lệ. 400 INVALID_ARGUMENT Bạn phải đặt âm thanh SDP của nội dung cung cấp 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 cho developercác quyền thích hợp ở cấp thiết bị trong Trình quản lý kết nối với đối tác (PCM) cần thiết để thực hiện một lệnh.

Khi tạo luồng 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:
  Liên kết tài khoản
  Lệnh GenerateWebRtcStream
Bị giới hạn số lượng yêu cầu. 429 RESOURCE_EXHAUSTED Mỗi nhà phát triển đều 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 lệnh 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 lệnh gọi sau khi hạn mức hết hạn.

Xem thêm:
  Khái niệm về giới hạn tốc độ hộp cát
Không tìm thấy phòng. 404 NOT_FOUND Phòng này không tồn tại trong cấu trúc. Thực hiện một lệnh gọi danh sách đến tài nguyên 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 hỗ trợ truyền trực tuyến. 400 FAILED_PRECONDITION Camera đang ở chế độ ngoại tuyến hoặc không phát trực tuyến được do sự cố kỹ thuật.

Xem thêm:
  Camera
  Camera (pin)
  Camera (có dây)
  Chuông cửa (pin)
  Chuông cửa (có dây)
  Lệnh GenerateWebRtcStream
Quạt của máy điều nhiệt không hoạt động. 400 FAILED_PRECONDITION Máy điều nhiệt không có khả năng quạt. Bạn không thể dùng các đặc điểm và lệnh liên quan đến quạt cho thiết bị này.

Xem thêm:
  Bật hoặc tắt quạt việc cần làm
  Quạt đặc điểm