Notice: We're retiring Works with Nest. See the home page for more information.
Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。
このページは Cloud Translation API によって翻訳されました。
Switch to English

Smoke + COアラーム

煙+ COアラーム

Nest Protectは、住宅環境で煙と一酸化炭素(CO)を検出するように設計されており、複数のセンサーを使用して、家で何が起こっているのかを理解できます。

Nest APIは、Nest Protectの次のデータへのアクセスを提供します。

  • 煙または一酸化炭素(CO)のアラームステータス
  • バッテリーの健康状態
  • 最後の手動テストのステータスとタイムスタンプ
  • オンラインステータスと最終接続情報
  • 構造名とデバイスの「場所名」(自宅の場所)

Smoke + CO権限

すべてのSmoke + COアラームAPIデータ値への読み取りアクセスについては、クライアントのSmoke + CO読み取り権限を選択します。

Smoke + COアラームAPIに使用できる書き込み権限はありません。

Smoke + CO識別子

端末

Nestデバイスは、IDの配列としてタイプ別にリストされ、デバイスパスを介してデバイスを一意に識別するために使用できます。したがって、 "RTMTKxs..." smoke + coアラームIDは、APIを介して、 devices/smoke_co_alarms/RTMTKxs... smoke + coアラームデバイスモデルをロードできることを意味します。

デバイスが複数の製品に接続されている場合、各開発者にはそのデバイスの異なるIDが表示されます。同じ開発者の複数の製品をインストールしたデバイスの場合、開発者には同じIDが表示されます。

名前

2つの名前属性が提供されます。 name_longは長い形式のテキストで使用されますが、短いname属性はユーザーインターフェイスのラベルに表示されます。

name

この例では、 nameは「Nest Protect」です。

名前

name_long

この例では、 name_longは「Basement Nest Protect」です。

長い名前

どこ

where_id

  • nameを表す、ネストによって生成された一意の識別子
  • where_idは読み取り専用で、カスタムwhere nameを作成する呼び出しで自動的に作成されます

NestサーモスタットNest ProtectsNest Camsの名称の詳細をご覧ください。

where_name

Smoke + CO読み取り許可を選択すると、デバイスオブジェクト( devices/smoke_co_alarms )からデバイスwhere_nameアクセスできます。

その他のメタデータ

特に指定がない限り、すべてのデータ値は読み取り専用です。

データ値説明
locale このデバイスに割り当てられた言語と国コード
software_version 現在デバイスにインストールされているファームウェアを表す文字列
structure_id この構造を一意に表す文字列。これは、デバイスがペアになっている構造です
last_connection Nestサービスへの最後に成功した接続のタイムスタンプ
is_online オンライン状態。これは、 last_connection時間とデバイス固有の予想される再接続ウィンドウを使用して、Nestによって決定されます。

Smoke + COの機能

バッテリーの健康

バッテリーの状態を表示するには、 battery_healthフィールドを使用します。

説明
ok 電池残量は大丈夫
replace 電池残量が少ないため、交換する必要があります

COアラーム

COアラームの状態を表示するには、 co_alarm_stateフィールドを使用します。

説明
ok 通常運転
warning 上昇するCOレベルの検出
emergency COレベルが高すぎる、ユーザーは家を出る必要がある

煙警報

煙警報の状態を表示するには、 smoke_alarm_stateフィールドを使用します。

説明
ok 通常運転
warning 上昇する煙レベルの検出
emergency 煙レベルが高すぎるため、ユーザーは家を出る必要があります

手動テスト

これらのフィールドを使用して、手動の煙またはCOテストが現在アクティブかどうか、および正常な煙またはCOテストが最後に実行された時刻を確認します。

UIカラー状態

一貫したクロス製品UIを設計しやすくするために、Nest Protectの全体的な状態を高レベルで示すui_color_stateフィールドを提供しました。それが由来するis_onlinebattery_healthco_alarm_state 、及びsmoke_alarm_stateに表示される実際の色指標反映凝集状態提供ネストアプリ

エラーメッセージ

API呼び出しエラーの意味とその処理方法については、「 エラーメッセージ」を参照してください。