アカウントの承認を進める前に、以下の準備を整えてください。
- モバイル デバイスにインストールされている Google Home app (GHA)。Google アカウントで少なくとも 1 つの家（構造物）が設定されている。
- 家にあるサンプルアプリでサポートされているデバイスタイプが 1 つ以上あること:
- 色温度ライト（オン / オフ、明るさ）
- 接触センサー（ブール値の状態）
- 調光ライト（オン / オフ、明るさ）
- 拡張色ライト（オン / オフ、明るさ）
- 汎用スイッチ
- 在室確認センサー（在宅検出）
- ライトのオン/オフ（オン、オフ、明るさ）
- オン/オフ ライトスイッチ
- オン/オフ プラグイン ユニット（オンとオフ）
- オン/オフセンサー
- サンプルの自動化をテストするための 2 台のデバイス。
Home API でデバイスを使用する前に、GHA からデバイスを操作できるようにする必要があります。
サンプルアプリを実行する
サンプルアプリを実行します。初めて実行するときに、Google アカウントで家へのアクセスを許可するよう求められます。これにより、サンプルアプリは、その家にあるストラクチャとデバイスにアクセスして操作する権限を付与されます。
アプリのデフォルトの権限の動作は、アプリが Google Home Developer Console に登録されているかどうかによって異なります。
アプリが Developer Console に登録されていない場合は、未確認の状態になります。これは、Home API の使用をテストする場合に推奨されます。
アプリの権限を付与できるのは、OAuth コンソールでテストユーザーとして登録されたユーザーのみです。未確認のアプリのテストユーザーの上限は 100 人です。
未確認のアプリは、Home APIs の OAuth でサポートされているデバイスタイプ（Developer Console のデバイスタイプのリスト）のすべてのデバイスにアクセスできます。ストラクチャ内のすべてのデバイスにアクセス権が付与されます。
アプリが Developer Console に登録されており、1 つ以上のデバイスタイプへのアクセスが承認され、OAuth のブランド確認が完了している場合、そのアプリは確認済みステータスになります。 この状態は、アプリを本番環境にリリースするために必要です。
- テストユーザーの上限は適用されなくなりました。どのユーザーもアプリに権限を付与できます。
- ユーザーは、Developer Console で承認されたデバイスタイプにのみ権限を付与できます。
[選択した家へのアクセスを許可] をタップします。
- アカウントに接続されている家がある場合は、権限を付与する家を選択します。選択した家にデバイスが見つからない場合は、次のいずれかを行います。
- [別の家へのアクセスを許可する] をタップして、別の家を選択します。
- Google Home app (GHA) を使用して、その家に任意のデバイスをセットアップします。このサンプルアプリでコントロールがサポートされるのは、次のデバイスタイプのみです。
- 色温度ライト（オン / オフ、明るさ）
- 接触センサー（ブール値の状態）
- 調光ライト（オン / オフ、明るさ）
- 拡張色ライト（オン / オフ、明るさ）
- 汎用スイッチ
- 在室確認センサー（在宅検出）
- ライトのオン/オフ（オン、オフ、明るさ）
- オン/オフ ライトスイッチ
- オン/オフ プラグイン ユニット（オンとオフ）
- オン/オフセンサー
- アカウントに接続されている家がない場合、[選択したアカウントに構造物がありません。] というメッセージが表示されます。
- 戻るをスワイプして、サンプルアプリのメインビューに戻ります。
- 家を設定するには、GHA を使用します。その後、サンプルアプリに権限を付与してみます。
権限フローには、サンプルアプリ画面の右上にあるプロフィール アイコン を選択していつでも戻ることができます。
デバイスがある家に権限を付与すると、デバイスのビューが表示されます。サンプルアプリを使用して、デバイスを制御し、デバイスの状態変化を観察できます。