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"
  }
}

すべてのエラー メッセージには、error、type、message、instance の各フィールドが含まれます。details オブジェクトはオプションです。

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

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

ブロック

レート制限を超えました。

パラメータ
HTTP ステータス コード: 429 Too Many Requests
errorブロック
typehttps://developers.nest.com/reference/error-messages#blocked
messageブロック

煙または一酸化炭素の安全遮断時に扇風機を起動できない

緊急遮断機能が有効になっています。API 呼び出しは、通常のオペレーションが復元されるまで受け入れられません。

パラメータ
HTTP ステータス コード: 400 Bad Request
error煙または一酸化炭素の安全遮断時に扇風機を起動できない
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
message煙または一酸化炭素の安全遮断時に扇風機を起動できない

緊急ヒーターがオンのときは外出ステータスを変更できません

緊急暖房が有効になっているときに、プロダクトが外出ステータスを変更しようとしました。

パラメータ
HTTP ステータス コード: 400 Bad Request
error緊急ヒーターがオンのときは外出ステータスを変更できません
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
message緊急ヒーターがオンのときは外出ステータスを変更できません

省エネ中に暖房換気空調モードを変更することはできません

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error省エネ中に暖房換気空調モードを変更することはできません
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
message省エネ中に暖房換気空調モードを変更することはできません

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

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

たとえば、次のような場合に表示されます。

  • Thermostat の HVAC システムは、製品からリクエストされたモード（heat、cool、heat-cool、eco）をサポートしていません。
  • HVAC モードが eco に設定され、プロダクトが target_temperature を設定しようとしている
パラメータ
HTTP ステータス コード: 400 Bad Request
error暖房換気空調モードを $mode に変更できません。暖房換気空調システムで $action を行うことはできません
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
message暖房換気空調モードを $mode に変更できません。暖房換気空調システムで $action を行うことはできません
details$mode
$action

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

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

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

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

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

パラメータ
HTTP ステータス コード: 400 Bad Request
errorC と F の温度を同時に設定することはできません
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageC と F の温度を同時に設定することはできません

非対応モードのため、fan_timer_active をオンまたはオフにできません

HVAC システムのファンがすでに作動しているか（ユーザーが手動またはスケジュール設定しているか、HVAC の暖房/冷房サイクルにより）。

期待どおりの結果が得られない場合、API でオーバーライドできない動作がデバイスにある可能性があります。

パラメータ
HTTP ステータス コード: 400 Bad Request
error非対応モード $mode のため、fan_timer_active をオンまたはオフにできません
typehttps://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 をご覧ください。

パラメータ
HTTP ステータス コード: 400 Bad Request
errorfan_timer_duration を選択された値に設定することはできません。使用できる値については、API リファレンスをご覧ください。
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messagefan_timer_duration を選択された値に設定することはできません。使用できる値については、API リファレンスをご覧ください。

設定より低い温度に設定することはできません

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error最低温度を目標$lowTempより高く設定することはできません$highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
message最低温度を目標$lowTempより高く設定することはできません$highTemp
details$lowTemp
$highTemp

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

本製品は、設定温度を目標高温 / 低温値（target_temperature_high_f など）に非常に近づけようとしました。

パラメータ
HTTP ステータス コード: 400 Bad Request
error設定温度を °C より高く設定することはできません
typehttps://developers.nest.com/reference/error-messages#range-error
message目標温度は $min 度 $scale より低く設定することはできません
details$min
$scale

モードが $mode の場合は target_temperature を設定できません

現在、サーモスタットまたはストラクチャが API リクエストをサポートしていないモードになっている。

たとえば、HVAC システムが 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 Bad Request
errorモードが $mode の場合、target_temperature を設定できません
typehttps://developers.nest.com/reference/error-messages#mode-error
messageモードが $mode のときは $fieldName を設定できません
details$fieldName
$mode

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

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error暖房換気空調モードを変更するには、デバイスのファームウェアを更新してください。更新は通常、リリースの 1 週間以内に自動的に行われます。
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
message暖房換気空調モードを変更するには、デバイスのファームウェアを更新してください。更新は通常、リリースの 1 週間以内に自動的に行われます。

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

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

到着予定時刻が過ぎています

指定された到着予定時刻が過去の日時です（現在より前）。ETA 呼び出しについて詳しくは、外出 / ETA ガイドをご覧ください。

パラメータ
HTTP ステータス コード: 400 Bad Request
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 Bad Request
error到着予定時刻が遠すぎる
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message到着予定時刻が遠すぎる

fan_timer_active が設定されていません

fan_timer_active が定義されていません。

パラメータ
HTTP ステータス コード: 400 Bad Request
errorfan_timer_active が設定されていません
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messagefan_timer_active が設定されていません

アクセス禁止

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

パラメータ
HTTP ステータス コード: 403 Forbidden
errorアクセス禁止
typehttps://developers.nest.com/reference/error-messages#forbidden
messageアクセス禁止

内部エラー

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

カメラ ID が無効です

camera-id が無効です。

パラメータ
HTTP ステータス コード: 400 Bad Request
errorカメラ ID $id が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
message無効なカメラ ID: $id
details$id

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

呼び出しに無効なコンテンツが含まれています。たとえば、ブール変数の場合は "true" の代わりに &yes を使用します。

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

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

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

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

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

サーモスタットの暖房換気空調システムは、heat、cool、heat-cool のうちでリクエストされたモードをサポートしていません。

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

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

smoke_co_alarm_id が無効です。

パラメータ
HTTP ステータス コード: 400 Bad Request
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 Bad Request
errorストラクチャ ID $id が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
message無効なストラクチャ ID です: $id
details$id

無効なサーモスタット ID です

thermostat_id が無効です。

パラメータ
HTTP ステータス コード: 400 Bad Request
errorサーモスタット ID $id が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
message無効なサーモスタット ID: $id
details$id

外出の値が無効です

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error外出の値が無効です
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
message無効な値: $value指定できる値は 'home' と 'away' のみです。
details$value

is_streaming がブール値でない

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

パラメータ
HTTP ステータス コード: 400 Bad Request
erroris_streaming がブール値でない
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming がブール値でない

ラベルは 256 文字未満で指定する必要があります

製品は、256 文字を超えるサーモスタット ラベルを作成しようとしました。

パラメータ
HTTP ステータス コード: 400 Bad Request
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 Bad Request
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 Bad Request
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 Bad Request
error次の欄が入力されていません: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
message次の欄が入力されていません: $fieldName
details$fieldName

場所 ID がありません

where_id 形式が指定されていません。

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

暖房換気空調システムのファンがない

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error空調ファンなし
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
message空調ファンなし

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

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

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

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

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

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

キャンセルできる有効な到着予定時刻がありません

このルートは無効であり、キャンセルできません。

パラメータ
HTTP ステータス コード: 400 Bad Request
errorキャンセルできる有効な到着予定時刻がありません
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageキャンセルできる有効な到着予定時刻がありません

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

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error次のフィールドへの書き込み権限がありません: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
message次のフィールドへの書き込み権限がありません: $fields
details$fields

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

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

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

見つかりませんでした

存在しないパスの読み取りを呼び出しました。

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

外出モード以外

ETA を呼び出したとき、ストラクチャがアウェイ モードになっていません。ETA 通話は、ストラクチャが「外出」に設定されている場合にのみ受け入れられます。

パラメータ
HTTP ステータス コード: 400 Bad Request
error外出モード以外
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
message外出モード以外

書き込み不可

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error書き込み不可
typehttps://developers.nest.com/reference/error-messages#not-writable
message書き込み不可

名前を指定する必要がある場所のみ

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error名前を指定する必要がある場所のみ
typehttps://developers.nest.com/reference/error-messages#extra-fields
message名前を指定する必要がある場所のみ

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

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

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

スキーマの違反

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

パラメータ
HTTP ステータス コード: 400 Bad Request
errorスキーマの違反
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageスキーマの違反

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

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

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

ストラクチャに、許可されているデバイスの最大数がすでにあります。

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

お客様がストラクチャを所有していません

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

パラメータ
HTTP ステータス コード: 400 Bad Request
errorお客様がストラクチャを所有していません。
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageお客様がストラクチャを所有していません。

温度 C は高すぎてロック温度にできません

サーモスタットがユーザーによってロックされ、製品がロック温度範囲を超える摂氏目標温度を設定しようとしました。

パラメータ
HTTP ステータス コード: 400 Bad Request
error温度 $tempC は、ロック温度 $highLockTemp に対して高すぎます
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
message温度 $tempC は、ロック温度 $highLockTemp に対して高すぎます
details$tempC
$highLockTemp

温度 C は低すぎてロック温度にできません

サーモスタットがユーザーによってロックされ、製品がロック温度範囲よりも低い摂氏設定温度を設定しようとした。

パラメータ
HTTP ステータス コード: 400 Bad Request
error温度 $tempC は、ロック温度 $lowLockTemp に対して低すぎます
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
message温度 $tempC は、ロック温度 $lowLockTemp に対して低すぎます
details$tempC
$lowLockTemp

温度 C の値が高すぎます

商品は、摂氏温度に対して高すぎる目標値を設定しようとしました。摂氏で許可されている温度範囲については、target_temperature_c をご覧ください。

パラメータ
HTTP ステータス コード: 400 Bad Request
error温度 C の値が高すぎます: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
message温度 C の値が高すぎます: $tempC
details$tempC

温度 C の値が低すぎます

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

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

温度 F は高すぎてロック温度にできません

サーモスタットがユーザーによってロックされ、製品がロック温度範囲を超える設定温度を気温に設定しようとした。

パラメータ
HTTP ステータス コード: 400 Bad Request
error温度 $tempF は、ロック温度 $highLockTemp に対して高すぎます
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
message温度 $tempF は、ロック温度 $highLockTemp に対して高すぎます
details$tempF
$highLockTemp

温度 F は低すぎてロック温度にできません

サーモスタットがユーザーによってロックされており、製品がロック温度範囲より低い目標温度を設定しようとしている。

パラメータ
HTTP ステータス コード: 400 Bad Request
error温度 $tempF は、ロック温度 $lowLockTemp に対して低すぎます
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
message温度 $tempF は、ロック温度 $lowLockTemp に対して低すぎます
details$tempF
$lowLockTemp

温度 F の値が高すぎます

目標設定温度である度が高すぎると、華氏を設定しようとしました。許容温度の範囲（華氏）については、target_temperature_f をご覧ください。

パラメータ
HTTP ステータス コード: 400 Bad Request
error温度 F の値が高すぎます: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
message温度 F の値が高すぎます: $tempF
details$tempF

温度 F の値が低すぎます

商品は、設定温度が華氏低すぎるため設定しようとしました。許容温度の範囲（華氏）については、target_temperature_f をご覧ください。

パラメータ
HTTP ステータス コード: 400 Bad Request
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 Bad Request
error温度 $temp は不適切な形式です。
typehttps://developers.nest.com/reference/error-messages#format-error
message温度 $temp は不適切な形式です。
details$temp

アップデート時にフィールドを変更することはできません

プロダクトが読み取り専用フィールドへの書き込みを試みました。

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

ISO 8601 形式を指定します。

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

パラメータ
HTTP ステータス コード: 400 Bad Request
errorISO 8601 形式である必要があります。$fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageISO 8601 形式である必要があります。$fieldNames
details$fieldNames

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

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

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

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

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

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

場所 ID を作成できません

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error場所 ID を作成できません
typehttps://developers.nest.com/reference/error-messages#wheres-missing
message場所 ID を作成できません

未承認

認証に失敗しました。

このエラー メッセージが表示される原因は 2 つあります。

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

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

パラメータ
HTTP ステータス コード: 401 Unauthorized
error未承認
typehttps://developers.nest.com/reference/error-messages#auth-error
message未承認

不明

パラメータ
HTTP ステータス コード: 400 Bad Request
error不明
typehttps://developers.nest.com/reference/error-messages#unknown
message不明

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

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

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

$fieldName のタイプが間違っています

間違ったデータタイプが送信されました。たとえば、ブール値が想定されている文字列の送信です。

パラメータ
HTTP ステータス コード: 400 Bad Request
error$fieldName のタイプが間違っています
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
message$fieldName のタイプが間違っています
details$fieldName

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

商品が設定しようとした where_name はすでに存在します。新しい名前でもう一度お試しください。

パラメータ
HTTP ステータス コード: 400 Bad Request
error「$name」という名前がすでに存在します
typehttps://developers.nest.com/reference/error-messages#where-name-exists
message「$name」という名前がすでに存在します
details$name

名前が指定されていない場合

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

パラメータ
HTTP ステータス コード: 400 Bad Request
error名前が指定されていない場合
typehttps://developers.nest.com/reference/error-messages#where-name-missing
message名前が指定されていない場合

名前の長さがゼロです

name が定義されていない（ゼロ文字）。

パラメータ
HTTP ステータス コード: 400 Bad Request
error名前の長さがゼロです
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
message名前の長さがゼロです

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

where_name に対して間違ったデータ型が送信されました。たとえば、文字列が想定される数値です。

パラメータ
HTTP ステータス コード: 400 Bad Request
error名前は文字列で指定する必要があります
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
message名前は文字列で指定する必要があります

where_id は存在しません

where_id が無効です。

パラメータ
HTTP ステータス コード: 400 Bad Request
errorwhere_id は存在しません
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagewhere_id は存在しません
details$where_id

where_id は文字列で指定する必要があります

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

パラメータ
HTTP ステータス コード: 400 Bad Request
errorwhere_id は文字列で指定する必要があります
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagewhere_id は文字列で指定する必要があります

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

デバイスのエラーコード

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

REST エラーコード

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

REST レート制限メッセージ

REST を使用して短期間に大量の呼び出しを行うと、HTTP レスポンス ステータス コード「429 Too Many Requests」が返されることがあります。

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