Googleは、黒人コミュニティのための人種的衡平の促進に取り組んでいます。 方法をご覧ください。
このページは Cloud Translation API によって翻訳されました。
Switch to English

Nest APIリファレンス

Nest APIは、物理的な家や建物を構造としてモデル化し、Nestラーニングサーモスタット、Nestプロテクト、Nest Camを構造内のデバイスとして使用します。この構造には、家全体に関する情報(アウェイまたはETA状態、アクティブなラッシュアワーなど)も含まれています。

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

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

APIから、データモデルの複数のレベルの場所からデータを同期できます。次に例を示します。

  • すべてのデバイスを含む構造全体
  • 構造内の単一のデバイス
  • データ値のグループ(現在および周囲温度)
  • 単一のデータ値(バッテリーのヘルス状態)

製品は、次のようなイベントに慎重に対応する必要があります。

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

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

データの場所の読み取りまたは書き込み機能は、権限によって制御されます。権限グループは、デバイスおよび構造で選択されたデータ値への読み取り、書き込み、または読み取り/書き込みアクセスを提供します。

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

データとプライバシー

家庭用品に関連するデータは非常に個人的なものになる可能性があります。ホームセンサーデータには、個人空間での生活の仕方に関する情報が含まれています。そのデータのセキュリティと処理は非常に重要であり、Nestに重点を置いています。私たちはユーザーに、私たちがどのようなデータを持っているか、それがどのように使用されているか、そしてどこでそれを制御できるかを明確にしています。

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

メタデータ

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

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

アクセストークン

ユーザー認証後、製品はアクセストークンを使用してNestサービスへのAPI呼び出しを行います。このアクセストークンは、ユーザーがあなたの製品に代わって電話をかけることを許可したことの証明となります。

細部
戻り値 string
例:「c.FmDPkzyzaQe ...」

client_version

クライアントバージョンは、クライアントの最後のユーザー認証バージョンであり、 access_token関連付けられています。

クライアントの権限を更新すると、クライアントのバージョンがインクリメントされ、更新が利用可能であることがユーザーに通知されます。ユーザーは、更新された製品を使用する前に、このクライアント更新を受け入れる必要があります。

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

ユーザーID

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

たとえば、ユーザー1がWorks with Nest製品AとWorks with Nest製品Bを承認している場合、製品Aにはユーザー1の1つのuser_id値があり、製品Bにはユーザー1の異なるuser_id値があります。

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