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

ネスト API リファレンス

Nest API は、Nest Learning Thermostat、Nest Protect、Nest Cam をデバイスとして構造として使用し、物理的な家や建物を構造としてモデル化します。この構造には、家全体に関する情報(外出中、到着予定時刻、アクティブなピーク時間など)も含まれます。

構造内のすべてのデータ要素は、共有 JSON ドキュメント内のリソース URL(「データの場所」と呼ばれます)でアドレス指定できます。それぞれのデータの場所には、文字列、数値、ブール値、親/子オブジェクト、配列を格納できます。

このインタラクティブ API リファレンスでデータモデルを確認する。

API を使用すると、データモデル内の複数のレベルの場所のデータを同期できます。次に例を示します。

  • すべてのデバイスを含む構造全体
  • ストラクチャ内の 1 つのデバイス
  • データ値のグループ(現在温度と気温)
  • 単一のデータ値(電池の状態)

商品は以下のようなイベントに配慮して対応する必要があります。

ただし、デバイスベースの各オブジェクトが実際の制約下で機能していることに留意してください。たとえば、緊急ヒーターが有効になっている場合は、サーモスタットでエアコンを実行してはいけません。Google の API は、デバイスとユーザーの家の両方を保護するように設計されており、ユーザーが驚かせたり危険であったりした場合に特定のアクションを防止します。

権限と共有デバイスのデータ

データ ロケーションに対する読み取りまたは書き込みの権限は権限によって制御されます。権限グループは、デバイスと構造内の選択されたデータ値に対する読み取り、書き込み、読み取り/書き込みアクセス権を付与します。

詳細については、権限の概要をご覧ください。

データとプライバシー

家庭向け製品に関連するデータは、かなり個人に及ぶ場合があります。ホームセンサー データには、ユーザーが個人用スペースで生活している方法に関する情報が含まれています。データのセキュリティと処理はとても重要であり、Nest は重要な焦点となっています。Google は、所有しているデータの種類、その利用方法、ユーザーによる制御の方法をユーザーに明示しています。

詳しくは、プライバシーに関する Google の見解をご覧ください。

メタデータ

メタデータは、ルートレベル エンドポイントを呼び出すときに提供される追加情報です。

https://developer-api.nest.com/

access_token

ユーザー承認後、製品はアクセス トークンを使用して Nest サービスへの API 呼び出しを行います。このアクセス トークンは、ユーザーがお客様の代わりに通話を行うことを承認した証拠となります。

詳細
戻り値string
例: 「cm.FmDPkzyzaQe...」

client_version

クライアント バージョンは、クライアントが最後に承認したバージョンであり、access_token に関連付けられます。

クライアントの権限を更新すると、クライアントのバージョンが増分し、更新が利用可能であることがユーザーに通知されます。ユーザーは、更新されたクライアントを使用する前にこのクライアント アップデートに同意する必要があります。

詳細
戻り値number
例: 1、17、42

user_id

ユーザー ID を使用すると、API 呼び出し全体でユーザーを識別できます。この ID は、Works with Nest 製品とユーザーの組み合わせごとに異なります。

たとえば、ユーザー 1 が Works with Nest のプロダクト A と Works with Nest のプロダクト B を承認した場合、プロダクト A にはユーザー 1 の user_id 値が 1 つあり、プロダクト B には別の user_id という値があります。ユーザー 1 の値。

詳細
戻り値string
例: z.1.1.7DHps...