Google の検索候補を使用する

Google 検索でグラウンディングを使用するには、Google 検索候補を有効にする必要があります。これにより、ユーザーはグラウンディングされた回答に対応する検索結果を見つけられるようになります。

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

  • content: LLM が生成したレスポンス
  • webSearchQueries: 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 を表示する操作を示しています。

ユーザーが検索結果ページに移動したとき

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

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

次のステップ