Utiliser les suggestions de recherche Google

Lorsque vous utilisez l'ancrage avec la recherche Google et que vous recevez des suggestions de recherche dans votre réponse, vous devez les afficher en production et dans vos applications.

Pour en savoir plus sur l'ancrage avec la recherche Google, consultez Ancrage avec la recherche Google.

Plus précisément, vous devez afficher les requêtes de recherche incluses 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.
  • "webSearchQueries": requêtes à utiliser pour les suggestions de recherche.

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 suggestions de recherche.

Conditions requises pour les suggestions de recherche

Voici les exigences concernant les suggestions:

Exigence Description
À faire
  • Tout en respectant les exigences d'affichage, la suggestion de recherche est affichée exactement telle qu'elle est fournie, sans aucune modification.
  • Lorsque vous interagissez avec la suggestion de recherche, vous êtes directement redirigé vers la page de résultats de recherche (SRP).
Ce qu'il ne faut pas faire
  • Inclure tous les écrans 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 à côté de la suggestion de recherche ou de la réponse LLM avec ancrage associée.

Conditions requises pour l'affichage

Voici les exigences concernant l'affichage:

  • Affichez la suggestion de recherche exactement telle qu'elle est fournie, et n'apportez aucune modification aux couleurs, aux polices ni à l'apparence. Assurez-vous que les suggestions de recherche s'affichent comme spécifié dans les exemples suivants, y compris pour les modes clair et sombre:

  • Chaque fois qu'une réponse avec ancrage est affichée, sa suggestion de recherche correspondante doit rester visible.
  • Pour la marque, vous devez strictement respecter les consignes de Google concernant l'utilisation par les tiers des caractéristiques de la marque Google, disponibles sur la page Bienvenue dans notre centre de ressources sur la marque.
  • Lorsque vous utilisez l'ancrage avec la recherche, les chips de suggestion de recherche s'affichent. Le champ contenant les chips de suggestion doit avoir la même largeur que la réponse ancrée du LLM.

Comportement au moment du clic

Lorsqu'un utilisateur appuie sur le chip, il est directement redirigé vers une page de résultats de recherche (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 d'implémenter une suggestion de recherche

Lorsque vous utilisez l'API pour ancrer une réponse à 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 suggestions de recherche dans votre application. Pour voir un exemple de réponse de l'API, consultez la section "Réponse" de l'article Ancrage avec la recherche.

Étape suivante