Usar as sugestões da Pesquisa Google

Para usar o embasamento na Pesquisa Google, ative as sugestões da Pesquisa Google. Elas ajudam os usuários a encontrar resultados da pesquisa correspondentes a uma resposta embasada.

Especificamente, é necessário mostrar as consultas de pesquisa incluídas nos metadados da resposta embasada. A resposta inclui:

  • content: resposta gerada pelo LLM
  • webSearchQueries: as consultas a serem usadas para as sugestões da Pesquisa Google

Por exemplo, no snippet de código a seguir, o Gemini responde a um comando baseado na Pesquisa Google que pergunta sobre um tipo de planta tropical.

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

Use as Sugestões de pesquisa Google para mostrar essa saída.

Requisitos para sugestões de pesquisa do Google

O que fazer:

  • mostrar a sugestão de pesquisa exatamente como fornecida, sem modificações, em conformidade com os requisitos de exibição;
  • Direcione os usuários diretamente para a página de resultados da Pesquisa Google (SRP) quando eles interagiarem com a sugestão de pesquisa.

O que não fazer:

  • Inclua telas intersticiais ou etapas adicionais entre o toque do usuário e a exibição do SRP.
  • Mostre outros resultados ou sugestões da pesquisa ao lado da Sugestão de pesquisa ou da resposta do LLM fundamentada associada.

Requisitos de exibição

  • Mostre a sugestão de pesquisa exatamente como ela foi fornecida e não faça modificações nas cores, fontes ou aparência. Confira se a sugestão de pesquisa é renderizada conforme especificado nos modelos a seguir, incluindo os modos claro e escuro: simulação de exibição da sugestão de pesquisa

  • Sempre que uma resposta fundamentada for exibida, a sugestão de pesquisa Google correspondente vai permanecer visível.

  • Branding: é necessário seguir rigorosamente as Diretrizes do Google para o uso de características da marca do Google por terceiros.

  • As sugestões da Pesquisa Google precisam ter, no mínimo, a largura total da resposta embasada.

Comportamento ao tocar

Quando um usuário toca no ícone, ele é direcionado para uma página de resultados da Pesquisa Google (SRP) com o termo de pesquisa exibido no ícone. O SRP pode ser aberto no navegador no app ou em um app de navegador separado. É importante não minimizar, remover ou obstruir a exibição do SRP de maneira alguma. O modelo animado a seguir ilustra a interação do toque para o SRP.

usuário navegando para a página de resultados da pesquisa

Código para implementar uma sugestão da Pesquisa Google

Quando você usa a API para fundamentar uma resposta à pesquisa, a resposta do modelo fornece estilo HTML e CSS compatível no campo renderedContent que você implementa para mostrar sugestões de pesquisa no seu aplicativo. Para conferir um exemplo da resposta da API, consulte a seção de resposta em Embasamento com a Pesquisa Google.

A seguir