Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

エラーメッセージ

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

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

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

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

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

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

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

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

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

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

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

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

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

  • サーモスタットの暖房換気空調システムは、製品でリクエストされたモード(heatcoolheat-cooleco)に対応していません。
  • 暖房換気空調モードを eco に設定すると、プロダクトは target_temperature を設定しようとします。
パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error暖房換気空調モードを $mode に変更することはできません。暖房換気空調システムを$action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
message暖房換気空調モードを $mode に変更することはできません。暖房換気空調システムを$action
details$mode
$action

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

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

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

温度を C と F に同時に設定することはできません

この製品は、摂氏と華氏の両方を同時に同時に設定しようとしました。製品は、temperature_scale(C/F)で指定された目標温度のみを設定する必要があります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error温度を C と F に同時に設定することはできません
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
message温度を C と F に同時に設定することはできません

互換性のないモードのため、fan_timer_active のオンとオフを切り替えることはできません

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

期待される結果が得られない場合は、API によってオーバーライドできない組み込み動作がデバイスにある可能性があります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorモード $mode に互換性がないため、fan_timer_active のオンとオフを切り替えることはできません
typehttps://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 リファレンスをご覧ください。
typehttps://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 を設定できません
typehttps://developers.nest.com/reference/error-messages#low-high-error
message設定温度の下限 $lowTemp より高い温度 $highTemp を設定できません
details$lowTemp
$highTemp

設定温度を N 度(摂氏)以上にすることはできません

プロダクトが設定温度の上限と下限温度にあまり近い値に設定しようとしました(例: target_temperature_high_f)。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error設定温度を N 度(摂氏)以上にすることはできません
typehttps://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次のいずれかになりますecoemer_heat_enableheat-coolheatcooloffhvac_safety_shutoff_activeの各行を理解してください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorモードが $mode の場合は target_temperature を設定できません
typehttps://developers.nest.com/reference/error-messages#mode-error
messageモードが $mode の場合は $fieldName を設定できません
details$fieldName
$mode

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

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

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

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

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

到着予定時刻は過去です

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

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

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

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

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

ファン時間設定なし

fan_timer_active が定義されていない。

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

禁止

Nest サービスへのアクセスに使用されている認証情報が無効です。

パラメータ
HTTP ステータス コード: 403 禁止されています
error禁止
typehttps://developers.nest.com/reference/error-messages#forbidden
message禁止

内部エラー

パラメータ
HTTP ステータス コード: 500 内部サーバーエラー
error内部エラー
typehttps://developers.nest.com/reference/error-messages#internal-error
message内部エラー

カメラ ID が無効です

camera-id が無効である

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error無効なカメラ ID $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
message無効なカメラ ID: $id
details$id

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

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

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error無効なコンテンツが送信されました
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
message無効なコンテンツが送信されました

フラグメント パスが無効です

リクエストパスの一部が無効です。たとえば、オブジェクト名またはフィールド名のスペルが間違っている可能性があります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error無効なフラグメント パス: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
message無効なフラグメント パス: $requestPath
details$requestPath

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

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

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

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

smoke_co_alarm_id が無効である

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error煙・一酸化炭素警報 ID $id が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message煙・一酸化炭素警報 ID が無効です: $id
details$id

ストラクチャ ID が無効です

structure_id が無効である

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error構造 ID $id が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
message無効な構造 ID: $id
details$id

無効なサーモスタット ID

thermostat_id が無効である

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error無効なサーモスタット ID $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
message無効なサーモスタット ID: $id
details$id

オフラインの値が無効です

away に無効な値を設定しようとしました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorオフラインの値が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
message無効な値: $value。指定できる値は「home」と「away」のみです。
details$value

is_streaming がブール値ではありません

商品は is-streaming フィールドをブール値以外に設定しようとしました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
erroris_streaming がブール値ではありません
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming がブール値ではありません

ラベルは 256 文字未満にしてください

256 文字を超える Thermostat ラベルを作成しようとしました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorラベルは $max_label_length 文字未満にする必要があります
typehttps://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 の数が超過する最大カスタム数
typehttps://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 を超えるカスタムの上限
typehttps://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
typehttps://developers.nest.com/reference/error-messages#field-is-missing
message次の欄が入力されていません: $fieldName
details$fieldName

場所 ID がありません

where_id 形式が未入力です。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error場所 ID がありません
typehttps://developers.nest.com/reference/error-messages#where-id-missing
message場所 ID がありません

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

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

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error暖房換気空調システムファンなし
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
message暖房換気空調システムファンなし

オンライン サーモスタットなし

サーモスタットは現在オフラインです。Wi-Fi が有効になると、プロダクトは再びアクセスできるようになります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorオンライン サーモスタットなし
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageオンライン サーモスタットなし

ペア設定されたデバイスがありません

ユーザーの Nest デバイスがユーザーの Nest アカウントとペア設定されていない

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorペア設定されたデバイスがありません
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageペア設定されたデバイスがありません

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

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

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

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

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

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error次のフィールドに対する書き込み権限がありません: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
message次のフィールドに対する書き込み権限がありません: $fields
details$fields

有効なリクエスト タイプではありません

リクエスト タイプが無効です。たとえば、PUT が必要な場合に POST 呼び出しが行われたとします。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error有効なリクエスト タイプではありません: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
message有効なリクエスト タイプではありません: $requestType
details$requestType

見つかりませんでした

呼び出しで存在しないパスの読み取りが試行されました。

パラメータ
HTTP ステータス コード: 404 見つかりません
error見つかりませんでした
typehttps://developers.nest.com/reference/error-messages#not-found
message見つかりませんでした

外出モードではない

到着予定時刻が呼び出されたときにストラクチャが外出モードになっていない。 ETA の呼び出しは、ストラクチャが「外出」に設定されている場合にのみ受け入れられます。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error外出モードではない
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
message外出モードではない

書き込みできません

書き込もうとしているフィールドは読み取り専用です。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error書き込みできません
typehttps://developers.nest.com/reference/error-messages#not-writable
message書き込みできません

名前の入力が必要な場所のみ

wheres の呼び出しに余分なフィールドが含まれていました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error名前の入力が必要な場所のみ
typehttps://developers.nest.com/reference/error-messages#extra-fields
message名前の入力が必要な場所のみ

POST は有効なリクエスト タイプではありません

リクエストの種類が無効です。たとえば、PUT が必要な場合に POST 呼び出しが行われたとします。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorPOST は有効なリクエスト タイプではありません
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST は有効なリクエスト タイプではありません

スキーマ違反

デバイスのペア設定中にエラーが発生しました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorスキーマ違反
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageスキーマ違反

サービスを利用できません

パラメータ
HTTP ステータス コード: 503 サービスを利用できません
errorサービス利用不可
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageサービス利用不可

ストラクチャにペア設定可能なデバイスの数が上限に達しています

この構造には、許可された最大デバイス数がすでに存在します。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorストラクチャにペア設定可能なデバイスの数が上限に達しています
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageストラクチャにペア設定可能なデバイスの数が上限に達しています

ストラクチャの所有者がユーザーではありません

structure_id がレコードのユーザー アカウントと一致しません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorストラクチャがユーザーの所有者ではありません。
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageストラクチャがユーザーの所有者ではありません。

温度 C が高すぎる(ロック温度)

ユーザーがサーモスタットをロックし、ロック温度範囲を超える温度を摂氏設定しようとした。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error温度 C $tempC は、ロック温度 $highLockTemp に対して高すぎます
typehttps://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 に対して低すぎます
typehttps://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
typehttps://developers.nest.com/reference/error-messages#high-c-value
message温度 C の値が高すぎます: $tempC
details$tempC

温度 C の値が低すぎます

このプロダクトは、摂氏設定に対して低すぎる目標温度値を設定しようとしました。摂氏で許可されている温度範囲については、target_temperature_c をご覧ください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error温度 C の値が低すぎます: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
message温度 C の値が低すぎます: $tempC
details$tempC

温度 F が高すぎるためロック温度に達していません

ユーザーがサーモスタットをロックし、製品がロック温度の範囲よりも高い目標温度を設定しようとした。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error温度 F $tempF は、ロック温度 $highLockTemp に対して高すぎます
typehttps://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 に対して低すぎます
typehttps://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
typehttps://developers.nest.com/reference/error-messages#high-f-value
message温度 F の値が高すぎます: $tempF
details$tempF

温度 F の値が低すぎます

プロダクトは、設定温度が華氏に対して低すぎる値に設定しようとしました。華氏で許容される温度範囲については、target_temperature_f をご覧ください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error温度 F の値が低すぎます: $tempF
typehttps://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」の形式が正しくありません
typehttps://developers.nest.com/reference/error-messages#format-error
message温度「$temp」の形式が正しくありません
details$temp

更新時にフィールドを変更することはできません

プロダクトは読み取り専用フィールドに書き込もうとしました。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error次のフィールドは変更できません。$fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
message次のフィールドは変更できません。$fieldNames
details$fieldNames

フィールドには ISO 8601 形式を使用してください

フィールドが ISO 8601 形式ではありません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error項目は $fieldNames ISO 8601 形式で指定してください
typehttps://developers.nest.com/reference/error-messages#time-format-error
message項目は $fieldNames ISO 8601 形式で指定してください
details$fieldNames

サーモスタットはオンラインではありません

サーモスタットは現在オフラインです。Wi-Fi が有効になると、プロダクトは再びアクセスできるようになります。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorサーモスタットはオンラインではありません
typehttps://developers.nest.com/reference/error-messages#not-online
messageサーモスタットはオンラインではありません

このルートは手動でオーバーライドされました

ユーザーがルートを手動でオーバーライドした。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorこのルートは手動でオーバーライドされました
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageこのルートは手動でオーバーライドされました

地域 ID を作成できません

wheres オブジェクトがありません。where_id 値は定義されていません。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error地域 ID を作成できません
typehttps://developers.nest.com/reference/error-messages#wheres-missing
message地域 ID を作成できません

非許可

承認に失敗しました。

このエラー メッセージは、いくつかの条件によって表示されることがあります。

  • 指定した HTTP 実装によって Authorization ヘッダーがリダイレクト先の URI に自動的に転送されない場合に、誤ったリダイレクトが発生する。詳しくは、リダイレクトの処理方法をご覧ください。

  • API エンドポイントにアクセスしようとした際に、誤った権限が付与されました。たとえば、カメラ権限のみがクライアントに選択されたときに、サーモスタット エンドポイントの読み取りを試みます。詳しくは、権限を選択する方法をご覧ください。

パラメータ
HTTP ステータス コード: 401 認証されていません
error非許可
typehttps://developers.nest.com/reference/error-messages#auth-error
message非許可

不明

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error不明
typehttps://developers.nest.com/reference/error-messages#unknown
message不明

不明なベンダー/デバイスタイプ

デバイスのペア設定中にベンダーまたはデバイスが認識されませんでした。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error不明なベンダー/デバイスタイプ
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message不明なベンダー/デバイスタイプ

$fieldName の値のタイプが正しくありません

間違ったデータ型が送信されました。たとえば、ブール値が期待される場合に文字列を送信します。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error$fieldName の値の型が正しくありません
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
message$fieldName の値の型が正しくありません
details$fieldName

名前がすでに存在する場合

プロダクトで設定しようとした where_name はすでに存在します。新しい名前でもう一度お試しください。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error$name」という名前はすでに存在しています
typehttps://developers.nest.com/reference/error-messages#where-name-exists
message$name」という名前はすでに存在しています
details$name

名前が記載されていない場合

呼び出しに where_name がありません。

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

名前の長さがゼロ

ここで、name は定義されていません(ゼロ文字)。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error名前の長さがゼロ
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
message名前の長さがゼロ

名前には文字列を指定する必要があります

where_name に対して送信されたデータ型が正しくありません。たとえば、文字列が想定されている場合の数値です。

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
error名前には文字列を指定する必要があります
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
message名前には文字列を指定する必要があります

where_id が存在しない

where_id が無効である

パラメータ
HTTP ステータス コード: 400 不正なリクエスト
errorwhere_id が存在しない
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagewhere_id が存在しない
details$where_id

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

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

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

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

デバイスのエラーコード

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

REST エラーコード

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

REST レート制限メッセージ

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

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