Utiliza un punto de entrada de la Búsqueda de Google

Cómo utilizar los puntos de entrada de la Búsqueda de Google

Para usar los puntos de entrada de la Búsqueda de Google, debes mostrar un punto de entrada basado en la búsqueda incluida en los metadatos de la respuesta fundamentada. En la respuesta, se incluye :

  • "content": Respuesta generada por LLM.
  • "searchQuery": La búsqueda que se usará para el punto de entrada de la Búsqueda de Google.

Por ejemplo, en el siguiente fragmento de código, Gemini responde a una instrucción basada en la Búsqueda de Google que pregunta sobre un tipo de planta tropical.

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

Puedes tomar este resultado y mostrarlo con los puntos de entrada de la Búsqueda de Google.

Requisitos para los puntos de entrada de la Búsqueda de Google

Haz lo siguiente:

  • Muestra el punto de entrada exactamente como se proporciona sin ninguna modificación y, a la vez, cumplir con los Requisitos de visualización que se indican a continuación.
  • Lleva a los usuarios directamente a la página de resultados de la Búsqueda de Google (SRP) cuando interactúen con el punto de entrada.

No hagas lo siguiente:

  • Incluir pantallas intersticiales o pasos adicionales entre la presión del usuario y la visualización de la SRP
  • Muestra cualquier otro resultado de la búsqueda o sugerencias junto con el punto de entrada o la respuesta de LLM fundamentada asociada.

Requisitos de visualización

  • Muestra el punto de entrada exactamente como se proporciona y no realices ninguna modificación en los colores, la fuente ni la apariencia. Asegúrate de que el punto de entrada se renderice como se especifica en las siguientes simulaciones, incluso para el modo claro y oscuro:
  • Siempre que se muestre una respuesta fundamentada, su punto de entrada correspondiente de la Búsqueda de Google debe permanecer visible.
  • Desarrollo de la marca: Debe seguir estrictamente los lineamientos de Google para el uso de terceros de las características de marca de Google
  • Los puntos de entrada de la Búsqueda de Google deben tener, como mínimo, el ancho completo de la respuesta fundamentada.

Comportamiento al presionar

Cuando un usuario presiona el chip, se lo dirige directamente a una página de resultados de la Búsqueda de Google (SRP) para el término de búsqueda que se muestra en el chip. La SRP puede abrirse dentro del navegador integrado en la app o en otra app de navegador. Es importante no minimizar, quitar ni obstruir la pantalla de la SRP de ninguna manera. En la siguiente simulación animada ilustra la interacción de presionar para acceder a la SRP.

ejemplo de app/computadora de escritorio

Código para implementar un punto de entrada de la Búsqueda de Google

Cuando usas la API para fundamentar una respuesta para la búsqueda, la respuesta del modelo proporciona un estilo HTML y CSS compatible en el campo renderedContent que implementas para mostrar los puntos de entrada de búsqueda en tu aplicación. Para ver un ejemplo de la respuesta de la API, consulta la sección de respuesta en Fundamentos con la Búsqueda de Google.

¿Qué sigue?