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