Device Access プログラムにより、ユーザーは SDM API を使用して Google Nest デバイスにアクセスし、操作、管理できます。
Device Accessの使用を開始するには、次のタスクを完了する必要があります。
- プログラムに Device Access ご登録ください。
- サポートされている Google Nest デバイスを Google アカウントで有効化します。
- 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 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 を取得します。
- Device Accessに使用する既存の Google Cloud プロジェクトがある場合は、まずそのプロジェクトの管理者アカウントにログインしていることを確認してください。ボタンをクリックした後、使用可能なプロジェクトのリストから既存のプロジェクトを選択します。それ以外の場合は、新しいプロジェクトを作成します。
- 「どこから発信していますか?」というメッセージが表示されたら、[ウェブサーバー] を選択します。
- [承認済みのリダイレクト 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 によって管理され、プロジェクトで承認されたすべてのデバイスと構造に非同期で更新されます。イベントが必要な場合は、[有効にする] を選択します。不明な場合は、[無効にする] を選択します。後でいつでも有効にできます。
- 完了すると、UUID 形式のプロジェクト ID(
32c4c2bc-fe0d-461b-b51c-f3885afff2f0
など)がプロジェクトに割り当てられます。この ID をメモしておきます。この ID はすべての SDM API 呼び出しで必要になります。
このプロジェクト ID は OAuth と API 呼び出しで使用されます。Device Access プロジェクトに固有のものであり、Google Cloud プロジェクト ID には関連付けられません。