Usar o ponto de entrada da Pesquisa Google

Como usar os pontos de entrada da Pesquisa Google

Para usar os pontos de entrada da Pesquisa Google, é preciso exibir um ponto de entrada com base na consulta de pesquisa incluída nos metadados da resposta embasada. A resposta inclui:

  • "content": resposta gerada pelo LLM.
  • "searchQuery": a consulta que será usada para o ponto de entrada 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 pontos de entrada da Pesquisa Google para exibir essa saída.

Requisitos para pontos de entrada da Pesquisa Google

O que fazer:

  • Exiba o ponto de entrada exatamente como fornecido, sem modificações, em conformidade com os requisitos de exibição abaixo.
  • Isso leva os usuários diretamente para a página de resultados da Pesquisa Google (SRP, na sigla em inglês) quando eles interagirem com o ponto de entrada.

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 do ponto de entrada ou da resposta do LLM fundamentada associada.

Requisitos de exibição

  • Mostre o ponto de entrada exatamente como ele foi fornecido e não modifique as cores, as fontes ou a aparência. Verifique se o ponto de entrada é renderizado conforme especificado nas simulações a seguir, incluindo os modos claro e escuro:
  • Sempre que uma resposta fundamentada for exibida, o ponto de entrada correspondente da Pesquisa Google deverá 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.
  • Os pontos de entrada 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.

exemplo de app/desktop

Código para implementar um ponto de entrada da Pesquisa Google

Quando você usa a API para fundamentar uma resposta para a pesquisa, a resposta do modelo fornece estilo HTML e CSS compatível no campo renderedContent que você implementa para exibir pontos de entrada 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