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 트레잇 CameraPerson 트레잇 CameraSound 트레잇 DoorbellChime 트레잇 |
| 초인종에서 지원되지 않는 명령어입니다. | 400 | FAILED_PRECONDITION |
배터리 전원을 사용하는 초인종에서는 WebRTC 스트림을 연장할 수 없습니다. 초기 세션 길이보다 더 길게 초인종의 스트림을 시청해야 하는 경우 기존 스트림을 중지하고 새 스트림을 생성합니다. 참고: 라이브 스트림 연장 작업 ExtendWebRtcStream 명령어 |
| 현재 온도 조절기 모드에서는 명령어를 사용할 수 없습니다. | 400 | FAILED_PRECONDITION |
일부 온도 조절기 모델은 ThermostatMode 특성에 따라 온도 조절기 모드가 꺼져 있을 때 절전 모드 변경을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 HEAT, COOL 또는 HEATCOOL로 변경해야 합니다. 참고: 모드 변경 작업 SetMode 명령어 ThermostatMode 트레잇 ThermostatTemperatureSetpoint 트레잇 |
| 온도 조절기가 MANUAL_ECO 모드일 때는 명령어가 허용되지 않습니다. | 400 | FAILED_PRECONDITION |
온도 조절기가 수동 절전 모드일 때는 온도 설정값을 설정할 수 없습니다. 참고: 온도 설정값 변경 작업 ThermostatEco 트레잇 ThermostatTemperatureSetpoint 트레잇 |
| 명령어가 제공되지 않았습니다. | 404 | NOT_FOUND |
요청 본문에 유효한 명령어 이름이 없으면 명령어가 실행되었습니다. 유효한 명령어를 입력합니다. |
| 지원되지 않는 명령어입니다. | 400 | INVALID_ARGUMENT |
WebRTC를 지원하는 카메라에 RTSP 라이브 스트림 명령어를 사용했거나 RTSP를 지원하는 카메라에 WebRTC 라이브 스트림 명령어를 사용했습니다. 참고: 카메라 이미지 다운로드 작업 |
| 잘못된 값이 포함되어 있습니다. | 400 | INVALID_ARGUMENT |
인수에 잘못된 값이 포함된 명령어가 제출되었습니다. 유효한 값을 전송해야 합니다. |
| 냉방 값은 난방 값보다 커야 합니다. | 400 | INVALID_ARGUMENT |
heatCelsius 필드가 명령어의 coolCelsius 필드보다 작은지 확인합니다.참고 항목: 온도 설정값 변경 작업 ThermostatTemperatureSetpoint trait |
| 기기를 찾을 수 없습니다. | 404 | NOT_FOUND |
잘못된 기기 이름이 지정되었거나 기기 이름이 누락되었습니다. 유효한 기기를 지정합니다. 참고: 연결 특성 |
| Enterprise를 찾을 수 없습니다. | 404 | NOT_FOUND |
잘못되었거나 누락된 Project ID가 지정되었습니다. 유효한 Project ID를 지정하세요. |
| 이벤트 ID가 카메라에 속하지 않습니다. | 400 | FAILED_PRECONDITION |
카메라 활동에서 반환된 올바른 eventID를 사용합니다.참고: 카메라 활동 처리 작업 디스플레이 기기 초인종 및 카메라 활동 처리 작업 활동 가이드 CameraEventImage 트레잇 CameraMotion 트레잇 CameraPerson 트레잇 CameraSound 트레잇 DoorbellChime 트레잇 |
| 시간 초과로 인해 답변 SDP를 가져올 수 없습니다. | 504 | DEADLINE_EXCEEDED |
WebRTC 라이브 스트림을 다시 생성해 봅니다. 참고: |
| 트레잇에 필드가 없습니다. | 400 | INVALID_ARGUMENT |
트레잇에 지원되지 않는 명령이 전송되었습니다. |
| 잘못된 오퍼 SDP에 CRLF가 누락되었습니다. | 400 | INVALID_ARGUMENT |
WebRTC 스트림을 생성하려고 할 때 offerSdp 문자열 끝에 줄바꿈 문자가 누락됩니다. offerSdp 문자열이 \r\n 또는 \n로 끝나는지 확인하고 스트림을 다시 생성해 봅니다.참고: |
| 잘못된 오퍼 SDP m-line | 400 | INVALID_ARGUMENT |
오디오, 동영상, 애플리케이션 m-line이 모두 순서대로 포함되어야 합니다. 참고: |
| 오퍼 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 |
기술적 문제로 인해 카메라가 오프라인 상태이거나 스트리밍할 수 없습니다. 참고 항목: 카메라 기기 카메라 (배터리) 기기 카메라 (유선) 기기 초인종 (배터리) 기기 초인종 (유선) 기기 WebRtc 명령어 생성 GenerateWebRtcStream |
| 온도 조절기 팬을 사용할 수 없습니다. | 400 | FAILED_PRECONDITION |
온도 조절기에 팬 기능이 없습니다. 이 기기에는 팬 관련 트레잇과 명령어를 사용할 수 없습니다. 참고: 팬 켜기 또는 끄기 작업 팬 트레잇 |