エラーメッセージ

エラー条件は開発サイクルの一部であり、無効なパラメータや欠落しているパラメータなどの単純な障害から、解決する必要がある予期せぬ状態やデバイス関連の設定などの複雑なシナリオにまで及ぶ場合があります。 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"
  }
}

すべてのエラー メッセージには、error、type、message、instance の各フィールドが含まれています。details オブジェクトは省略可能です。

項目	説明
error	短いエラー メッセージの形式。
type	エラー状態に関する詳細情報の URL を提供します（このページ）。
message	詳細な情報を指定する変数を使用できる長いエラー メッセージ形式。メッセージに変数が含まれる場合、details オブジェクトに表示されます。
instance	個々の呼び出しに固有のエラー識別子を保持するテキスト文字列。このサービスの問題を報告すると、インスタンス番号の入力を求められることがあります。
details	省略可。message に挿入される変数が含まれます。メッセージには複数の変数を含めることができます。

Nest API に関連しないエラーについては、その他のエラーコードとメッセージをご覧ください。

ブロック

レート制限を超えています。

パラメータ
HTTP ステータス コード: 429 リクエストが多すぎます
error	ブロック
type	https://developers.nest.com/reference/error-messages#blocked
message	ブロック

煙・一酸化炭素 safety 断の間にファンを始動することはできません

緊急 Shut 断が有効です。API 呼び出しは、通常のオペレーションが復旧するまで使用できません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	煙・一酸化炭素 safety 断の間にファンを始動することはできません
type	https://developers.nest.com/reference/error-messages#safety-shutoff-on
message	煙・一酸化炭素 safety 断の間にファンを始動することはできません

緊急ヒーターがオンになっている間は外出のステータスを変更できません

プロダクトは、緊急ヒーターがオンの間に外出中の状態を変更しようとしました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	緊急ヒーターがオンになっている間は外出のステータスを変更できません
type	https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message	緊急ヒーターがオンになっている間は外出のステータスを変更できません

省エネイベント中は暖房換気空調モードを変更できません

Nest エネルギー パートナーで定義された省エネ イベントが有効になります。API 呼び出しは、省エネイベントが終了するまで拒否されます。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	省エネイベント中は暖房換気空調モードを変更できません
type	https://developers.nest.com/reference/error-messages#energy-saving-event-on
message	省エネイベント中は暖房換気空調モードを変更できません

暖房換気空調モードを変更できません

モードがリクエストに対応していません。

たとえば、次のような場合にこのメッセージが表示されることがあります。

• サーモスタットの暖房換気空調システムは、製品でリクエストされたモード（heat、cool、heat-cool、eco）に対応していません。
• 暖房換気空調モードを eco に設定すると、プロダクトは target_temperature を設定しようとします。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	暖房換気空調モードを $mode に変更することはできません。暖房換気空調システムを$action
type	https://developers.nest.com/reference/error-messages#incompatible-mode
message	暖房換気空調モードを $mode に変更することはできません。暖房換気空調システムを$action
details	$mode $action

サーモスタット ロックが有効な場合は暖房換気空調モードを変更できません

プロダクトがデータを書き込むには、ユーザーがサーモスタットのロック解除を行う必要があります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	サーモスタット ロックが有効な場合は暖房換気空調モードを変更できません
type	https://developers.nest.com/reference/error-messages#lock-enabled
message	サーモスタット ロックが有効な場合は暖房換気空調モードを変更できません

温度を 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 のオンとオフを切り替えることはできません

暖房換気空調システムのファンは、ユーザーによる手動、スケジュール、または暖房換気空調システムの暖房/冷房サイクルによって、すでに操作されています。

期待される結果が得られない場合は、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

camera_timer_duration を選択した値に設定することはできません

商品で fan_timer_duration を無効な値に設定しようとしました。有効な値の一覧については fan_timer_duration をご覧ください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	ファン タイムを設定された値に設定することはできません。使用できる値については、API リファレンスをご覧ください。
type	https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message	ファン タイムを設定された値に設定することはできません。使用できる値については、API リファレンスをご覧ください。

設定温度を高温より高く設定することはできません

サーモスタットが heat-cool モードで、製品は設定温度の範囲外または低温度を設定しようとしました。たとえば、target_temperature_high_c が 24°C のときは、target_temperature_low_c を 25°C に設定しようとしました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	設定温度の下限 $lowTemp より高い温度 $highTemp を設定できません
type	https://developers.nest.com/reference/error-messages#low-high-error
message	設定温度の下限 $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 リクエストに対応していないモードである。

たとえば、暖房換気空調システムが off モードまたは heat-cool モードのときは、target_temperature_f または target_temperature_c を設定できません。サーモスタット/ストラクチャが制限モードに戻るまで、値を変更することはできません。

このメッセージで、$fieldName設定温度の値のいずれかを指定できます。 $mode次のいずれかになりますeco、emer_heat_enable 、heat-cool 、heat 、cool 、 off 、hvac_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

暖房換気空調モードを変更する前にデバイスのファームウェアの更新が必要です

エコ温度を設定するには、デバイスを現在のファームウェア バージョンに更新する必要があります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	暖房換気空調モードを変更する前にデバイスのファームウェアの更新が必要です。自動更新は通常、リリースから 1 週間以内に完了します。
type	https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message	暖房換気空調モードを変更する前にデバイスのファームウェアの更新が必要です。自動更新は通常、リリースから 1 週間以内に完了します。

WWN フィールドの検証中にエラーが発生しました

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	WWN フィールドの検証中にエラーが発生しました: $error
type	https://developers.nest.com/reference/error-messages#where-id-internal
message	WWN フィールドの検証中にエラーが発生しました: $error
details	$error

到着予定時刻は過去です

指定された ETA の時刻は過去（NOW より前）です。ETA の発信について詳しくは、外出と ETA のガイドをご覧ください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	到着予定時刻: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type	https://developers.nest.com/reference/error-messages#eta-in-the-past
message	到着予定時刻: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details	$estimatedArrivalTime $currentTime

到着予定時刻が先すぎます

現在の到着予定時刻は 8 時間以内で指定してください。ETA の発信について詳しくは、外出と ETA のガイドをご覧ください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	到着予定時刻が先すぎます
type	https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message	到着予定時刻が先すぎます

ファン時間設定なし

fan_timer_active が定義されていない。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	ファン時間設定なし
type	https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message	ファン時間設定なし

禁止

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

無効なコンテンツが送信されました

呼び出しに無効なコンテンツが含まれています。たとえば、ブール値の変数に「true」ではなく「yes」を使用します。

パラメータ
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

無効な暖房換気空調モード

サーモスタットの暖房換気空調システムは、製品が要求するモード（heat、cool、heat-cool）をサポートしていません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	無効な暖房換気空調モード: $mode
type	https://developers.nest.com/reference/error-messages#invalid-mode
message	無効な暖房換気空調モード: $mode
details	$mode

煙・一酸化炭素警報 ID が無効です

smoke_co_alarm_id が無効である

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	煙・一酸化炭素警報 ID $id が無効です
type	https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message	煙・一酸化炭素警報 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 文字を超える Thermostat ラベルを作成しようとしました。

パラメータ
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

名前が長すぎるカスタムの最大数

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 がありません

暖房換気空調システムファンなし

暖房換気空調システムには独立したファンがあるようです。

パラメータ
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	ペア設定されたデバイスがありません

キャンセルできる有効な ETA がありません

ルートが有効でないため、キャンセルできません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	キャンセルできる有効な ETA がありません
type	https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message	キャンセルできる有効な ETA がありません

フィールドの書き込み権限がありません

クライアントにこのデータの書き込み権限がありません。詳細については、権限の概要をご覧ください。

パラメータ
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 の呼び出しは、ストラクチャが「外出」に設定されている場合にのみ受け入れられます。

パラメータ
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 に対して間違った数値形式を使用して目標温度を設定しようとしました。摂氏温度は 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	項目は $fieldNames ISO 8601 形式で指定してください
type	https://developers.nest.com/reference/error-messages#time-format-error
message	項目は $fieldNames ISO 8601 形式で指定してください
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	地域 ID を作成できません
type	https://developers.nest.com/reference/error-messages#wheres-missing
message	地域 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 がありません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	名前が記載されていない場合
type	https://developers.nest.com/reference/error-messages#where-name-missing
message	名前が記載されていない場合

名前の長さがゼロ

ここで、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

ここで、id は文字列にする必要があります

where_id の形式が無効です。たとえば、文字列ではなく数値が送信されました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error	ここで、id は文字列にする必要があります
type	https://developers.nest.com/reference/error-messages#where-id-wrong-format
message	ここで、id は文字列にする必要があります

その他のエラーコードとメッセージ

デバイスのエラーコード

Nest API に関係のない、デバイス固有のエラーコードとメッセージについては、以下をご覧ください。

• Nest Thermostat のエラーコード
• Nest Cam または Dropcam のエラーコード

REST エラーコード

REST API 呼び出しを行うと、一般的な HTTP ステータス コードが返されます。

REST レート制限メッセージ

REST を使用していて、短時間で送信する呼び出しが多すぎると、HTTP レスポンスのステータス コード 429 リクエストが多すぎます。

詳細については、データレートの上限をご覧ください。