Usa il punto di accesso della Ricerca Google

Utilizzo dei punti di contatto della Ricerca Google

Per utilizzare i punti di ingresso della Ricerca Google, devi visualizzare un punto di ingresso in base alla query di ricerca inclusa nei metadati della risposta con grounding. La risposta include:

  • "content": risposta generata dall'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 sulla Ricerca Google che riguarda 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 e visualizzarlo utilizzando i punti di contatto della Ricerca Google.

Requisiti per i punti di ingresso della Ricerca Google

Azione consigliata:

  • Visualizza il punto di ingresso esattamente come fornito senza alcuna modifica, rispettando i requisiti di visualizzazione riportati di seguito.
  • Porta gli utenti direttamente alla pagina dei risultati della Ricerca Google quando interagiscono con il punto di accesso.

Azione sconsigliata:

  • Includi schermate interstitial o passaggi aggiuntivi tra il tocco dell'utente e la visualizzazione dell'SRP
  • Visualizza altri risultati di ricerca o suggerimenti insieme al punto di ingresso o alla risposta LLM con grounding associata.

Requisiti del display

  • Visualizza il punto di accesso esattamente come fornito e non apportare modifiche a colori, caratteri o aspetto. Assicurati che il punto di ingresso venga visualizzato come specificato nei seguenti simulazioni, tra cui per la modalità Luce e Buio:
  • Ogni volta che viene mostrata una risposta con grounding, il relativo punto di contatto della Ricerca Google deve rimanere visibile.
  • Branding: devi rispettare 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 occupare almeno la larghezza massima della risposta con grounding.

Comportamento al tocco

Quando un utente tocca il chip, viene indirizzato direttamente a una pagina dei risultati della Ricerca Google (SRP) per il termine di ricerca visualizzato nel chip. L'SRP può aprirsi all'interno del browser in-app o in un'app browser separata. È importante non ridurre a icona, rimuovere o ostacolare in alcun modo il display dell'SRP. Il seguente modello animato illustra l'interazione tocco per SRP.

esempio di app/desktop

Codice per implementare un punto di ingresso della Ricerca Google

Quando utilizzi l'API per stabilire una risposta alla ricerca, la risposta del modello fornisce stili HTML e CSS conformi nel campo renderedContent, che implementi per visualizzare gli entry point di ricerca nella tua applicazione. Per un esempio di risposta dell'API, consulta la sezione sulla risposta in Informazioni sulla Ricerca Google.

Passaggi successivi