スタートガイド

Device Access プログラムは、SDM API を使用して Google Nest デバイスへのアクセス、制御、管理を可能にするプログラムです。

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

  1. プログラムに Device Access ご登録ください。
  2. サポートされている Google Nest デバイスを Google アカウントで有効化します。
  3. Google Cloud プロジェクトを作成して SDM API を有効にし、OAuth 2.0 クライアント ID を取得します。
  4. プロジェクト ID を受け取る Device Access プロジェクトを作成します。

デバイス アクセスに登録する

最初のプロジェクトを作成する前に、 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. 「どこからの電話ですか?」という質問が表示されたら、[ウェブサーバー] を選択します。
  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. コンソールのホーム画面で、[ プロジェクトを作成] を選択します。
  2. 作成プロセスの各画面に入力します。
    1. プロジェクトの名前を入力します。
    2. Google Cloud Platform の設定で生成した OAuth 2.0 クライアント ID を入力します。以前に OAuth クライアント ID をコピーしていない場合は、ダウンロードした credentials.json ファイルで確認できます。
    3. イベントを有効または無効にします。イベントは Google Cloud Pub/Sub によって管理され、プロジェクトが承認されているすべてのデバイスと構造を非同期に更新します。イベントを使用する場合は、[有効にする] を選択します。不明な場合は、[無効にする] を選択します。後でいつでも有効にできます。
  3. 完了すると、プロジェクトにプロジェクト ID(32c4c2bc-fe0d-461b-b51c-f3885afff2f0 のような UUID 形式)が割り当てられます。この ID は、すべての SDM API 呼び出しで必要になるためメモしておきます。

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