Actions Console のシミュレータを使用すると、ハードウェア デバイスとその設定をシミュレートする、使いやすいウェブ インターフェースを介してアクションをテストできます。フルフィルメントが送受信するリクエストやレスポンスなどのデバッグ情報にもアクセスできます。
プロジェクトをテストする
Actions プロジェクトのテストには、次の制限があります。
- アクションは最大 30 日間テストできます。30 日経過後は、テスト用に新しいバージョンを作成する必要があります。
- 開発中のアクションは、サポート対象のハードウェア デバイス(Android 6.0 以降、iOS 9.1 以降、音声認識スピーカー)でテストできます。デバイスは、Actions Console と同じ Google アカウントにログインする必要があります。「OK Google, テストアプリに話しかけて」と話しかけると、アクションの現在のドラフト版が呼び出されます。
- デフォルトでは、シミュレータはドラフトのアクションのバージョンを使用します。テストする別のバージョンを選択する方法をご覧ください。
入力方法
レスポンスのテキスト フィールドのボタンをクリックして、テスト用の入力方法を指定できます。
次のリストは、入力タイプと入力タイプで使用可能なデバイスを示しています。
- 自動検出 - 音声、キーボード、タップ入力を自動的に検出します。
- タップ - インタラクティブなエクスペリエンスや要素(候補ワードなど)に使用します。スマートディスプレイとスマートフォン デバイスで利用可能です。
- 音声 - 音声のみの入力に使用されます。スマートディスプレイ、スマートフォン、スピーカーの各デバイスでご利用いただけます。
- キーボード - テキストのみの入力に使用します。スマートフォン デバイスで利用できます。
デフォルトの入力方法は自動検出です。選択したサーフェスに基づいて、入力タイプも無効または有効になります。
入力方法は、RawInput
オブジェクトのフルフィルメントへのすべてのリクエストに inputType
フィールドとして含まれます。
{
"inputType": "VOICE",
"query": "Tell me a fact about Google's headquarters"
}
デバイスを指定する
シミュレータでは、さまざまなデバイスを模倣し、アクションのデバイス固有のエクスペリエンスをテストできます。
シミュレートされたデバイスを変更する手順は次のとおりです。
左上にあるデバイスのプルダウンをクリックします。デフォルトでは [スマートディスプレイ] が選択されています。
シミュレーションするデバイスを選択してください。
- スマートディスプレイ - ディスプレイ機能とスピーカー機能を備えたアシスタント搭載デバイス(Google Nest Hub など)。
- スマートフォン - ディスプレイ機能とスピーカー機能を持つアシスタント搭載スマートフォン。
- スピーカー - スピーカー機能を備えた、アシスタント搭載のスマート スピーカーです。
- KaiOS - KaiOS 搭載のアシスタント搭載スマートフォン
言語を選択する
2 番目のプルダウン メニューから言語を選択して、シミュレートする言語とリージョンを設定できます。多言語のアクションの作成について詳しくは、ローカライズのドキュメントをご覧ください。
場所を設定する
デバイスの座標とアドレスを手動で設定できます。この機能を使用すると、コンソールで設定した地域ターゲティング機能と、フルフィルメントで構成した地域固有のレスポンスをテストできます。
アクションで使用するシミュレートされた位置情報を取得するには、ユーザー情報ヘルパーを使用して、位置情報にアクセスする権限をユーザーに依頼します。
設定
左上の [Settings] ボタンをクリックして、シミュレータの追加オプションにアクセスします。
バージョンを選択してください
テストする Actions プロジェクトのバージョン(公開バージョンまたはドラフト バージョン)を指定できます。プロジェクト バージョンを選択する手順は次のとおりです。
シミュレータで、右上隅の [Settings] ボタンをクリックします。
[バージョンを選択] の横にあるプルダウンをクリックして、テストするバージョンを選択します。
バージョンのプルダウン メニューで、テストする Actions プロジェクトのバージョンを選択し、[完了] をクリックします。ドラフト バージョンに加えて、送信したすべてのバージョンが表示されます。ドラフト バージョンとは、送信前のプロジェクトの現在の状態を示します。
テスト URL
Actions プロジェクトをテストするときに本番環境を変更しないように、本番環境の Webhook の代わりに使用する個別の URL を指定できます。テスト URL は、Actions プロジェクトのバージョンごとに構成されます。1 つの Actions プロジェクトに、一意のテスト URL を持つ複数のバージョンを作成できるため、本番環境に影響を与えることなく、アクションの複数のバージョンをシミュレータでテストできます。
[テスト URL] 設定が有効になっている場合、シミュレータは Actions プロジェクトの本番環境 Webhook URL をオーバーライドし、代わりに、指定されたテスト Webhook URL を使用します。
シミュレータでテスト URL を構成する前に、以下を行います。
Actions プロジェクトのバージョンのテストに使用する URL を決定します。
URL でリクエストを受け入れるように、テストに使用するサーバーを構成します。
シミュレータでテスト URL を構成するには:
Simulator の右上隅で、[Settings] をクリックします。
[テスト URL] を有効にします。
[URL をテスト] ボックスに、テストに使用する URL を入力します。
指定したテスト URL がシミュレータに表示されます。
アカウントのリンク
アカウントのリンクによって、アクションは Google ログイン、OAuth ベースの Google ログインの「合理化された」リンク、または OAuth を使用できるようになります。
アクションのアカウント リンクを設定していない場合は、[設定] の [アカウントのリンクを設定] をクリックして、コンソールの [アカウントのリンク] セクションに移動します。
アカウントをリンクする手順は次のとおりです。
Actions Console のシミュレータで、シミュレータの入力領域に「talk to my test app」と入力してアクションをテストします。
クエリを送信して、アクションのアカウント リンクフローを初期化します。
プロンプトを使用してログインします。
アカウントのリンクが成功したことを確認します。
リンクされたアカウントはアカウントのリンクが解除されるまで保持されるため、リンクされた同じアカウントを使用してアクションを更新できます。
アカウントのリンクを解除するには、[アカウントのリンク] で [設定] > [リンクを解除] をクリックします。
オンデバイス テスト
この設定により、実機でのテストを有効または無効にできます。デバイスでテストするには、Actions on Google プロジェクトの作成に使用したのと同じアカウントにログインする必要があります。
オーディオの再生
テスト中に音声再生をミュートまたは有効にするには、このオプションを切り替えます。
開発サンドボックス
このオプションを有効にすると、お支払い方法に対する請求は発生しません。詳細については、トランザクションのドキュメントをご覧ください。
未確認ユーザーをシミュレートする
このオプションは、他のユーザーの Voice Match が設定されているデバイスでユーザーが使用している場合にシミュレートします。