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

NestAPIのアーキテクチャ

ネストサービスについて

Nestアプリケーションを使用すると、ユーザーはどこにいても自宅に接続できます。すべてのNestデバイス(サーモスタット、プロテクト、カメラ)とアプリケーション(iOS、Android、ウェブアプリ)がNestサービスに接続します。

クラウド間の例

Nestサービスは、家のデータモデルを提供します。デバイスとアプリケーションは、このデータモデルから読み取って、適切なアクションを実行します。システムの変更を反映するようにデータモデルを更新します。

たとえば、サーモスタットはデータモデルから目標温度を読み取ります。周囲温度を現在の測定値に設定し、センサーデータをホーム/アウェイアシストに送信します。ホーム/アウェイアシストは、それに応じて構造モードを調整します。

Nestデバイスは制約のある環境で動作します。電力は制限されており、ホームネットワーク接続は信頼できない可能性があります。お客様の製品とサービスは、当社のデバイスアルゴリズムを活用して、ユーザーにシンプルで直感的な家庭体験を提供できます。

データモデル

Nest APIは、 metadatadevicesstructures最上位属性を持つJSONドキュメントとして表されます。 Works with Nest製品は、このJSONドキュメントを使用して、Nestデバイスおよび関連する状態の変化とやり取りし、それに反応します。

ネストstructuresは、実世界の物理構造を表します。これらはdevices整理ポイントとしてdevicesし、建物全体のデータを保存します。通常、 structureはユーザーホームです。

Nest devicesは、構造内の物理デバイス(サーモスタット、保護、カメラ)を表します。

JSONドキュメント内のすべてのデータ要素は、URL(「データの場所」とも呼ばれます)でアドレス指定できます。 Works with Nest製品は、このドキュメントのセクションを読み書きしたり、変更をサブスクライブしたりできます。このサブスクリプション機能により、Works with Nest製品は、ユーザーが構造を[退席中]に設定したときにライトをオフにするなど、システムに加えられた変更にリアルタイムで対応できます。

オブジェクトは、実際の制約の下でも機能します。データモデルは、驚くべき危険なアクションを防ぐことにより、デバイスとユーザーの家を保護します。たとえば、非常用熱が有効になっている場合、サーモスタットはエアコンを作動させません。

このインタラクティブなAPIリファレンスを使用してデータモデルを調べてください。

意図した状態

Nestサービスはシステムの信頼できる状態を保存し、Works withNest製品は変更をサブスクライブします。この状態を変更すると(たとえば、サーモスタットの目標温度を変更するため)、サービスは変更通知をすべてのサブスクライバーにプッシュします。

この伝播にはある程度の遅延があり、ネットワークの信頼性が低い可能性があるため、製品によって観察される状態は、他の製品またはサービスによって現在観察される状態ではない場合があります。さまざまな製品間でメッセージが送信されると、最終的に状態が同期されます。

このドキュメント指向のパブリッシュ/サブスクライブモデルは、応答性の高いアプリケーションの相互作用を提供します。

Nestサービスの使用

NestサービスのRESTエンドポイントにアクセスするには、製品でHTTPSを使用します。この目的で使用できるサードパーティのクライアントライブラリは多数あります。

権限と承認

私たちは、開発者がユーザーのプライバシーとセキュリティを損なうことなく、家をより良くする製品とサービスを構築できるようにしたいと考えています。私たちの通信はすべて安全であり、データにアクセスするための許可は常にユーザーによって明示的に付与されます。詳細については、権限の概要を参照してください。

承認はOAuth2.0プロトコルによって処理されます。ユーザーが要求されたアクセス許可レベルへのアクセスを提供することに同意すると、Nestは要求を認証し、アクセストークンが要求者に付与されます。そのアクセストークンを使用して、Nest APIにアクセスし、ユーザーの構造やデバイスとやり取りできます。

アクセストークンを付与すると、ユーザー、Works with Nest製品、Nestの間に信頼関係が確立されます。ユーザーはいつでもアクセスを取り消すことができます。

Nest APIへの接続を承認する方法については、承認の概要を参照してください。