スタートガイド

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 サーモスタット
  • すべての 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 とクライアント シークレットの値をコピーし、ローカルマシンに Credentials 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 の設定で生成された 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 とは関係ありません。