Invocation and Discovery "Explicit Invocation"の日本語訳です
注: この日本語訳は、翻訳時点での内容が反映されています。そのため、既に古い記載内容となっている可能性があります。必ず最新の情報を Actions on Google Document で確認してください。
Googleアシスタント向けアプリのアプリ名をユーザが知っている場合は、ユーザはそのアプリ名を使ってそのアプリを呼び出すことができます。 これを明示的な呼び出し（Explicit Invocation）と呼びます。その際、例えば 「オッケーグーグル、マイレシピアプリで 今日のスープレシピについて教えて 」というように、アプリに対して呼び出しと意図を同時に ユーザが伝え、そのことをアプリが受け取ることができます。こうすることで、ユーザがアプリを利用するための対話の数を削減できます。
Actions on Googleのドキュメントにある Invocation and Discovery - Explicit Invocationにて、 明示的にアプリを呼び出す方法が説明されています。以下はその日本語訳です。
明示的な呼び出し（Explicit Invocation）
明示的な呼び出しは、ユーザーがアプリを名前で使用するようにGoogleアシスタントに指示したときに発生します。 必要に応じて、ユーザーは呼び出しの最後にアクション呼び出しフレーズを含めて、要求している関数を直接呼び出すことができます。
注: ユーザーは通常、アシスタントディレクトリ （Googleアシスタント上のアプリのためのウェブストアのようなもの）からアプリについて学びます。このディレクトリは、 アプリを発見するための主要なソースですので、良いアプリリストを作成するための開発時間を費やしてください。
明示的な呼び出しのコンポーネント
次の例は、明示的な呼び出しコマンドの可能なさまざまなコンポーネントを示しています。
トリガーフレーズ
これらのフレーズは、明示的な呼び出しを開始します。これらは、Actions on Googleによって定義されます。
- “Ok Google, talk to…“
- “Ok Google, speak to…“
- “Ok Google, I want to speak to…“
- “Ok Google, ask…“
アプリ名（アプリ呼び出し）
これは、”Personal Chef”のような、あなたのアプリの名前です。 “Ok Google, let me talk to Personal Chef.” のように、ユーザは、アプリ名によって明示的にアプリを呼び出すために、これとトリガーフレーズを組み合わせます。基本的な明示的な呼び出しのこの種別は、アプリ呼び出しと呼ばれます。
注: アプリの名前を決めるときには、呼び出しについて気にすることが重要です。 巧みなアプリ名を持っていてもGoogleがそれを認識しない場合、ユーザーはあなたのアプリを呼び出す時にトラブルとなるでしょう。 詳細については、アプリの命名ポリシーとベストプラクティスを参照してください。
アクション呼び出しフレーズ（任意）
アクション呼び出しフレーズは、アプリの発見可能性を高め、ユーザーが実行するアクションを提供することでアプリにディープリンクする方法を提供する貴重なメカニズムです。これらのフレーズは、ユーザーがアプリの機能をリクエストするさまざまな方法を示しているため、Googleアシスタントはアプリの機能をより良く理解し、アプリのアクションとユーザーのリクエストを一致させることができます。
- “find me recipes”
- “recommend a wine”
- “book a ride”
- “play a game”
- “want to meditate”
ユーザーは、アプリ名とアクション呼び出しフレーズを組み合わせて、 “Ok Google, talk to Personal Chef to find me recipes.” などの特定のアクションを明示的に呼び出すことができます。このタイプのタスク固有の明示的な呼び出しは、アクション呼び出しと呼ばれます。
注: アクション呼び出しフレーズがあなたのアプリに固有であり、実際のユースケースを記述していることを確認してください。 よくある間違いは、あなたのアプリの目的が示されるにはあまりにも一般的なアクション呼び出しフレーズを定義することです。 これは、あなたのフレーズがあまり役に立たず、アプリの発見を妨げます。詳細については、暗黙的な呼び出しとベストプラクティスを参照してください。
明示的な呼び出しのインテント
あなたのアプリがアクション呼び出しフレーズなしで明示的に呼び出された場合（ “Ok Google, talk to MyRecipeApp” など）、アプリにおいて actions.intent.MAIN インテントがトリガーされます。アプリには、このインテントを処理するデフォルトアクションが1つだけ含まれている必要があります。
アプリが明示的に名前とアクション呼び出しフレーズを伴って呼び出された場合（たとえば、 “Ok Google, talk to MyRecipeApp for today’s soup recipe” ）、そのアクション呼び出しフレーズに対応するインテントが呼び出されます。
詳細については、インテントに関するドキュメントを参照してください。
Creative Commons Attribution 3.0 License 原文
← Actions on Google開発者向けドキュメント 日本語訳インデックス
