Smart Device Management API 使用標準 gRPC 錯誤代碼。如要進一步瞭解這些代碼，請參閱「錯誤處理」。
API 中的錯誤回應格式如下：
{
"error": {
"code": 404,
"message": "Device enterprises/project-id/devices/device-id not found.",
"status": "NOT_FOUND"
}
}
使用「錯誤代碼」表格中的搜尋方塊，尋找 API 錯誤，以及疑難排解提示和相關特徵與指南。您可以在表格的任何欄位中搜尋內容。
| 錯誤訊息 | HTTP | 單次點擊收益 | 疑難排解 |
|---|---|---|---|
| 攝影機影像已無法下載。 | 504 | DEADLINE_EXCEEDED |
活動圖片會在活動發布後 30 秒失效。請務必在期限前下載圖片。 另請參閱： 下載攝影機影像工作 顯示裝置 門鈴裝置 事件指南 GenerateImage 指令 CameraMotion 特徵 CameraPerson 特徵 CameraSound 特徵 DoorbellChime 特徵 |
| 門鈴不支援這項指令。 | 400 | FAILED_PRECONDITION |
使用電池供電的門鈴無法延長 WebRTC 串流。如要觀看門鈴的串流影像超過初始工作階段長度，請停止現有串流並產生新的串流。 另請參閱： 「延長直播」工作 「ExtendWebRtcStream」ExtendWebRtcStream指令 |
| 目前溫度控制器模式不允許使用這項指令。 | 400 | FAILED_PRECONDITION |
根據 ThermostatMode 特徵，部分溫度控制器型號在溫度控制器模式為「關閉」時，不支援變更節能模式。變更節能模式前，必須先將溫度控制器模式變更為「暖氣」、「冷氣」或「冷暖」。 另請參閱： 「變更模式」工作 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 |
指定的 ID 無效或遺漏。 Project 指定有效的 ID。 Project |
| 事件 ID 不屬於攝影機。 | 400 | FAILED_PRECONDITION |
使用攝影機事件傳回的正確 eventID。另請參閱： 處理攝影機事件工作 顯示裝置 處理門鈴和攝影機事件工作 事件指南 CameraEventImage 特徵 CameraMotion 特徵 CameraPerson 特徵 CameraSound 特徵 DoorbellChime 特徵 |
| 逾時，因此無法擷取答案 SDP。 | 504 | DEADLINE_EXCEEDED |
請嘗試再次產生 WebRTC 直播串流。 另請參閱： |
| 特徵中沒有這個欄位。 | 400 | INVALID_ARGUMENT |
系統傳送了特徵不支援的指令。 |
| 無效的 Offer SDP 缺少 CRLF。 | 400 | INVALID_ARGUMENT |
嘗試產生 WebRTC 串流時，offerSdp 字串結尾缺少換行字元。請確認 offerSdp 字串結尾為 \r\n 或 \n，然後再試一次產生串流。另請參閱： |
| 提議 SDP m 行無效。 | 400 | INVALID_ARGUMENT |
SDP 提案必須依序包含音訊、影片和應用程式這三種 m-line。 另請參閱： |
| 無效的 Offer SDP。 | 400 | INVALID_ARGUMENT |
Offer 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 |
溫度控制器沒有風扇功能。這部裝置無法使用風扇相關特徵和指令。 另請參閱： 「開啟或關閉風扇」工作 風扇 特徵 |