Utiliser les suggestions de recherche Google

Lorsque vous utilisez l'ancrage avec la recherche Google et que vous recevez des suggestions de recherche Google dans votre réponse, vous devez afficher les suggestions de recherche 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 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 suggestions de recherche Google.

Conditions requises pour les suggestions de recherche Google

À faire :

  • Afficher la suggestion de recherche exactement telle qu'elle est fournie, 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 suggestion de recherche.

À 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 la suggestion de recherche ou la réponse LLM avec ancrage associée.

Conditions requises pour 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 ci-dessous, y compris pour les modes clair et sombre :
  • Chaque fois qu'une réponse avec ancrage est affichée, sa suggestion de recherche Google correspondante 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 suggestions 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 d'implémenter une suggestion de recherche Google

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 Google.

Étapes suivantes