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

煙+ COアラーム

煙+ COアラーム

保護巣はそれが自宅で何が起こっているかを理解するために複数のセンサと、居住環境に煙や一酸化炭素(CO)を検出するように設計されています。

巣のAPIは、プロテクト巣上の次のデータへのアクセスを提供します。

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

Smoke + CO権限

すべての煙+ CO警報APIデータ値への読み取りアクセスのために、選択COが読ん煙+クライアントの許可を。

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

煙+ CO識別子

端末

Nestデバイスは、IDの配列としてタイプ別に一覧表示されます。これを使用して、デバイスパスを介してデバイスを一意に識別できます。煙+ CO警報IDだから、 "RTMTKxs..."あなたは時の煙+ CO警報器モデルをロードできることを意味しますdevices/smoke_co_alarms/RTMTKxs... API経由で。

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

名前

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

name

この例では、 name 「プロテクト巣」です。

名前

name_long

この例では、 name_long 「プロテクト地下巣」です。

長い名前

どこ

where_id

  • 表す一意、巣、生成された識別子name
  • where_id 、読み取り専用で、どこカスタム作成するコールに自動的に作成されたname

名前場所についての詳細はこちら 巣のサーモスタット巣を保護し、巣カム

where_name

あなたが選択したときに煙+をCOが許可を読んで、あなたは、デバイスにアクセスすることができますwhere_nameデバイスオブジェクト(からdevices/smoke_co_alarms )。

その他のメタデータ

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

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

Smoke + COの機能

バッテリーの状態

使用battery_healthバッテリーの健康状態を表示するフィールドを。

説明
okバッテリーレベルはOK
replace電池残量が少なくなっています。交換する必要があります

COアラーム

使用co_alarm_state CO警報状態を表示するフィールドを。

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

煙警報器

使用smoke_alarm_state煙警報状態を表示するフィールドを。

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

手動テスト

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

UIの色の状態

それが簡単にコヒーレントクロス製品のUIを設計できるようにするために、我々は提供してきましたui_color_state Protectの巣の全体的な状態の高レベルの表示を与えるフィールドを、。それが由来するis_onlinebattery_healthco_alarm_state 、及びsmoke_alarm_stateに表示される実際の色指標反映凝集状態提供ネストアプリ

エラーメッセージ

API呼び出しのエラーは何を意味するかの詳細については、どのように見、それらを処理するためにエラーメッセージを