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 특성에 따라 온도 조절기 모드가 OFF일 때 절전 모드 변경을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 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 특성 |
| 기기를 찾을 수 없습니다. | 404 | NOT_FOUND |
잘못되었거나 누락된 기기 이름이 지정되었습니다. 유효한 기기를 지정합니다. 참고: 연결 특성 |
| 엔터프라이즈를 찾을 수 없습니다. | 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-라인입니다. | 400 | INVALID_ARGUMENT |
SDP에는 오디오, 동영상, 애플리케이션 m-라인이 이 순서대로 모두 포함되어야 합니다. 참고: |
| 잘못된 제안 SDP입니다. | 400 | INVALID_ARGUMENT |
제공 SDP 오디오는 a=recvonly (수신만 해당)로 설정해야 합니다.다음도 참고하세요. |
| 권한이 거부되었습니다. | 403 | PERMISSION_DENIED |
user 이 명령어를 실행하는 데 필요한 적절한 기기 수준 권한을 파트너 연결 관리자 (PCM)에서 developer에 부여하지 않았습니다. WebRTC 라이브 스트림을 생성할 때 이 오류는 offerSdp의 오디오 설정이 잘못되었음을 의미할 수도 있습니다.참고: 계정 연결 작업 GenerateWebRtcStream 명령어 |
| 한도에 도달했습니다. | 429 | RESOURCE_EXHAUSTED |
각 개발자에게는 호출할 수 있는 횟수를 제한하는 할당량이 있습니다. 할당량보다 많은 호출을 하면 비율 제한 메시지가 표시됩니다. 이 문제를 해결하려면 할당량이 만료된 후 호출을 다시 제출하세요. 참고: 샌드박스 비율 한도 개념 |
| 회의실을 찾을 수 없습니다. | 404 | NOT_FOUND |
구조에 방이 없습니다. 회의실 리소스에 목록 호출을 실행하여 회의실 ID를 확인합니다. |
| 구조를 찾을 수 없습니다. | 404 | NOT_FOUND |
구조가 Project에 없습니다. 구조 리소스에 목록 호출을 실행하여 구조 ID를 확인합니다. |
| 카메라를 스트리밍할 수 없습니다. | 400 | FAILED_PRECONDITION |
카메라가 오프라인 상태이거나 기술적 문제로 인해 스트리밍할 수 없습니다. 참고: 카메라 기기 카메라 (배터리) 기기 카메라 (유선) 기기 초인종 (배터리) 기기 초인종 (유선) 기기 GenerateWebRtcStream 명령어 |
| 온도 조절기 팬을 사용할 수 없습니다. | 400 | FAILED_PRECONDITION |
온도 조절기에 팬 기능이 없습니다. 이 기기에는 팬 관련 특성과 명령어를 사용할 수 없습니다. 참고: 팬 켜기 또는 끄기 작업 팬 특성 |