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

構造

構造

ネスト構造は、実世界の物理構造を表します。通常、ユーザーの家は、デバイスの整理ポイントとして機能し、家全体に適用されるデータを保存します。

巣のAPIは、付与された権限のレベルに応じて、以下の構造レベルのデータへのアクセスを提供します。

  • 構造名とデバイス「場所の名前」(家の中の場所)
  • 家庭内のデバイスのリスト
  • エネルギーイベント状態(エネルギーのラッシュアワー
  • アウェイ状態
  • ユーザーETA
  • セキュリティ状態
  • 郵便番号または郵便番号

一部の構造レベルの機能は、個別のより詳細なAPIガイドで説明されています。

構造の権限

アクセスのために...選択する...
内のほとんどのデータ値structuresオブジェクトアウェイETAエネルギー、または郵便番号の権限
name中のデータ値structuresオブジェクト構造読み取り/書き込み権限

許可がでどのように機能するかを参照してくださいインタラクティブなAPIリファレンス

構造識別子

名前

構造の名前のデフォルトは「ホーム」ですが、ユーザーが選択した任意の文字列にすることができます。あなたが選択すると構造の読み取り/書き込み権限を、あなたは、構造変更することができますname

どこ

wheres識別子(含む構造上のオブジェクトの集合であり、 where_idname )。使用wheresカスタム場所の名前、またはアクセス標準名を作成します。

アクセスwheresオブジェクトが必要ですカメラ煙+ CO警報、またはサーモスタットの権限を。

where_id

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

name

  • デバイスの表示名。私たちが提供するリストからの任意の部屋名、またはカスタム名にすることができます
  • カスタム作成するには、 name 、新しい、カスタムの書き込みにPOST呼び出しを行うnamewhere_id呼び出しで返されます
  • 考慮事項
    • name作成後に編集または削除することはできません
    • name構造内で一意である必要があります
    • デバイスは、構造体にペアリングされている場合は、カスタムname 、デバイスに関連付けられているがからアクセス可能な/structures/パス
    • カスタムでデバイスを移動するname所望の名前のデバイス登録解除異なる構造に、および再ペアデバイス

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

その他のメタデータ

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

データ値説明
structure_idこの構造を一意に表す文字列。すべての開発者は同じ構造に対して異なるIDを表示しますが、同じ開発者の複数の製品は同じIDを表示します
country_code構造の登録された場所にマップするISO3166-1alpha-2国コード
postal_code国に応じて、郵便番号または郵便番号
time_zone IANAのタイムゾーンの構造のタイムゾーンにマップの文字列

構造の特徴

煙とCOのアラーム状態

あなたが選択したときに煙+ COが許可を読んで、あなたがアクセスすることができsmoke_alarm_stateco_alarm_stateしてstructures物。これらの同じデータ値は、デバイスオブジェクト(にも利用可能であるdevices/smoke_co_alarms )。

参照CO警報ガイド+煙をこれらの状態の詳細については。

多くのデータ値が連携して、構造内でデバイスがどのように動作するかを決定します。

  • 構造の場合にはaway状態に設定されてaway言葉「ECO」は、ユーザの優先言語で、巣サーモスタット上に表示されます
  • 構造の場合にはaway状態に設定されてaway 、次のことができます。
    • セットfan_timer_active
    • 変更target_temperature_fまたはtarget_temperature_c
  • 構造の場合にはaway状態に設定されhome 、次のことができます。
    • ETA電話をかける(旅行IDと到着ウィンドウを設定する)
  • ときに緊急シャットオフがアクティブになっている、あなたは設定できませんfan_timer_active
  • ときに緊急熱が有効になっている、あなたはに構造を設定することができますすることはできませんaway

複数の構造

ユーザーがNestアカウントに複数の構造を関連付けている可能性があるため、製品は、ユーザーが使用可能な構造から選択する手段(構造ピッカー)を提供する必要があります。

構造ピッカー

たとえば、ETAを設定する場合、ユーザーがETA宛先の構造を選択できることが重要です。同様の方法で、ユーザーは2つの異なる家の「居間」に2つの煙探知器を設置できます。自分の家の概念と構造の相関関係を作成する必要がある場合は、承認プロセス中にこれを実行することをお勧めします。

方法を学び、ユーザーが複数の構造内のデバイスを管理します

デバイスの最大値

Nestが構造内でサポートするデバイスの数には制限があります。

デバイスタイプ構造ごとの最大
ネストサーモスタット20
Nestカメラ10
NestProtect 18

エラーメッセージ

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