Device Access プログラムを使用すると、SDM API を使用して Google Nest デバイスへのアクセス、デバイスの制御、管理を行えます。
Device Accessを使用するには、次のタスクを実行する必要があります。
- プログラムに Device Access 登録する。
- Google アカウントを使って、対応する Google Nest デバイスを有効化します。
- Google Cloud プロジェクトを作成して SDM API を有効にし、OAuth 2.0 クライアント ID を取得します。
- プロジェクト ID を受け取るように Device Access プロジェクトを作成します。
デバイス アクセスの登録
最初のプロジェクトを作成する前に、 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 を有効にして、サポートされている Nest デバイスで Google アカウントを承認するには、Google Cloud プロジェクトが必要です。
下の [API を有効にして OAuth 2.0 クライアント ID を取得する] ボタンを使用して Smart Device Management API を有効にし、OAuth 2.0 クライアント ID を取得します。
- Device Accessに使用する既存の Google Cloud プロジェクトがある場合は、最初にそのプロジェクトの管理者アカウントにログインしていることを確認してください。ボタンをクリックしてから、利用可能なプロジェクトのリストから既存のプロジェクトを選択します。それ以外の場合は、新しいプロジェクトを作成します。
- [どこからの電話ですか?] と表示されたら [ウェブサーバー] を選択します。
- [承認済みのリダイレクト URI] の値として「https://www.google.com」を入力します。PCM を使用して認証コードを取得するには、リダイレクト URI が必要です。
- 設定が完了したら、OAuth 2.0 クライアント ID とクライアント シークレットの値をコピーして、認証情報の JSON をローカルマシンにダウンロードします。
Google Cloud プロジェクトを手動で設定する場合、または設定を確認して認証情報を再度取得する場合は、次のようにします。
デバイス アクセス プロジェクトを作成する
Console に戻ります。 Device Access
- コンソールのホーム画面で [ プロジェクトを作成] を選択します。
- 作成プロセスの各画面に入力します。
- プロジェクトの名前を入力します。
- Google Cloud の設定時に生成された OAuth 2.0 クライアント ID を入力します。以前に OAuth クライアント ID をコピーしていない場合は、ダウンロードした
credentials.json
ファイルで確認できます。 - イベントを有効または無効にする。イベントは Google Cloud Pub/Sub で管理され、プロジェクトで承認済みのすべてのデバイスと構造の非同期更新が行われます。イベントが必要な場合は [有効にする] を選択します。不明な場合は [無効にする] を選択します。後でいつでも有効にできます。
- 完了すると、UUID(例:
32c4c2bc-fe0d-461b-b51c-f3885afff2f0
)形式のプロジェクト ID がプロジェクトに割り当てられます。この ID をメモしておきます。これはすべての SDM API 呼び出しで必要になります。
このプロジェクト ID は、OAuth および API 呼び出しで使用されます。これはDevice Access プロジェクトに固有のもので、Google Cloud プロジェクト ID とは関係ありません。