Device Access プログラムでは、ユーザーは SDM API を使用して Google Nest デバイスにアクセスし、操作、管理できます。
Device Accessを始めるには、次のタスクを完了する必要があります。
- Device Access プログラムに登録します。
- Google アカウントでサポートされている Google Nest デバイスを有効にします。
- Google Cloud プロジェクトを作成して SDM API を有効にし、OAuth 2.0 クライアント ID を取得します。
- Device Access プロジェクトを作成して、プロジェクト ID を取得します。
デバイス アクセスに登録する
最初のプロジェクトを作成する前に、 Device Accessに登録する必要があります。登録には、Google API とデバイス アクセス サンドボックスの利用規約への同意と、アカウントごとに 1 回限りの払い戻し不可の料金(5 米ドル)の支払いが必要です。
利用規約に同意し、登録料をお支払いいただくまで、プロジェクトを作成することはできません。これは、個人ユーザーと商用サービスを作成しようとしているユーザーの両方に適用されます。
まだ登録していない場合は、 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 を有効にして、サポートされている Google Nest デバイスで Google アカウントを承認するには、Google Cloud プロジェクトが必要です。
下の [API を有効にして OAuth 2.0 クライアント ID を取得] ボタンを使用して、Smart Device Management API を有効にして OAuth 2.0 クライアント ID を取得します。
- Device Accessに使用する既存の Google Cloud プロジェクトがある場合は、まずそのプロジェクトの管理者アカウントにログインしてください。次に、ボタンをクリックして、使用可能なプロジェクトのリストから既存のクラウド プロジェクトを選択します。それ以外の場合は、新しいプロジェクトを作成します。
- 「どこからお電話ですか?」と尋ねられたら、[Web Server](ウェブサーバー)を選択します。
- [承認済みのリダイレクト URI] の値として https://www.google.com を入力します。PCM を使用して承認コードを取得するには、リダイレクト URI が必要です。
- 設定が完了したら、OAuth 2.0 クライアント ID とクライアント シークレットの値をコピーし、認証情報 JSON をローカルマシンにダウンロードします。
Google Cloud プロジェクトを手動で設定する場合、または設定を確認して認証情報を再度取得する場合は:
- [API Enablement] ページで Smart Device Management API を有効にします。
- 認証情報ページで OAuth 2.0 クライアント ID を取得します。
デバイス アクセス プロジェクトを作成する
Device Access コンソールに戻ります。
- コンソールのホーム画面で、[ プロジェクトを作成] を選択します。
- 作成プロセスの各画面に記入します。
- プロジェクトの名前を入力します。
- Google Cloud Platform を設定するで生成された OAuth 2.0 クライアント ID を入力します。OAuth クライアント ID をコピーしていない場合は、ダウンロードした
credentials.jsonファイルで確認できます。 - イベントを有効または無効にします。イベントは Google Cloud Pub/Sub で管理され、プロジェクトで承認されたすべてのデバイスとストラクチャの非同期更新を提供します。イベントが必要な場合は、[イベントを有効にする]、[プロジェクトを作成] の順に選択し、Pub/Sub トピックを編集してトピック ID を指定します。不明な場合は、[無効にする] を選択します。この設定はいつでも再度有効にすることができます。
- 完了すると、プロジェクトに
32c4c2bc-fe0d-461b-b51c-f3885afff2f0などの UUID 形式のプロジェクト ID が割り当てられます。この ID はすべての SDM API 呼び出しに必要になるため、メモしておきます。
このプロジェクト ID は、OAuth と API 呼び出しで使用されます。これはDevice Access プロジェクトに固有のものであり、Google Cloud プロジェクト ID とは関係ありません。