API 오류 코드 참조

Smart Device Management API는 표준 gRPC 오류 코드를 사용합니다. 자세한 내용은 오류 처리를 참고하세요.

API의 오류 응답은 다음 형식으로 표시됩니다.

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

오류 코드 표의 검색창을 사용하여 API 오류를 찾을 수 있습니다. 문제 해결 팁과 관련 특성 및 가이드를 제공합니다. 콘텐츠를 검색할 수 있습니다. 를 사용할 수 있습니다.

오류 메시지 HTTP RPC 문제 해결
카메라 이미지를 더 이상 다운로드할 수 없습니다. 504 DEADLINE_EXCEEDED 이벤트 이미지는 이벤트가 게시된 후 30초 후에 만료됩니다. 만료되기 전에 이미지를 다운로드하세요.

다음 내용도 참고하세요.
카메라 이미지 다운로드 작업
디스플레이 기기
초인종 기기
이벤트 가이드
GenerateImage 명령어
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
초인종에서 지원되지 않는 명령어입니다. 400 FAILED_PRECONDITION 배터리 전원을 사용하는 초인종에서는 WebRTC 스트림을 확장할 수 없습니다. 초인종의 스트림을 초기 세션 길이 이상으로 시청해야 하는 경우 기존 스트림을 중지하고 새 스트림을 생성합니다.

참고:
라이브 스트림 작업 연장
ExtendWebRtcStream 명령어
현재 온도 조절기 모드에서 사용할 수 없는 명령어입니다. 400 FAILED_PRECONDITION 일부 온도 조절기 모델은 ThermostatMode 특성에 따라 온도 조절기 모드가 꺼져 있을 때 절전 모드 변경을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 난방, 냉방 또는 난방 모드로 변경해야 합니다.

참고:
모드 변경 작업
SetMode 명령어
ThermostatMode trait
ThermostatTemperatureSetpoint trait
온도 조절기가 MANUAL_ECO 모드일 때는 명령어가 허용되지 않습니다. 400 FAILED_PRECONDITION 온도 조절기가 수동 절전 모드일 때는 온도 설정값을 설정할 수 없습니다.

다음 내용도 참고하세요.
온도 설정값 변경 작업
ThermostatEco trait
ThermostatTemperatureSetpoint trait
명령어가 제공되지 않았습니다. 404 NOT_FOUND 요청 본문에 유효한 명령어 이름 없이 명령어가 실행되었습니다. 유효한 명령어를 입력하세요.
지원되지 않는 명령어입니다. 400 INVALID_ARGUMENT WebRTC를 지원하는 카메라에 RTSP 라이브 스트림 명령어를 사용했거나, RTSP를 지원하는 카메라에 WebRTC 라이브 스트림 명령어를 사용했습니다.

참고 항목:
카메라 이미지 다운로드 작업
잘못된 값이 포함되어 있습니다. 400 INVALID_ARGUMENT 인수에 잘못된 값이 포함된 명령어가 제출되었습니다. 유효한 값을 전송해야 합니다.
냉방 값은 난방 값보다 커야 합니다. 400 INVALID_ARGUMENT heatCelsius 필드가 명령어의 coolCelsius 필드보다 작은지 확인합니다.

참고 항목:
온도 설정값 변경 작업
ThermostatTemperatureSetpoint trait
기기를 찾을 수 없습니다. 404 NOT_FOUND 잘못되거나 누락된 기기 이름이 지정되었습니다. 유효한 기기를 지정합니다.

참고 항목:
Connectivity trait
기업을 찾을 수 없습니다. 404 NOT_FOUND 잘못되거나 누락된 Project ID가 지정되었습니다. 유효한 Project ID를 지정하세요.
카메라에 속하지 않은 활동 ID입니다. 400 FAILED_PRECONDITION 카메라 이벤트에서 반환된 올바른 eventID를 사용하세요.

참고 항목:
카메라 이벤트 처리 작업
디스플레이 기기
초인종 및 카메라 이벤트 처리 작업
이벤트 가이드
CameraEventImage trait
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
제한 시간으로 인해 응답 SDP를 가져올 수 없습니다. 504 DEADLINE_EXCEEDED WebRTC 라이브 스트림을 다시 생성해 봅니다.

다음 링크도 참조하세요.
트레잇에 필드가 없습니다. 400 INVALID_ARGUMENT 특성에 지원되지 않는 명령어가 전송되었습니다.
잘못된 혜택 SDP에 CRLF가 누락되었습니다. 400 INVALID_ARGUMENT WebRTC 스트림을 생성하려고 할 때 offerSdp 문자열 끝에 줄바꿈 문자가 없습니다. offerSdp 문자열이 \r\n 또는 \n로 끝나는지 확인하고 스트림을 다시 생성해 보세요.

참고 항목:
혜택 SDP M-라인이 잘못되었습니다. 400 INVALID_ARGUMENT 혜택 SDP에는 오디오, 동영상, 애플리케이션 M라인 3개가 모두 이 순서대로 포함되어야 합니다.

다음 내용도 참고하세요.
오퍼 SDP가 잘못되었습니다. 400 INVALID_ARGUMENT 혜택 SDP 오디오는 a=recvonly (수신 전용)로 설정해야 합니다.

참고 항목:
권한이 거부되었습니다. 403 PERMISSION_DENIED user 에서 developer권한을 부여하지 않았습니다. 파트너 연결 관리자 (PCM)에서 적절한 기기 수준 권한을 사용하여

WebRTC 라이브 스트림을 생성할 때 이 오류는 offerSdp의 오디오 설정이 잘못되었다는 의미입니다.

다음을 참고하세요.
계정 연결 작업
GenerateWebRtcStream 명령어
속도가 제한되었습니다. 429 RESOURCE_EXHAUSTED 각 개발자는 호출할 수 있는 횟수를 제한하는 할당량이 있습니다. 할당량보다 많은 호출을 하는 경우 Rate Limited 메시지가 표시됩니다. 이 문제를 해결하려면 할당량이 만료된 후 통화를 다시 제출하세요.

다음 내용도 참고하세요.
샌드박스 비율 제한 개념
회의실을 찾을 수 없습니다. 404 NOT_FOUND 집에 없는 방입니다. 회의실 리소스에 목록 호출을 수행하여 회의실 ID를 확인합니다.
구조를 찾을 수 없습니다. 404 NOT_FOUND Project에 구조는 존재하지 않습니다. 구조 리소스에 목록 호출을 수행하여 구조 ID를 확인합니다.
스트리밍할 수 없는 카메라입니다. 400 FAILED_PRECONDITION 카메라가 오프라인 상태이거나 기술적인 문제로 인해 스트리밍할 수 없습니다.

다음 내용도 참고하세요.
카메라 기기
카메라 (배터리) 기기
카메라 (유선) 기기
초인종 (배터리) 기기
초인종 (유선) 기기
GenerateWebRtcStream 명령어
온도 조절기 팬을 사용할 수 없습니다. 400 FAILED_PRECONDITION 온도 조절기에는 팬 기능이 없습니다. 이 기기에서는 팬 관련 기능 및 명령어를 사용할 수 없습니다.

다음 링크도 참고하세요.
선풍기 켜기 또는 끄기 작업
Fan trait