開始

Device Access このプログラムでは、ユーザーは SDM API を使用して Google Nest デバイスにアクセス、操作、管理を行うことができます。

Device Accessの利用を開始するには、次のタスクを完了する必要があります。

  1. Device Access プログラムに登録します。
  2. Google アカウントで対応する Google Nest デバイスを有効にします。
  3. Google Cloud プロジェクトを作成して SDM API を有効にし、OAuth 2.0 クライアント ID を取得します。
  4. Device Access プロジェクトを作成してプロジェクト ID を取得します。

デバイスへのアクセスを登録する

最初のプロジェクトを作成する前に、 Device Accessに登録する必要があります。登録には、Google APIデバイス アクセス サンドボックスの利用規約への同意と、アカウントごとに 1 回限りの払い戻し不可の手数料(5 米ドル)の支払いが必要です。

利用規約と登録料の両方に同意するまで、プロジェクトを作成することはできません。これは、個人ユーザーと商用サービスを作成しようとしているユーザーの両方を含む、すべてのユーザーに適用されます。

まだ登録していない場合は、 Device Access コンソールで登録します。

Device Access コンソールに移動します。

詳細については、Device Access 登録をご覧ください。

対応デバイスを有効にする

Device Access プログラムでサポートされているデバイスは次のとおりです。

  • すべての Google Nest Thermostat
  • すべての Google Nest カメラ
  • すべての Google Nest Doorbell
  • Google Nest Hub Max

個々のデバイスモデルの一覧については、サポートされているデバイスのページをご覧ください。

対応デバイスを有効にする方法については、デバイスのマニュアルをご覧ください。

Google Cloud Platform の設定

SDM API へのアクセスは Google Cloud を介して提供されます。API を有効にして、サポートされている Nest デバイスで Google アカウントを承認するには、Google Cloud プロジェクトが必要です。

下記の [API を有効にして OAuth 2.0 クライアント ID を取得する] ボタンを使用して、Smart Device Management API を有効にして OAuth 2.0 クライアント ID を取得します。

  1. Device Accessに使用する既存の Google Cloud プロジェクトがある場合は、まずそのプロジェクトの管理者アカウントにログインしてください。次に、ボタンをクリックして、使用可能なプロジェクトのリストから既存のプロジェクトを選択します。表示されない場合は、新しいプロジェクトを作成します。
  2. [Where are you calling from?] と尋ねられたら、[Web Server] を選択します。
  3. [承認済みのリダイレクト URI] の値に「https://www.google.com」と入力します。PCM を使用して認証コードを取得するには、リダイレクト URI が必要です。
  4. 設定が完了したら、OAuth 2.0 クライアント ID とクライアント シークレットの値をコピーし、認証情報 JSON をローカルマシンにダウンロードします。
API を有効にして OAuth 2.0 クライアント ID を取得する

Google Cloud プロジェクトを手動で設定する場合、または設定を確認して認証情報を再度取得する場合は、次の操作を行います。

  1. [API の有効化] ページで Smart Device Management API を有効にします。
  2. [認証情報] ページで OAuth 2.0 クライアント ID を取得します。

デバイス アクセス プロジェクトを作成する

Device Access コンソールに戻ります。

  1. Console のホーム画面で、[ プロジェクトを作成] を選択します。
  2. 作成プロセスの各画面に入力します。
    1. プロジェクトの名前を入力します。
    2. Google Cloud Platform を設定するで生成された OAuth 2.0 クライアント ID を入力します。先ほど OAuth クライアント ID をコピーしなかった場合は、ダウンロードした credentials.json ファイルで確認できます。
    3. イベントを有効または無効にします。イベントは Google Cloud Pub/Sub によって管理され、プロジェクトで承認されているすべてのデバイスと構造に対して非同期で更新を提供します。イベントを有効にする場合は、[有効にする] を選択します。不明な場合は、[無効にする] を選択します。後でいつでも有効にできます。
  3. 完了すると、プロジェクトに UUID 形式のプロジェクト ID(32c4c2bc-fe0d-461b-b51c-f3885afff2f0 など)が割り当てられます。この ID をメモしておいてください。すべての SDM API 呼び出しで必要になります。

このプロジェクト ID は、OAuth と API の呼び出しで使用されます。これはDevice Access プロジェクトに固有のものであり、Google Cloud プロジェクト ID とは関係ありません。