Usar as sugestões de pesquisa do Google

Quando você usa o Embasamento com a Pesquisa Google e recebe sugestões de pesquisa na sua resposta, é necessário mostrar as sugestões de pesquisa na produção e nos apps.

Para mais informações sobre o embasamento com a Pesquisa Google, consulte Embasar com a Pesquisa Google.

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 que serão 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 para mostrar essa saída.

Requisitos para as Sugestões da Pesquisa Google

O que fazer:

  • Mostre a sugestão de pesquisa exatamente como fornecido, sem modificações, em conformidade com os requisitos de exibição abaixo.
  • 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:
  • Sempre que uma resposta fundamentada for exibida, a sugestão correspondente da Pesquisa Google permanecerá visível.
  • Branding (construção da marca): é necessário seguir rigorosamente as Diretrizes do Google para o uso de características da marca do Google por terceiros.
  • As Sugestões de 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.

exemplo de app/desktop

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 ver um exemplo de resposta da API, consulte a seção de resposta em Embasamento com a Pesquisa Google.

A seguir