智慧型裝置管理 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 指令 |
| 目前溫度控制器模式不允許使用這項指令。 | 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 。請指定有效的 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 |
溫度控制器沒有風扇功能，因此無法使用風扇相關特徵和指令。 另請參閱： 開啟或關閉風扇工作 風扇 特徵 |