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ố, đặc điểm và hướng dẫn liên quan. Bạn có thể tìm kiếm nội dung trong mọi trường của 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
  Hiển thị thiết bị
  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ể kéo dài 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 tại 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
  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 chế độ máy điều nhiệt là 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 RTSP cho camera hỗ trợ WebRTC hoặc dùng lệnh phát trực tiếp WebRTC cho camera hỗ trợ RTSP.

Xem thêm:
  Tải hình ảnh 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ố. Đảm bảo rằng 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ị 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:
  Khả năng kết nối đặc điểm
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 dịch vụ 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 đề nghị không hợp lệ. 400 INVALID_ARGUMENT Bạn phải đặt âm thanh SDP của đề nghị 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 thi 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 độ của 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. 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:
  Thiết bị camera
  Thiết bị camera (pin)
  Thiết bị camera (có dây)
  Thiết bị chuông cửa (pin)
  Thiết bị 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ó chức 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
  Quạt đặc điểm