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 單次點擊收益 疑難排解
相機圖片已不再開放下載。 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 指定的裝置名稱無效或遺漏。請指定有效的裝置。

另請參閱:
連線能力 特徵
找不到企業。 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-line 無效。 400 INVALID_ARGUMENT 優惠 SDP 必須依照該順序包含以下全部三種音訊、視訊和應用程式。

另請參閱:
優惠 SDP 無效。 400 INVALID_ARGUMENT 優惠 SDP 音訊必須設為 a=recvonly (僅限接收)。

另請參閱:
權限遭拒。 403 PERMISSION_DENIED user 尚未授予 developer 要在合作夥伴連線管理工具 (PCM) 中執行適當裝置層級權限,以便執行 指令。

在產生 WebRTC 直播時,這個錯誤也可能是 表示 offerSdp 的音訊設定不正確。

另請參閱:
連結帳戶工作
GenerateWebRtcStream 指令
頻率受限。 429 RESOURCE_EXHAUSTED 每個開發人員都有配額限制,可發出呼叫次數限制。如果通話次數超過配額,就會收到「頻率受限」的訊息。如要解決這個問題,請在配額到期後重新提交呼叫。

另請參閱:
沙箱頻率限制概念
找不到會議室。 404 NOT_FOUND 結構中沒有會議室。向會議室資源發出清單呼叫,驗證會議室 ID。
找不到結構物。 404 NOT_FOUND Project中沒有該結構。向結構資源發出清單呼叫,驗證結構 ID。
這部相機不支援串流功能。 400 FAILED_PRECONDITION 發生技術問題,因此攝影機已離線或無法串流播放。

另請參閱:
相機裝置
相機 (電池) 裝置
相機 (有線)
門鈴 (電池) 裝置
門鈴 (有線) 裝置
GenerateWebRtcStream 指令
無法使用溫度控制器風扇。 400 FAILED_PRECONDITION 這個溫度控制器沒有風扇功能這部裝置不支援粉絲相關特徵和指令。

另請參閱:
開啟或關閉風扇工作
Fan trait