会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、会話型アクションの廃止をご覧ください。

このページは Cloud Translation API によって翻訳されました。

アクション（Dialogflow）にリンクする

特定のアクションに直接リンクする URL をアクションごとに生成できます。ユーザーがウェブブラウザまたはモバイルブラウザでアシスタントのリンク（以前のアクションリンク）をクリックすると、デバイス上のアシスタントに転送され、対応するアクションを直接操作します。

便利なアシスタントのリンクの例:

ハウツーウェブサイトから音声ガイド付きの手順にユーザーをリンクする。
ヘルプページからカスタマーサポートにユーザーをリンクする。
更新インテントにユーザーをリンクし、ユーザーが今後の更新について同意できるようにする。

で確認できます。

アクションの URL を生成する手順は次のとおりです。

Actions Console で、[Develop] >アクション。
リンクを生成するアクションをクリックします。
[Links] セクションで、[Would you like to enable a URL for this Action?] をオンにします。
[Link title] を入力します。このタイトルには、アクションの動作を説明する動詞を含める必要があります。たとえば、コンサートのチケットを購入するアクションがトランザクションフローに移動する場合、有効なリンクタイトルは「コンサートチケットの購入」にします。
[保存] をクリックします。

生成された URL は、この特定のアクションにユーザーを誘導するすべての場所で参照先として使用できます。

アシスタントリンクパラメータ

アシスタントリンクには、必要に応じて URL にインテントとパラメータを含めることができます。Google は、URL で指定されたインテントのタイプに応じてパラメータを処理します。

アシスタントリンクの URL の仕様

アシスタントリンクの URL の一般的な構文は次のとおりです。

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

設定可能な URL パラメータの説明を次の表に示します。

URL パラメータ	説明
`$action_id`	アクションの数値 ID。
`$intent`	組み込みインテントまたはカスタムインテントの完全な名前。
`$param`	アクションパッケージで指定されたインテントパラメータの完全な名前。
`$value`	`$param` に対して宣言された型の URL エンコード値アクションパッケージ。
`$utm_param`	1 つ以上の UTM パラメータ型を含むリスト。有効な値は次のとおりです。 `utm_source` さん、`utm_medium` さん、 `utm_campaign` さん、`utm_term` さん、 `utm_content`。
`$utm_value`	UTM パラメータの文字列値。

組み込みインテントがあるアシスタントのリンク URL

アシスタントのリンクに組み込みインテント（actions.intent.* で始まるインテント）を使用すると、Google は URL 内の組み込みインテントパラメータを抽出し、アクションに渡します。組み込みインテントのパラメータとして認識されないパラメータは除去されます。

会話型アクションの場合、Google はこれらのパラメータを AppRequest メッセージの一部としてフルフィルメントに送信します。

次の例は、単一のインテントパラメータを持つ組み込みインテントを含むアシスタントのリンク URL を指定する方法を示しています。

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

カスタムインテントを含むアシスタントリンク URL

カスタムインテントの場合は、アクションでそのインテントの一部として定義されているパラメータのみが抽出され、その他のパラメータは破棄されます。

次の例は、カスタムインテントを含むアシスタントのリンク URL を指定する方法を示しています。

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

上記の URL の例では、AppRequest に JSON オブジェクトが追加されます。次のようになります。

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

インテントのないアシスタントのリンク URL

アシスタントのリンクでインテントを指定しない場合、デフォルトでは、Google は次のようにアクションの MAIN インテント（actions.intent.MAIN）にリンクします。

アシスタントリンクで MAIN インテントを明示的に有効にしていない場合は、「app_name と話したい」の動作と同様に、パラメータなしでメインインテントがトリガーされます。
MAIN インテントを明示的に有効にした場合は、パラメータがアクションに渡されます。

次の例は、インテントなしでアシスタントのリンク URL を指定する方法を示しています。

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

UTM パラメータを含むアシスタントリンク URL

UTM パラメータは、ユーザーがアシスタントのリンクをクリックすると Google からアクションに送信される文字列で、後で分析に使用できます。

アクションに送信される UTM パラメータは次のとおりです。

utm_source
utm_medium
utm_campaign
utm_term
utm_content

次の例は、UTM パラメータを含むアシスタントリンク URL を指定する方法を示しています。

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

上記の URL の例では、AppRequest メッセージに次の引数が追加されます。

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

アシスタントのリンクをテストする

シミュレータまたはデバイスを使用して、あらゆるインテント（メインまたはカスタム、パラメータあり / なし）のアシスタントリンクをテストできます。

アシスタントのリンクをテストするには:

コンソールでアシスタントのリンクを有効にします。
Actions on Google プロジェクトの作成に使用したのと同じアカウントでアシスタントにログインします。
クリック可能なバージョンのアシスタントリンクを作成します（メール、チャット、ドキュメントなど）。
アシスタント対応デバイスで、前のステップで作成したリンクをクリックします。

アシスタントリンクが想定どおりに機能することを確認したら、アクションを再デプロイしてユーザーがリンクを利用できるようにする必要があります。

制限事項とベストプラクティス

アシスタントのリンク URL をディレクトリや他の Google サービス外で配信、参照できるようになったため、以下の制限とおすすめの方法が適用されます。

引き続きすべてのアシスタントのリンクをサポートしてください。アシスタントリンクを配布し、後でそのリンクが機能しないと、そのアクションプロジェクトは異常であると判断され、削除される可能性があります。
リンクを公開するということは、信頼できないソースからの呼び出しをサポートすることを意味します。リンクされたすべてのアクションについて、「実際のアクション」を行う前にユーザーに明示的に確認を求める必要があります。たとえば、スマートホーム機器をオフにするアクションでは、ユーザーに「$applianceName をオフにしてもよろしいですか？」というプロンプトを表示する必要があります。

この文脈での「実際のアクション」とは、ユーザーのサービス、データ、デバイス、ネットワーク、パソコン、API に影響を与えるあらゆるアクションを意味します。たとえば、メールの送信、トランザクションの実行、スマートホームアプライアンスのステータスの変更、サブスクリプションの作成、コンテンツの更新などがこれに該当します。

アクション（Dialogflow）にリンクする

アシスタント リンク パラメータ

アシスタント リンクの URL の仕様