Google Home Developer Center へようこそ。スマートホーム アクションの開発方法を学習できます。注: アクションの構築は、引き続き Actions Console で行います。

アプリの調査とディープリンク

ユーザーがスマート デバイスを Google Assistant に接続し、Google Home Graph でストラクチャと部屋に割り当てる際、主に使用するのが Google Home app (GHA) です。通常、設定を行う場合、複数の画面をクリックして、利用可能なオプションの一覧から smart home アクションを選択します。ユーザーがセットアップ プロセスを簡単に開始できるようにすることで、ユーザーのオンボーディングを迅速化し、ユーザー設定に関する煩わしさを軽減できます。

smart home デバイスでのユーザー オンボーディングを合理化するため、Google smart home プラットフォームには、ユーザーがセットアップ フローをすばやく開始し、smart home デバイスの使用を簡単に開始できる便利な機能がいくつか用意されています。これらの機能は、コーディング作業をほとんど行うことなく、smart home アクションに簡単に統合できます。

以下に、Assistant でスマート デバイスをセットアップする際のスムーズな動作を実装するためのプラットフォーム機能をまとめています。

  • App Discovery: この機能では、GHA でアクションにリンクする候補チップをユーザーが確認できます。チップをクリックすると、サードパーティのプロバイダ アカウントを使用して smart home デバイスを Assistant に接続できます。
  • ディープリンク: この機能を使用して、ディープリンクをアプリまたはプロダクトのウェブサイトに埋め込んで、ユーザーが smart home デバイスを Assistant に簡単に接続できるようにします。リンクをクリックすると、GHA(まだインストールしていない場合)をダウンロードするよう求めるメッセージが表示され、アカウントのリンクと会議室の割り当ての設定フローが起動します。

App Discovery を実装する

ブランドの確認プロセスを完了すると、Actions on Google Console から App Discovery 機能を有効にできます。コードを変更する必要はありませんが、smart home アクションはすでに本番環境で確認されている必要があります。

Actions Console にログインします。

Actions on Google コンソールに移動

  1. smart home Action プロジェクトを開きます。
  2. [Deploy](デプロイ)> [Brand Verification](ブランドの確認)をクリックします。
  3. 次の手順に沿って、会社のウェブサイトを Actions プロジェクトに接続します。
    1. [Websites](ウェブサイト)パネルで、[Connect site](サイトを接続)をクリックします。
    2. 接続したいウェブサイトの URL を入力して、[Connect](接続)をクリックします。 Google からウェブサイトの所有者に、ウェブサイトの関連付けを確認するメールが送信されます。
  4. [Android apps](Android アプリ)パネルで [Connect app](アプリを接続)ボタンをクリックし、表示される手順に従います。

  5. 同じパネルで、接続したアプリの [Enable app discovery](App Discovery を有効にする)をオンにします。このオプションは、アクションが審査を経て承認されるまではグレー表示になっています。

Google Home へのディープリンクを設定する

ディープリンクを使用すると、Android または iOS アプリから GHA 内の特定のデスティネーションにユーザーを直接誘導できるため、Assistant を使用してデバイスのセットアップ プロセスを簡素化できます。

GHA ディープリンクの構文は次のとおりです。

https://madeby.google.com/home-app/?deeplink=destination

現在、Android または iOS アプリは、GHA 内の次のデスティネーションにリンクできます。

宛先 説明
setup/ha_linking?agent_id=agent-id 指定された smart home アクションの agent-id について、 OAuth アカウントのリンクフローを開始します。

リンク先パスは、ディープリンクに適用する前に URL エンコードする必要があります。次に例を示します。

https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

アプリ内からディープリンクをトリガーする方法について詳しくは、関連する Android のドキュメントおよび iOS のドキュメントをご覧ください。