Grounding con la Ricerca Google

Questa pagina spiega come basare le risposte di Gemini sui risultati del motore di ricerca di Google, che utilizza dati web disponibili pubblicamente. Inoltre, vengono spiegati i suggerimenti di ricerca, che sono inclusi nelle risposte.

Se vuoi collegare il tuo modello alle conoscenze del mondo, a un'ampia gamma possibile di argomenti o a informazioni aggiornate su internet, utilizza il grounding con la Ricerca Google.

Per scoprire di più sul grounding dei modelli in Gemini Enterprise Agent Platform, consulta la panoramica del grounding.

Modelli supportati

Questa sezione elenca i modelli che supportano il grounding con la Ricerca.

Fai clic per espandere i modelli supportati

Lingue supportate

Per un elenco delle lingue supportate, consulta Lingue.

Segui le istruzioni riportate di seguito per basare un modello su dati web disponibili pubblicamente.

Considerazioni

  • Per utilizzare il grounding con la Ricerca Google, devi attivare i suggerimenti di ricerca. Per saperne di più, consulta Utilizza i suggerimenti di ricerca Google.

  • Per risultati ottimali, utilizza una temperatura di 1.0. Per scoprire di più sull'impostazione di questa configurazione, consulta il corpo della richiesta dell'API Gemini nel riferimento del modello.

  • Il grounding con la Ricerca Google ha un limite di un milione di prompt di grounding al giorno. Se hai bisogno di altri prompt di grounding, contatta l'assistenzaGoogle Cloud per ricevere aiuto.

  • Combinazioni di strumenti: l'API Gemini non supporta la combinazione di strumenti di ricerca (come googleSearch) con strumenti non di ricerca (come la chiamata di funzione o lo strumento RAG Engine retrieval di Gemini Enterprise Agent Platform) nella stessa richiesta generateContent. L'utilizzo di più strumenti è supportato solo se sono tutti strumenti di ricerca.

I risultati di ricerca possono essere personalizzati per una posizione geografica specifica dell'utente finale utilizzando le coordinate di latitudine e longitudine. Per saperne di più, consulta l'API Grounding.

Console

Per utilizzare il grounding con la Ricerca Google con Agent Studio sulla piattaforma agentica Gemini Enterprise, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Agent Studio.

    Vai ad Agent Studio

  2. Nel riquadro laterale, in Impostazioni del modello, vai alla sezione Grounding e attiva l'opzione Ricerca Google.
  3. Inserisci il prompt nel campo e fai clic su Invia.

Le risposte ai tuoi prompt ora utilizzano il grounding con la Ricerca Google.

Python

Installa

pip install --upgrade google-genai

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Google Gen AI con Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

from google import genai
from google.genai.types import (
    GenerateContentConfig,
    GoogleSearch,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="When is the next total solar eclipse in the United States?",
    config=GenerateContentConfig(
        tools=[
            # Use Google Search Tool
            Tool(
                google_search=GoogleSearch(
                    # Optional: Domains to exclude from results
                    exclude_domains=["domain.com", "domain2.com"]
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# 'The next total solar eclipse in the United States will occur on ...'

Go

Scopri come installare o aggiornare l'Go.

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Google Gen AI con Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

import (
	"context"
	"fmt"
	"io"

	genai "google.golang.org/genai"
)

// generateWithGoogleSearch shows how to generate text using Google Search.
func generateWithGoogleSearch(w io.Writer) error {
	ctx := context.Background()

	client, err := genai.NewClient(ctx, &genai.ClientConfig{
		HTTPOptions: genai.HTTPOptions{APIVersion: "v1"},
	})
	if err != nil {
		return fmt.Errorf("failed to create genai client: %w", err)
	}

	modelName := "gemini-2.5-flash"
	contents := []*genai.Content{
		{Parts: []*genai.Part{
			{Text: "When is the next total solar eclipse in the United States?"},
		},
			Role: genai.RoleUser},
	}
	config := &genai.GenerateContentConfig{
		Tools: []*genai.Tool{
			{GoogleSearch: &genai.GoogleSearch{ExcludeDomains: []string{"example.com", "example.org"}}},
		},
	}

	resp, err := client.Models.GenerateContent(ctx, modelName, contents, config)
	if err != nil {
		return fmt.Errorf("failed to generate content: %w", err)
	}

	respText := resp.Text()

	fmt.Fprintln(w, respText)

	// Example response:
	// The next total solar eclipse in the United States will occur on March 30, 2033, but it will only ...

	return nil
}

Java

Scopri come installare o aggiornare l'Java.

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Google Gen AI con Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 


import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.GoogleSearch;
import com.google.genai.types.HttpOptions;
import com.google.genai.types.Tool;

public class ToolsGoogleSearchWithText {

  public static void main(String[] args) {
    // TODO(developer): Replace these variables before running the sample.
    String modelId = "gemini-2.5-flash";
    generateContent(modelId);
  }

  // Generates content with Google Search tool
  public static String generateContent(String modelId) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (Client client =
        Client.builder()
            .location("global")
            .vertexAI(true)
            .httpOptions(HttpOptions.builder().apiVersion("v1").build())
            .build()) {

      // Create a GenerateContentConfig and set Google Search tool
      GenerateContentConfig contentConfig =
          GenerateContentConfig.builder()
              .tools(Tool.builder().googleSearch(GoogleSearch.builder().build()).build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              modelId, "When is the next total solar eclipse in the United States?", contentConfig);

      System.out.print(response.text());
      // Example response:
      // The next total solar eclipse in the United States will occur on...
      return response.text();
    }
  }
}

Node.js

Installa

npm install @google/genai

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Google Gen AI con Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

const {GoogleGenAI} = require('@google/genai');

const GOOGLE_CLOUD_PROJECT = process.env.GOOGLE_CLOUD_PROJECT;
const GOOGLE_CLOUD_LOCATION = process.env.GOOGLE_CLOUD_LOCATION || 'global';

async function generateGoogleSearch(
  projectId = GOOGLE_CLOUD_PROJECT,
  location = GOOGLE_CLOUD_LOCATION
) {
  const client = new GoogleGenAI({
    vertexai: true,
    project: projectId,
    location: location,
  });

  const response = await client.models.generateContent({
    model: 'gemini-2.5-flash',
    contents: 'When is the next total solar eclipse in the United States?',
    config: {
      tools: [
        {
          googleSearch: {},
        },
      ],
    },
  });

  console.log(response.text);

  // Example response:
  //    'The next total solar eclipse in United States will occur on ...'

  return response.text;
}

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • LOCATION: la regione in cui elaborare la richiesta. Per utilizzare l'endpoint globale, escludi la località dal nome dell'endpoint e configura la località della risorsa su globale.
  • PROJECT_ID: il tuo ID progetto. .
  • MODEL_ID: l'ID modello del modello multimodale.
  • TEXT: le istruzioni di testo da includere nel prompt.
  • EXCLUDE_DOMAINS: (facoltativo) elenco di domini che non devono essere utilizzati per il grounding.
  • LATITUDE: (Facoltativo) la latitudine della posizione dell'utente finale. Ad esempio, una latitudine di 37.7749 rappresenta San Francisco. Puoi ottenere le coordinate di latitudine e longitudine utilizzando servizi come Google Maps o altri strumenti di geocodifica.
  • LONGITUDE: (Facoltativo) la longitudine della posizione dell'utente finale. Ad esempio, una longitudine di -122.4194 rappresenta San Francisco.

Metodo HTTP e URL: 

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Corpo JSON della richiesta: 

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "googleSearch": {
      "exclude_domains": [ "domain.com", "domain2.com" ]
    }
  }],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      }
    }
  },
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The weather in Chicago this weekend, will be partly cloudy. The temperature will be between 49°F (9°C) and 55°F (13°C) on Saturday and between 51°F (11°C) and 56°F (13°C) on Sunday. There is a slight chance of rain on both days.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "weather in Chicago this weekend"
        ],
        "searchEntryPoint": {
          "renderedContent": "..."
        },
        "groundingChunks": [
          {
            "web": {
              "uri": "https://www.google.com/search?q=weather+in+Chicago,+IL",
              "title": "Weather information for locality: Chicago, administrative_area: IL",
              "domain": "google.com"
            }
          },
          {
            "web": {
              "uri": "...",
              "title": "weatherbug.com",
              "domain": "weatherbug.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "startIndex": 85,
              "endIndex": 214,
              "text": "The temperature will be between 49°F (9°C) and 55°F (13°C) on Saturday and between 51°F (11°C) and 56°F (13°C) on Sunday."
            },
            "groundingChunkIndices": [
              0
            ],
            "confidenceScores": [
              0.8662828
            ]
          },
          {
            "segment": {
              "startIndex": 215,
              "endIndex": 261,
              "text": "There is a slight chance of rain on both days."
            },
            "groundingChunkIndices": [
              1,
              0
            ],
            "confidenceScores": [
              0.62836814,
              0.6488607
            ]
          }
        ],
        "retrievalMetadata": {}
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 98,
    "totalTokenCount": 108,
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 10
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 98
      }
    ]
  },
  "modelVersion": "gemini-2.0-flash",
  "createTime": "2025-05-19T14:42:55.000643Z",
  "responseId": "b0MraIMFoqnf-Q-D66G4BQ"
}

La fondatezza con Google Immagini consente ai modelli di utilizzare le immagini web recuperate da Google Immagini come contesto visivo durante la generazione di immagini. La ricerca di Google Immagini è un nuovo tipo di ricerca all'interno dello strumento di grounding con la Ricerca Google esistente e si affianca alla Ricerca Google standard. Il grounding con la Ricerca Google Immagini è disponibile in Anteprima per Gemini Nano Banana 2.1 e Gemini 3.1 Flash Image.

Configurazione della richiesta API

Per attivare la Ricerca Google Immagini, configura lo strumento googleSearch nella richiesta API e specifica imageSearch all'interno dell'oggetto searchTypes. Puoi utilizzare Google Immagini in modo indipendente o con la Ricerca Google.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • LOCATION: la regione in cui elaborare la richiesta. Per utilizzare l' endpoint globale, escludi la località dal nome dell'endpoint e configura la località della risorsa su globale.
  • PROJECT_ID: .
  • MODEL_ID: l'ID modello del modello multimodale.
  • SEARCH_TERM: un termine di ricerca per un'immagine.

    • Metodo HTTP e URL: 

    POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

    Corpo JSON della richiesta: 

    {
  "contents": [
    {
      "role": "user",
      "parts": [
        {
        "text": "SEARCH_TERM"
        }
      ]
    }
  ],
  "tools": [
    {
      "googleSearch": {
        "searchTypes": {
          "imageSearch": {},
          "webSearch": {}
        }
      }
    }
  ],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

    Per inviare la richiesta, scegli una di queste opzioni:

    curl

    Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

    PowerShell

    Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

    Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Requisiti di visualizzazione

Quando utilizzi la Ricerca Google Immagini con il grounding con la Ricerca Google, devi rispettare le seguenti condizioni:

  • Attribuzione della fonte: devi fornire un link alla pagina web che contiene l'immagine di origine (la "pagina contenitore", non il file immagine stesso) in modo che l'utente lo riconosca come link.

  • Navigazione diretta: se scegli di mostrare anche le immagini di origine, devi fornire un percorso diretto con un solo clic dalle immagini di origine alla pagina web di origine che le contiene. Qualsiasi altra implementazione che ritardi o astragga l'accesso degli utenti finali alle pagine web di origine, inclusi, a titolo esemplificativo, qualsiasi percorso con più clic o l'utilizzo di un visualizzatore di immagini intermedio, non è consentita.

Risposta

Per le risposte con grounding che utilizzano la ricerca di immagini, l'API fornisce un'attribuzione chiara e metadati per collegare l'output a fonti verificate. L'oggetto groundingMetadata include i seguenti campi:

  • imageSearchQueries: le query specifiche utilizzate dal modello per il contesto visivo (noto anche come "ricerca immagini").

  • groundingChunks: contiene le informazioni sull'origine dei risultati recuperati. Per le origini immagini, questi vengono restituiti come URL di reindirizzamento utilizzando un tipo di chunk image. Ogni chunk include i seguenti campi all'interno di un oggetto image:

    • sourceUri: l'URL della pagina web per l'attribuzione (noto anche come "pagina di destinazione").
    • imageUri: l'URL diretto dell'immagine.
    • title: il titolo della pagina web di origine.
    • domain: il dominio della pagina web di origine.

  • groundingSupports: fornisce mappature specifiche che collegano i contenuti generati alla fonte di citazione pertinente nei chunk.

  • searchEntryPoint: include il chip della Ricerca Google che contiene HTML e CSS conformi per eseguire il rendering dei suggerimenti di ricerca di Google.

L'esempio seguente mostra la struttura groundingMetadata in una risposta:

{
  "groundingMetadata": {
    "groundingChunks": [
      {
        "image": {
          "sourceUri": "EXAMPLE_SOURCE_URI",
          "imageUri": "EXAMPLE_IMAGE_URI",
          "title": "Example source title",
          "domain": "example.com"
        }
      }
    ],
    "imageSearchQueries": [
      "example search query"
    ]
  }
}

Comprendi la risposta

Se il prompt del modello utilizza correttamente il grounding con la Ricerca Google da Agent Studio o dall'API, le risposte includono metadati con link alle fonti (URL web). Tuttavia, esistono diversi motivi per cui questi metadati potrebbero non essere forniti e la risposta al prompt non sarà basata su dati. Questi motivi includono una bassa pertinenza della fonte o informazioni incomplete nella risposta del modello.

Citazioni in linea

Le citazioni in linea utilizzano l'oggetto grounding_metadata strutturato restituito dall'API per collegare segmenti specifici di testo generato a fonti verificabili.

Questa funzionalità supporta tutti i metodi di grounding, tra cui la Ricerca, Google Maps e la ricerca degli agenti, fornendo i dettagli precisi della fonte necessari per visualizzare citazioni accurate e interattive all'interno della tua applicazione.

response = client.models.generate_content(
   model="gemini-3.5-flash",
   contents="Where will the next FIFA World Cup be held?",
   config=types.GenerateContentConfig(
       tools=[types.Tool(google_search=types.GoogleSearch())],
   ),
)

display(Markdown(response.text))
print(response.candidates[0].grounding_metadata.grounding_chunks)
display(HTML(response.candidates[0].grounding_metadata.search_entry_point.rendered_content))

Output di esempio:

…

Citations:
Wikipedia. "2026 FIFA World Cup." Retrieved February 11, 2026. (https://en.wikipedia.org/wiki/2026_FIFA_World_Cup)
US Soccer Players. "2026 FIFA World Cup FAQ — Dates, Hosts, Tickets, Teams & More." (https://ussoccerplayers.com/2026-fifa-world-cup-faq)
Holafly. "2026 World Cup host cities and countries: Full list of stadiums." (https://travel.holafly.com/esims/2026-world-cup-host-cities/)
…

Supporto per il grounding

La visualizzazione delle fonti di grounding è obbligatoria, perché ti aiuta a convalidare le risposte dei publisher e aggiunge canali per un ulteriore apprendimento.

Il supporto della base di dati per le risposte provenienti da fonti web deve essere mostrato sia in linea che in forma aggregata. Ad esempio, guarda l'immagine seguente per un suggerimento su come procedere.

Esempi di supporto del grounding

Utilizzo di opzioni di motori di ricerca alternativi

Quando utilizza il grounding con la Ricerca Google, un'Applicazione del Cliente può:

  • Offrire opzioni di motori di ricerca alternativi.
  • Impostare altri motori di ricerca come opzione predefinita.
  • Visualizzare i propri suggerimenti di ricerca o risultati di ricerca o quelli di terze parti, a condizione che: tutti i risultati non Google vengano visualizzati separatamente dai Risultati fondati e dai Suggerimenti di ricerca di Google e in modo da non confondere gli utenti o suggerire che provengano da Google.

Vantaggi

I seguenti prompt e flussi di lavoro complessi che richiedono pianificazione, ragionamento e riflessione possono essere eseguiti quando utilizzi il grounding con la Ricerca Google come strumento:

  • Puoi eseguire il grounding per assicurarti che le risposte si basino sulle informazioni più recenti e accurate.
  • Puoi recuperare gli artefatti dal web per eseguire l'analisi.
  • Puoi trovare immagini, video o altri contenuti multimediali pertinenti per facilitare il ragionamento multimodale o la generazione di attività.
  • Puoi eseguire attività di programmazione, risoluzione dei problemi tecnici e altre attività specializzate.
  • Puoi trovare informazioni specifiche per regione o contribuire a tradurre i contenuti in modo accurato.
  • Puoi trovare siti web pertinenti per la navigazione.

Utilizza i suggerimenti di Ricerca Google

Quando utilizzi il grounding con la Ricerca Google e ricevi suggerimenti di ricerca nella risposta, devi visualizzare i suggerimenti di ricerca in produzione e nelle tue applicazioni.

In particolare, devi mostrare le query di ricerca incluse nei metadati della risposta con grounding. La risposta include:

  • "content": risposta generata dall'LLM.
  • "webSearchQueries": le query da utilizzare per i suggerimenti di ricerca.

Ad esempio, nello snippet di codice seguente, Gemini risponde a un prompt basato sulla Ricerca 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 prendere questo output e visualizzarlo utilizzando i suggerimenti di ricerca.

Requisiti per i suggerimenti di ricerca

Per i suggerimenti di ricerca è necessario quanto segue:

Requisito Descrizione
Cosa fare
  • Pur rispettando i requisiti di visualizzazione, il suggerimento di ricerca viene visualizzato esattamente come fornito, senza modifiche.
  • Quando interagisci con il suggerimento di ricerca, vieni reindirizzato direttamente alla pagina dei risultati di ricerca (SRP).
Cosa non fare
  • Includi eventuali schermate o passaggi aggiuntivi tra il tocco dell'utente e la visualizzazione dell'SRP.
  • Visualizzare altri risultati o suggerimenti di ricerca accanto al suggerimento di ricerca o alla risposta LLM fondata associata.

Requisiti di visualizzazione

Di seguito sono riportati i requisiti di visualizzazione:

  • Mostra il suggerimento di ricerca esattamente come fornito e non apportare modifiche a colori, caratteri o aspetto. Assicurati che il suggerimento di ricerca venga visualizzato come specificato nei seguenti mock, ad esempio in modalità Luce e Buio:

  • Ogni volta che viene mostrata una risposta con grounding, il suggerimento di ricerca corrispondente deve rimanere visibile.
  • Per il branding, devi seguire rigorosamente le linee guida di Google per l'utilizzo degli elementi distintivi del brand Google da parte di terze parti disponibili nel Centro risorse per il brand.
  • Quando utilizzi il grounding con la Ricerca, vengono visualizzati i chip dei suggerimenti di ricerca. Il campo che contiene i chip dei suggerimenti di ricerca deve avere la stessa larghezza della risposta fondata dell'LLM.

Comportamento al tocco

Quando un utente tocca il chip, viene indirizzato direttamente a una pagina dei risultati di ricerca (SRP) per il termine di ricerca visualizzato nel chip. La pagina dei risultati di ricerca può aprirsi nel browser in-app o in un'applicazione browser separata. È importante non ridurre a icona, rimuovere o ostruire in alcun modo la visualizzazione della SRP. Il seguente mockup animato illustra l'interazione con la pagina dei risultati di ricerca.

Comportamento al tocco

Esempio di app/desktop

Codice per implementare un suggerimento di ricerca

Quando utilizzi l'API per basare una risposta sulla ricerca, la risposta del modello fornisce uno stile HTML e CSS conforme nel campo renderedContent, che implementi per visualizzare i suggerimenti di ricerca nella tua applicazione.

Inoltre, i Suggerimenti di ricerca erano precedentemente denominati Punti di inserimento ricerca. Anche se in alcuni campi dell'API potresti trovare riferimenti ai punti di accesso alla ricerca, entrambi i termini si riferiscono ai suggerimenti di ricerca attuali che ricevi nella risposta dell'API.

Di seguito è riportato un esempio di utilizzo di curl per basare una risposta sulla ricerca:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.5-flash:generateContent -d '{
    "contents": {
      "role": "user",
      "parts": {
        "text": "Why is the sky blue?"
      }
    },
    "tools": [
      {
        "googleSearch": {}
      }
    ]
  }'

Modifiche alla fatturazione con Gemini 3

Quando utilizzi il grounding con la Ricerca Google sui modelli Gemini 3, la fatturazione avviene per ogni query di ricerca generata da Gemini e inviata alla Ricerca. Un singolo prompt potrebbe generare una o più query di ricerca.

Esempio

Questo esempio mostra un prompt dell'utente e query di ricerca di esempio che potrebbero essere addebitate.

  • Prompt dell'utente: Parlami della vita di Albert Einstein.
  • Gemini potrebbe generare queste query di ricerca:
    • Nascita e prima infanzia di Albert Einstein
    • Teoria della relatività di Albert Einstein
    • Albert Einstein vita negli Stati Uniti

In questo esempio, vengono addebitate queste tre query di ricerca.

Passaggi successivi