Google致力于提高黑人社区的种族平等。 怎么看。
此页面由 Cloud Translation API 翻译。
Switch to English

错误讯息

错误条件是开发周期的一部分,范围从简单的错误(例如无效或丢失的参数)到更复杂的场景(例如意外状态甚至与设备相关的设置),必须在API之外解决。

在API调用期间发生错误时,将发送以下格式的响应:

{
  "error": "Temperature '$temp' is in wrong format",
  "type": "https://developers.nest.com/documentation/cloud/error-messages#format-error",
  "message": "Temperature '$temp' is in wrong format",
  "instance": "31441a94-ed26-11e4-90ec-1681e6b88ec1",
  "details": {
    "field_name": "$temp"
  }
}

所有错误消息均包含errortypemessageinstance字段。 details对象是可选的。

领域描述
error 简短的错误消息格式。
type 提供URL,以获取有关错误情况的详细信息(此页面)。
message 长错误消息格式,可以使用变量来提供其他详细信息。当消息中包含变量时,它将出现在details对象中。
instance 包含错误标识符的文本字符串,该错误标识符对于每个单独的调用都是唯一的。如果您报告服务问题,我们可能会要求您提供实例号。
details 可选的。包含插入到message变量。消息可以包含多个变量。

有关与Nest API不相关的错误的信息,请参阅其他错误代码和消息

受阻

已超过速率限制

参量
HTTP状态码: 429个请求过多
error 受阻
type https://developers.nest.com/reference/error-messages#blocked
message 受阻

烟气/公司安全关闭期间无法启动风扇

紧急关机已生效。在恢复正常操作之前,不接受API调用。

参量
HTTP状态码: 400错误的请求
error 烟气/公司安全关闭期间无法启动风扇
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message 烟气/公司安全关闭期间无法启动风扇

紧急加热开启时无法更改离开状态

产品在紧急加热开启时试图更改离开状态。

参量
HTTP状态码: 400错误的请求
error 紧急加热开启时无法更改离开状态
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message 紧急加热开启时无法更改离开状态

节能事件期间无法更改HVAC模式

Nest能源合作伙伴定义的节能活动正在生效。 API调用将被拒绝,直到节能事件结束为止。

参量
HTTP状态码: 400错误的请求
error 节能事件期间无法更改HVAC模式
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message 节能事件期间无法更改HVAC模式

无法更改HVAC模式

该模式与请求不兼容。

例如,在以下情况下,您可能会收到此消息:

  • 温控器的HVAC系统不支持您的产品所要求的模式: heatcoolheat-cooleco
  • HVAC模式设置为eco ,产品尝试设置target_temperature
参量
HTTP状态码: 400错误的请求
error 无法将HVAC模式更改为$mode ;暖通空调不能$action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message 无法将HVAC模式更改为$mode ;暖通空调不能$action
details $mode
$action

启用恒温器锁定后无法更改HVAC模式

用户必须先解锁恒温器,然后产品才能写入数据。

参量
HTTP状态码: 400错误的请求
error 启用恒温器锁定后无法更改HVAC模式
type https://developers.nest.com/reference/error-messages#lock-enabled
message 启用恒温器锁定后无法更改HVAC模式

无法同时设置C和F温度

产品试图同时设定摄氏和华氏目标温度。产品应仅设置由temperature_scale (C / F)指定的目标温度。

参量
HTTP状态码: 400错误的请求
error 无法同时设置C和F温度
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message 无法同时设置C和F温度

由于模式不兼容,无法设置fan_timer_active为开/关

HVAC系统风扇已投入使用(由用户手动进行,或按计划进行,或者由于HVAC的热/冷循环而引起)。

如果您没有获得预期的结果,则最有可能是因为设备具有内置行为,我们无法通过API对其进行覆盖。

参量
HTTP状态码: 400错误的请求
error 由于不兼容的模式$mode无法设置fan_timer_active的开/关
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message 由于不兼容的模式$mode无法设置fan_timer_active的开/关
details $mode

无法将fan_timer_duration设置为所选值

产品尝试将fan_timer_duration设置为无效值。有关fan_timer_duration的列表,请参见fan_timer_duration

参量
HTTP状态码: 400错误的请求
error 无法将fan_timer_duration设置为所选值。有关允许的值,请参见API参考。
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message 无法将fan_timer_duration设置为所选值。有关允许的值,请参见API参考。

无法将目标低温设置为高于目标高温

恒温器处于heat-cool模式,产品试图将目标温度设置为低/高,超出了范围。例如,当target_temperature_high_c为24°C时,产品尝试将target_temperature_low_c设置为25°C。

参量
HTTP状态码: 400错误的请求
error 无法将目标低温$lowTemp设置$lowTemp高于目标高温$highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message 无法将目标低温$lowTemp设置$lowTemp高于目标高温$highTemp
details $lowTemp
$highTemp

不能将目标温度设置为小于N摄氏度

产品试图将目标温度值设置得太接近目标高温/低温(例如target_temperature_high_f )。

参量
HTTP状态码: 400错误的请求
error 不能将目标温度设置为小于N摄氏度
type https://developers.nest.com/reference/error-messages#range-error
message 无法将目标温度设置为接近$min$scale
details $min
$scale

模式为$ mode时,无法设置target_temperature

恒温器或结构当前处于不支持API请求的模式。

例如,当HVAC系统off或处于heat-cool模式时,您无法设置target_temperature_ftarget_temperature_c 。在恒温器/结构切换回非限制模式之前,无法更改该值。

在此消息中, $fieldName可以是任何目标温度值, $mode可以是以下任意值: ecoemer_heat_enableheat-coolheatcooloffhvac_safety_shutoff_active

参量
HTTP状态码: 400错误的请求
error 模式为$mode无法设置target_temperature
type https://developers.nest.com/reference/error-messages#mode-error
message 模式为$mode时,无法设置$fieldName
details $fieldName
$mode

必须先更新设备固件,然后才能更改HVAC模式

必须将设备更新到当前固件版本才能设置环保温度。

参量
HTTP状态码: 400错误的请求
error 必须先更新设备固件,然后才能更改HVAC模式。更新是自动的,通常在发布后一周内。
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message 必须先更新设备固件,然后才能更改HVAC模式。更新是自动的,通常在发布后一周内。

验证WWN字段时出错

参量
HTTP状态码: 400错误的请求
error 验证WWN字段时$error$error
type https://developers.nest.com/reference/error-messages#where-id-internal
message 验证WWN字段时$error$error
details $error

过去的ETA

指定的预计到达时间是过去的时间(现在之前)。有关拨打ETA呼叫的更多信息,请参阅《 离开和ETA指南》

参量
HTTP状态码: 400错误的请求
error 过去是ETA: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message 过去是ETA: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

预计到达时间太遥远

指定的预计到达时间不能超过8小时。有关拨打ETA呼叫的更多信息,请参阅《 离开和ETA指南》

参量
HTTP状态码: 400错误的请求
error ETA太遥远了
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA太遥远了

未设置fan_timer_active

fan_timer_active

参量
HTTP状态码: 400错误的请求
error 未设置fan_timer_active
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message 未设置fan_timer_active

禁止的

用于访问Nest服务的凭据无效。

参量
HTTP状态码: 403禁止
error 禁止的
type https://developers.nest.com/reference/error-messages#forbidden
message 禁止的

内部错误

参量
HTTP状态码: 500内部服务器错误
error 内部错误
type https://developers.nest.com/reference/error-messages#internal-error
message 内部错误

无效的相机ID

camera-id无效。

参量
HTTP状态码: 400错误的请求
error 无效的相机ID $id
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message 无效的相机ID: $id
details $id

发送的内容无效

该呼叫包含无效内容。例如,对布尔变量使用“ yes”而不是“ true”。

参量
HTTP状态码: 400错误的请求
error 发送的内容无效
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message 发送的内容无效

无效的片段路径

请求路径的一部分无效。例如,对象或字段名称可能拼写错误。

参量
HTTP状态码: 400错误的请求
error 无效的片段路径: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message 无效的片段路径: $requestPath
details $requestPath

无效的HVAC模式

温控器的HVAC系统不支持产品要求的模式: heatcoolheat-cool

参量
HTTP状态码: 400错误的请求
error 无效的HVAC模式: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message 无效的HVAC模式: $mode
details $mode

无效的Smoke + Co警报ID

smoke_co_alarm_id无效。

参量
HTTP状态码: 400错误的请求
error 无效的Smoke + Co警报ID $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message 无效的Smoke + Co警报ID: $id
details $id

无效的结构ID

structure_id无效。

参量
HTTP状态码: 400错误的请求
error 无效的结构ID $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message 无效的结构ID: $id
details $id

无效的恒温器ID

thermostat_id无效。

参量
HTTP状态码: 400错误的请求
error 无效的恒温器ID $id
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message 无效的恒温器ID: $id
details $id

无效的价值

您试图为away设置一个无效值。

参量
HTTP状态码: 400错误的请求
error 无效的价值
type https://developers.nest.com/reference/error-messages#invalid-away-value
message 无效的值: $value 。仅允许“ home”和“ away”值。
details $value

is_streaming不是布尔值

产品尝试将is-streaming字段设置为非布尔值。

参量
HTTP状态码: 400错误的请求
error is_streaming不是布尔值
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming不是布尔值

标签必须少于256个字符

产品尝试创建具有超过256个字符的恒温器标签

参量
HTTP状态码: 400错误的请求
error 标签必须少于$max_label_length字符
type https://developers.nest.com/reference/error-messages#max-label-length
message 标签必须少于$max_label_length字符
details $max_label_length

超过计数的最大自定义

产品试图创建一个自定义的wheres对象,超出了最大值。允许的自定义wheres对象的最大数量为32。

参量
HTTP状态码: 400错误的请求
error 超过$max_where_count计数的最大自定义
type https://developers.nest.com/reference/error-messages#max-where-count
message 超过$max_where_count计数的最大自定义
details $max_where_count

超过名称长度的最大自定义

where name太长。我们建议少于30个字符。

参量
HTTP状态码: 400错误的请求
error 名称长度超过$max_custom_where_name_length最大自定义
type https://developers.nest.com/reference/error-messages#max-where-name-length
message 名称长度超过$max_custom_where_name_length最大自定义
details $max_custom_where_name_length

遗失领域

呼叫缺少必填参数。

参量
HTTP状态码: 400错误的请求
error 缺少字段: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message 缺少字段: $fieldName
details $fieldName

缺少位置ID

where_id格式丢失。

参量
HTTP状态码: 400错误的请求
error 缺少ID
type https://developers.nest.com/reference/error-messages#where-id-missing
message 缺少ID

没有HVAC风扇

HVAC系统似乎没有独立风扇。

参量
HTTP状态码: 400错误的请求
error 没有暖通风扇
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message 没有暖通风扇

没有在线恒温器

温控器当前离线。启用Wi-Fi后,您的产品应重新获得访问权限。

参量
HTTP状态码: 400错误的请求
error 没有在线恒温器
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message 没有在线恒温器

没有配对的设备

用户的Nest设备未与用户的Nest帐户配对

参量
HTTP状态码: 400错误的请求
error 没有配对的设备
type https://developers.nest.com/reference/error-messages#no-paired-devices
message 没有配对的设备

没有有效的预计到达时间即可取消

行程无效,无法取消。

参量
HTTP状态码: 400错误的请求
error 没有有效的预计到达时间即可取消
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message 没有有效的预计到达时间即可取消

没有字段的写许可

客户端没有对此数据的写许可权。有关更多信息,请参见“ 权限概述”

参量
HTTP状态码: 400错误的请求
error 没有字段的写入权限: $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message 没有字段的写入权限: $fields
details $fields

无效的请求类型

请求类型无效。例如,需要PUT时进行了POST调用。

参量
HTTP状态码: 400错误的请求
error 无效的请求类型: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message 无效的请求类型: $requestType
details $requestType

未找到

呼叫尝试读取不存在的路径。

参量
HTTP状态码: 404未找到
error 未找到
type https://developers.nest.com/reference/error-messages#not-found
message 未找到

不在离开模式

进行ETA呼叫时,该结构未处于“离开”模式。仅当结构设置为“离开”时才接受ETA呼叫。

参量
HTTP状态码: 400错误的请求
error 不在离开模式
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message 不在离开模式

不可写

您尝试写入的字段是只读的。

参量
HTTP状态码: 400错误的请求
error 不可写
type https://developers.nest.com/reference/error-messages#not-writable
message 不可写

仅在需要提供姓名的地方

额外的字段包含在wheres呼叫中。

参量
HTTP状态码: 400错误的请求
error 仅在需要提供姓名的地方
type https://developers.nest.com/reference/error-messages#extra-fields
message 仅在需要提供姓名的地方

POST不是有效的请求类型

请求类型无效。例如,需要PUT时进行了POST调用。

参量
HTTP状态码: 400错误的请求
error POST不是有效的请求类型
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST不是有效的请求类型

架构冲突

配对设备时发生错误。

参量
HTTP状态码: 400错误的请求
error 架构冲突
type https://developers.nest.com/reference/error-messages#schema-violation-error
message 架构冲突

暂停服务

参量
HTTP状态码: 503服务不可用
error 暂停服务
type https://developers.nest.com/reference/error-messages#service-unavailable
message 暂停服务

结构已允许最大数量的配对设备

该结构已具有允许最大设备数量

参量
HTTP状态码: 400错误的请求
error 结构已允许最大数量的配对设备
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message 结构已允许最大数量的配对设备

结构不归用户所有

structure_id与记录的用户帐户不匹配。

参量
HTTP状态码: 400错误的请求
error 结构不归用户所有。
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message 结构不归用户所有。

温度C太高,无法达到锁定温度

用户已锁定了恒温器,并且产品试图将摄氏温度设置为高于锁定温度范围。

参量
HTTP状态码: 400错误的请求
error 温度C $tempC太高,无法达到锁定温度$highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message 温度C $tempC太高,无法达到锁定温度$highLockTemp
details $tempC
$highLockTemp

温度C太低,无法达到锁定温度

用户已锁定了恒温器,并且产品试图将摄氏温度设置为低于锁定温度范围。

参量
HTTP状态码: 400错误的请求
error 温度C $tempC太低,无法达到锁定温度$lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message 温度C $tempC太低,无法达到锁定温度$lowLockTemp
details $tempC
$lowLockTemp

温度C值太高

产品试图将目标温度值设置为对于摄氏温度过高。有关摄氏温度的允许范围,请参阅target_temperature_c

参量
HTTP状态码: 400错误的请求
error 温度C值太高: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message 温度C值太高: $tempC
details $tempC

温度C值太低

产品试图将目标温度值设置为低于摄氏温度。有关摄氏温度的允许范围,请参阅target_temperature_c

参量
HTTP状态码: 400错误的请求
error 温度C值太低: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message 温度C值太低: $tempC
details $tempC

温度F对于锁定温度而言过高

用户已锁定了恒温器,并且产品试图将华氏温度设置为高于锁定温度范围。

参量
HTTP状态码: 400错误的请求
error 温度F $tempF对于锁定温度$highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message 温度F $tempF对于锁定温度$highLockTemp
details $tempF
$highLockTemp

温度F太低,无法达到锁定温度

用户已锁定了恒温器,并且产品试图将华氏温度设定为低于锁定温度范围。

参量
HTTP状态码: 400错误的请求
error 温度F $tempF对于锁定温度$lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message 温度F $tempF对于锁定温度$lowLockTemp
details $tempF
$lowLockTemp

温度F值太高

产品试图将目标温度值设置为华氏温度过高。有关华氏温度的允许范围,请参阅target_temperature_f

参量
HTTP状态码: 400错误的请求
error 温度F值太高: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message 温度F值太高: $tempF
details $tempF

温度F值太低

产品试图将目标温度值设置为低于华氏温度。有关华氏温度的允许范围,请参阅target_temperature_f

参量
HTTP状态码: 400错误的请求
error 温度F值太低: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message 温度F值太低: $tempF
details $tempF

温度格式错误

产品尝试使用错误的数字格式为选定的temperature_scale设置目标temperature_scale 。摄氏温度应为以0.5度为增量的整数(21.5),华氏温度应为整数(72)。

参量
HTTP状态码: 400错误的请求
error 温度$temp格式错误
type https://developers.nest.com/reference/error-messages#format-error
message 温度$temp格式错误
details $temp

无法在更新时修改字段

产品试图写入一个只读字段。

参量
HTTP状态码: 400错误的请求
error 无法在更新时修改字段: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message 无法在更新时修改字段: $fieldNames
details $fieldNames

字段应使用ISO 8601格式

该字段不是ISO 8601格式。

参量
HTTP状态码: 400错误的请求
error 字段应使用ISO 8601格式: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message 字段应使用ISO 8601格式: $fieldNames
details $fieldNames

温控器不在线

温控器当前离线。启用Wi-Fi后,您的产品应重新获得访问权限。

参量
HTTP状态码: 400错误的请求
error 温控器不在线
type https://developers.nest.com/reference/error-messages#not-online
message 温控器不在线

此行程已被手动覆盖

用户已手动覆盖行程。

参量
HTTP状态码: 400错误的请求
error 此行程已被手动覆盖
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message 此行程已被手动覆盖

无法创建位置ID

wheres对象丢失。没有定义where_id值。

参量
HTTP状态码: 400错误的请求
error 无法创建where id
type https://developers.nest.com/reference/error-messages#wheres-missing
message 无法创建where id

未经授权

授权失败。

有几种情况可能会产生此错误消息:

  • 当给定的HTTP实现没有自动将Authorization标头转发到重定向的URI时发生的错误重定向。有关更多信息,请参见如何处理重定向

  • 尝试访问API端点时权限不正确。例如,当仅为客户端选择“摄像机”权限时,尝试读取恒温器端点。有关更多信息,请参见如何选择权限

参量
HTTP状态码: 401未经授权
error 未经授权
type https://developers.nest.com/reference/error-messages#auth-error
message 未经授权

未知

参量
HTTP状态码: 400错误的请求
error 未知
type https://developers.nest.com/reference/error-messages#unknown
message 未知

未知的供应商/设备类型

设备配对期间无法识别供应商/设备。

参量
HTTP状态码: 400错误的请求
error 未知的供应商/设备类型
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message 未知的供应商/设备类型

$ fieldName的值类型错误

发送了错误的数据类型。例如,在需要布尔值时发送字符串。

参量
HTTP状态码: 400错误的请求
error $fieldName值类型错误
type https://developers.nest.com/reference/error-messages#wrong-data-type
message $fieldName值类型错误
details $fieldName

名称已经存在的地方

产品尝试设置的where_name已经存在。重新命名。

参量
HTTP状态码: 400错误的请求
error 名称$name已存在的地方
type https://developers.nest.com/reference/error-messages#where-name-exists
message 名称$name已存在的地方
details $name

没有提供姓名的地方

where_name中缺少where_name

参量
HTTP状态码: 400错误的请求
error 没有提供姓名的地方
type https://developers.nest.com/reference/error-messages#where-name-missing
message 没有提供姓名的地方

名称长度为零

未定义where name (具有零个字符)。

参量
HTTP状态码: 400错误的请求
error 名称长度为零
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message 名称长度为零

名称必须是字符串

where_name发送了错误的数据类型。例如,一个期望字符串的数字。

参量
HTTP状态码: 400错误的请求
error 名称必须是字符串
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message 名称必须是字符串

where_id不存在

where_id无效。

参量
HTTP状态码: 400错误的请求
error where_id不存在
type https://developers.nest.com/reference/error-messages#where-id-invalid
message where_id不存在
details $where_id

where_id必须为字符串

where_id格式无效。例如,发送了一个数字而不是一个字符串。

参量
HTTP状态码: 400错误的请求
error where_id必须为字符串
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message where_id必须为字符串

其他错误代码和消息

设备错误代码

有关与Nest API不相关的特定于设备的错误代码和消息,请参见以下内容:

REST错误代码

进行REST API调用时,将返回常见的HTTP状态代码。

REST速率限制消息

使用REST并在短时间内发送太多呼叫时,您可能会收到HTTP响应状态代码429 Too Many Requests。

有关更多信息,请参见数据速率限制