Utilizza il punto di ingresso della Ricerca Google

Utilizzare i punti di ingresso della Ricerca Google

Per utilizzare i punti di ingresso della Ricerca Google, devi visualizzare un punto di ingresso basato sulla query di ricerca inclusa nei metadati della risposta basata su base. La risposta include:

  • "content": risposta generata tramite LLM.
  • "searchQuery": la query da utilizzare per il punto di ingresso della Ricerca Google.

Ad esempio, nel seguente snippet di codice, Gemini risponde a un prompt basato su terra della Ricerca Google che chiede informazioni su un tipo di pianta tropicale.

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

Puoi visualizzare questo output utilizzando i punti di ingresso della Ricerca Google.

Requisiti per i punti di ingresso della Ricerca Google

Cosa fare:

  • Visualizza il punto di ingresso esattamente come fornito senza alcuna modifica e rispettando i Requisiti di visualizzazione riportati di seguito.
  • Indirizza gli utenti direttamente alla pagina dei risultati della Ricerca Google (SRP) quando interagiscono con il punto di ingresso.

Cosa non fare:

  • Includi eventuali schermate interstitial o passaggi aggiuntivi tra il tocco dell'utente e la visualizzazione della scheda SRP
  • Visualizza qualsiasi altro risultato di ricerca o suggerimento insieme al punto di ingresso o alla risposta LLM associata.

Requisiti del display

  • Visualizza il punto di ingresso esattamente come fornito e non apportare modifiche a colori, caratteri o aspetto. Assicurati che il punto di ingresso venga eseguito come specificato nei seguenti simulazioni, inclusa la modalità Luce e Buio:
  • Ogni volta che viene mostrata una risposta con dati empirici reali, il punto di ingresso della Ricerca Google corrispondente deve rimanere visibile.
  • Branding: devi seguire rigorosamente le linee guida di Google relative all'utilizzo degli elementi distintivi del brand Google da parte di terze parti
  • I punti di ingresso della Ricerca Google devono avere una larghezza minima pari all'intera larghezza della risposta basata su terra.

Comportamento al tocco

Quando un utente tocca il chip, viene indirizzato direttamente a una pagina dei risultati della Ricerca Google (SRP) relativa al termine di ricerca visualizzato nel chip. L'SRP può aprirsi all'interno del browser in-app o in un'app del browser separata. È importante non ridurre al minimo, rimuovere o ostruire in alcun modo la visualizzazione dell'SRP. La seguente simulazione animata illustra l'interazione tocco-SRP.

esempio per app/computer

Codice per implementare un punto di ingresso della Ricerca Google

Quando utilizzi l'API per fondare una risposta alla ricerca, la risposta del modello fornisce stili HTML e CSS conformi nel campo renderedContent che implementi per visualizzare i punti di ingresso della ricerca nella tua applicazione. Per visualizzare un esempio di risposta dell'API, consulta la sezione relativa alle risposte in Grounding con la Ricerca Google.

Passaggi successivi