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 特徵   CameraPerson 特徵   CameraSound 特徵   DoorbellChime 特徵
指令不支援門鈴。	400	FAILED_PRECONDITION	在電池供電的門鈴上，無法延長 WebRTC 串流。如果需要查看門鈴的串流，且時間超過初始工作階段長度，請停止現有的串流並產生新的串流。 另請參閱：   延長直播任務   ExtendWebRtcStream 指令
在目前的溫度控制器模式下，不允許執行指令。	400	FAILED_PRECONDITION	根據 ThermostatMode 特徵，部分溫度控制器型號在溫度控制器模式為「關閉」時，不支援變更節能模式。溫度控制器模式必須先變更為「HEAT」、「COOL」或「HEATCOOL」，才能變更「Eco」模式。 另請參閱：   變更模式工作項   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 特徵
找不到裝置。	404	NOT_FOUND	指定的裝置名稱無效或遺漏。指定有效的裝置。 另請參閱：   Connectivity trait
找不到企業。	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	系統傳送了特徵不支援的指令。
無效的 Offer SDP 缺少 CRLF。	400	INVALID_ARGUMENT	嘗試產生 WebRTC 串流時，offerSdp 字串結尾缺少換行字元。請確認 offerSdp 字串結尾為 \r\n 或 \n，然後嘗試再次產生串流。 另請參閱：
無效的 Offer SDP m-line。	400	INVALID_ARGUMENT	商品 SDP 必須包含音訊、影片和應用程式 m-line，且必須按照上述順序排列。 另請參閱：
無效的 Offer SDP。	400	INVALID_ARGUMENT	提供者 SDP 音訊必須設為 a=recvonly (僅接收)。 另請參閱：
權限遭拒。	403	PERMISSION_DENIED	user 未授予 developerPartner Connections Manager (PCM) 中執行指令所需的適當裝置層級權限。 產生 WebRTC 即時串流時，這項錯誤也可能表示 offerSdp 中的音訊設定不正確。 另請參閱：   連結帳戶工作   GenerateWebRtcStream 指令
已達到每週數量上限。	429	RESOURCE_EXHAUSTED	每位開發人員都有配額，限制他們可發出的呼叫次數。如果您撥打的電話超過配額，系統會顯示「Rate limited」訊息。如要修正這個問題，請在配額到期後重新提交呼叫。 另請參閱：   沙箱頻率限制概念
找不到會議室。	404	NOT_FOUND	結構體中沒有這個房間。請對 rooms 資源發出清單呼叫，以驗證 Room ID。
找不到結構。	404	NOT_FOUND	結構不存在於 Project中。對結構體資源發出清單呼叫，以驗證結構體 ID。

12