Google 検索の検索候補を使用する

Google 検索によるグラウンディングを使用し、回答で Google 検索の検索候補を受け取った場合は、本番環境とアプリで検索候補を表示する必要があります。

Google 検索によるグラウンディングの詳細については、Google 検索によるグラウンディングをご覧ください。

具体的には、グラウンディングされた回答のメタデータに含まれる検索クエリを表示する必要があります。回答には次のものが含まれます。

  • "content": LLM が生成した回答。
  • "webSearchQueries": Google 検索の検索候補に使用するクエリ。

たとえば、次のコード スニペットでは、熱帯植物の種類を尋ねる Google 検索でグラウンディングされたプロンプトに Gemini が応答しています。

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

この出力は、Google 検索の検索候補を使用して表示できます。

Google 検索の検索候補の要件

必須事項:

  • 以下の表示要件を遵守しながら、検索候補を変更せずにそのまま表示する。
  • ユーザーが検索候補を操作したときに、Google 検索の検索結果ページ（SRP）に直接移動する。

禁止事項:

  • ユーザーがタップしてから SRP が表示されるまでの間に別の画面や追加の手順を表示する。
  • 検索候補または関連するグラウンディングされた LLM の回答と一緒に他の検索結果や候補を表示する。

表示の要件

  • 検索候補は提供されたとおりに表示します。色、フォント、外観を変更してはなりません。次のモックで指定されているとおりに検索候補がレンダリングされるようにします（ライトモードとダークモードを含む）。
  • グラウンディングされた回答を表示するたびに、対応する Google 検索の検索候補が常に表示されるようにする必要があります。
  • ブランディング: Google ブランドの第三者による使用のためのガイドラインを厳守する必要があります。
  • Google 検索の検索候補は、グラウンディングされた回答の幅以上にする必要があります。

タップ時の動作

ユーザーがチップをタップしたときに、チップに表示されている検索語句の Google 検索結果ページ（SRP）に直接移動します。SRP は、アプリ内ブラウザまたは別のブラウザアプリで開くことができます。SRP の表示を妨げたり、最小化や削除を行わないようにすることが重要です。次のアニメーション モックアップは、タップして SRP を表示する操作を示しています。

app/desktop の例

Google 検索の検索候補を実装するためのコード

API を使用して検索への回答をグラウンディングすると、モデルの回答では renderedContent フィールドで準拠する HTML と CSS のスタイルが提供されます。これを実装すると、アプリで検索候補を表示できます。API レスポンスの例については、Google 検索によるグラウンディングの回答のセクションをご覧ください。

次のステップ