Utiliser le point d'entrée de recherche Google

Utiliser les points d'entrée de recherche Google

Pour utiliser les points d'entrée de recherche Google, vous devez afficher un point d'entrée basé sur la requête de recherche incluse dans les métadonnées de la réponse ancrée. La réponse inclut :

  • "content" : réponse générée par le LLM.
  • "searchQuery" : requête à utiliser pour le point d'entrée de recherche Google.

Par exemple, dans l'extrait de code suivant, Gemini répond à une requête ancrée avec la recherche Google qui pose une question sur un type de plante tropicale.

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

Vous pouvez récupérer ce résultat et l'afficher à l'aide des points d'entrée de la recherche Google.

Conditions requises pour les points d'entrée de recherche Google

À faire :

  • Afficher le point d'entrée exactement tel qu'il est fourni sans aucune modification, tout en respectant les exigences d'affichage ci-dessous.
  • Rediriger les utilisateurs directement vers la page de résultats de la recherche Google (SRP) lorsqu'ils interagissent avec le point d'entrée.

À ne pas faire :

  • Inclure tous les écrans intermédiaires ou étapes supplémentaires entre le clic de l'utilisateur et l'affichage de la SRP.
  • Afficher d'autres résultats de recherche ou suggestions avec le point d'entrée ou la réponse LLM avec ancrage associée.

Conditions requises pour l'affichage

  • Affichez le point d'entrée exactement tel qu'il est fourni, et n'apportez aucune modification aux couleurs, aux polices ni à l'apparence. Assurez-vous que le point d'entrée s'affiche comme spécifié dans les exemples ci-dessous, y compris pour les modes clair et sombre :
  • Chaque fois qu'une réponse avec ancrage est affichée, son point d'entrée dans la recherche Google doit rester visible.
  • Marque : vous devez strictement respecter les Consignes de Google concernant l'utilisation par les tiers des Caractéristiques de la marque Google.
  • Les points d'entrée de recherche Google doivent se trouver au moins sur la largeur totale de la réponse ancrée.

Comportement au moment du clic

Lorsqu'un utilisateur appuie sur le chip, il est directement redirigé vers une page de résultats de recherche Google (SRP) pour le terme de recherche affiché dans le chip. Le SRP peut s'ouvrir dans votre navigateur intégré ou dans une application de navigateur distincte. Il est important de ne pas minimiser, supprimer ni masquer l'affichage du SRP. L'exemple animé suivant illustre l'interaction de type "tap-to-SRP" (clic vers SRP).

Exemple pour les applications/ordinateurs de bureau

Code permettant de mettre en œuvre un point d'entrée de recherche Google

Lorsque vous utilisez l'API pour ancrer une réponse sur la recherche, la réponse du modèle fournit un style HTML et CSS conforme dans le champ renderedContent que vous implémentez pour afficher les points d'entrée de la recherche dans votre application. Pour voir un exemple de réponse de l'API, consultez la section dédiée dans la section Ancrage avec la recherche Google.

Étapes suivantes