Riferimento API XML

Questa pagina si riferisce alla versione XML dell'API Custom Search JSON, disponibile solo per i clienti di Ricerca su sito Google.

  1. Panoramica
  2. Formato della richiesta del Motore di ricerca programmabile
    1. Panoramica delle richieste
    2. Termini di query
    3. Parametri di richiesta
      1. Query di ricerca web di esempio
      2. Definizioni dei parametri di query di WebSearch
      3. Ricerca avanzata
      4. Parametri di query di ricerca avanzata
      5. Termini di query speciali
      6. Query di esempio per le immagini
      7. Parametri di query della ricerca di immagini
      8. Limiti per le richieste
    4. Internazionalizzazione delle query e della presentazione dei risultati
      1. Codifica dei caratteri
      2. Lingue dell'interfaccia
      3. Ricerca in cinese semplificato e tradizionale
    5. Filtrare i risultati
      1. Filtro automatico dei risultati di ricerca
      2. Filtro per lingua e paese
      3. Filtrare i contenuti per adulti con SafeSearch
  3. Risultati XML
    1. DTD dei risultati XML di Google
    2. Informazioni sulla risposta XML
    3. Risultati XML per query di ricerca regolari, di immagini e avanzate
      1. Ricerca normale/avanzata: query di esempio e risultato XML
      2. Ricerca normale/avanzata: tag XML
      3. Risultati XML per le query di ricerca di immagini
      4. Ricerca di immagini: query di esempio e risultato XML
      5. Ricerca di immagini: tag XML

Panoramica

Il servizio Google WebSearch consente ai clienti di Ricerca su sito di Google di visualizzare i risultati di ricerca di Google sui propri siti web. Il servizio WebSearch utilizza un semplice protocollo basato su HTTP per pubblicare i risultati di ricerca. Gli amministratori della ricerca hanno il controllo completo sul modo in cui richiedono i risultati di ricerca e sul modo in cui li presentano all'utente finale. Questo documento descrive i dettagli tecnici dei formati della richiesta di ricerca e dei risultati di Google.

Per recuperare i risultati della Ricerca Google, la tua applicazione invia a Google una semplice richiesta HTTP. Google restituisce quindi i risultati di ricerca in formato XML. I risultati in formato XML ti consentono di personalizzare la modalità di visualizzazione dei risultati di ricerca.

Formato della richiesta WebSearch

Panoramica richiesta

La richiesta di ricerca Google è un comando HTTP GET standard. Include una raccolta di parametri pertinenti per le tue query. Questi parametri sono inclusi nell'URL della richiesta come coppie nome=valore separate da e commerciali (&). I parametri includono dati come la query di ricerca e un ID motore univoco (cx) che identifica il motore che effettua la richiesta HTTP. Il servizio Ricerca web o Ricerca immagini restituisce risultati XML in risposta alle tue richieste HTTP.

Termini di ricerca

La maggior parte delle richieste di ricerca include uno o più termini di query. Un termine di ricerca viene visualizzato come valore di un parametro nella richiesta di ricerca.

I termini di query possono specificare diversi tipi di informazioni per filtrare e organizzare i risultati di ricerca restituiti da Google. Le query possono specificare:

  • Parole o frasi da includere o escludere
    • Tutte le parole in una query di ricerca (opzione predefinita)
    • Una frase esatta nella query di ricerca
    • Qualsiasi parola o frase in una query di ricerca
  • Dove in un documento cercare i termini di ricerca
    • In un punto qualsiasi del documento (opzione predefinita)
    • Solo nei link del documento
  • Limitazioni relative ai documenti stessi
    • Includere o escludere documenti di determinati tipi di file (ad esempio file PDF o documenti Word)
  • Query URL speciali che restituiscono informazioni su un determinato URL, anziché eseguire una ricerca
    • Query che restituiscono informazioni generali su un URL, ad esempio la categoria, lo snippet o la lingua di Open Directory
    • Query che restituiscono l'insieme di pagine web che rimandano a un URL
    • Query che restituiscono un insieme di pagine web simili a un determinato URL

Ricerca predefinita

I valori dei parametri di query di ricerca devono essere sottoposti all'escape dell'URL. Tieni presente che devi sostituire il segno più ("+") con qualsiasi sequenza di spazi bianchi nella query di ricerca. Questo argomento è trattato più nel dettaglio nella sezione Escape dell'URL di questo documento.

Il termine della query di ricerca viene inviato al servizio WebSearch utilizzando il parametro q. Un esempio di termine di query di ricerca è:

q=horses+cows+pigs

Per impostazione predefinita, il servizio Ricerca Google restituisce solo i documenti che includono tutti i termini nella query di ricerca.

Parametri di richiesta

Questa sezione elenca i parametri che puoi utilizzare quando effettui una richiesta di ricerca. I parametri sono suddivisi in due elenchi. Il primo elenco contiene parametri pertinenti a tutte le richieste di ricerca. Il secondo elenco contiene parametri che sono pertinenti solo per le richieste di ricerca avanzata.

Sono necessari tre parametri della richiesta:

  • Il parametro client deve essere impostato su google-csbe.
  • Il parametro output specifica il formato dei risultati XML restituiti; i risultati possono essere restituiti con (xml) o senza (xml_no_dtd) un riferimento al DTD di Google. Ti consigliamo di impostare questo valore su xml_no_dtd. Nota: se non specifichi questo parametro, i risultati verranno restituiti in HTML anziché in XML.
  • Il parametro cx che rappresenta l'ID univoco del motore.

I parametri di richiesta di uso comune diversi da quelli menzionati sopra sono:

  • num: il numero richiesto di risultati di ricerca
  • q: il termine o i termini di ricerca
  • start: l'indice iniziale per i risultati

Query WebSearch di esempio

Gli esempi riportati di seguito mostrano un paio di richieste HTTP WebSearch per illustrare come vengono utilizzati i diversi parametri di query. Le definizioni dei diversi parametri di query sono fornite nelle sezioni Definizioni dei parametri della query WebSearch e Parametri della query di ricerca avanzata di questo documento.

Questa richiesta chiede i primi 10 risultati (start=0&num=10) per il termine di ricerca "red sox" (q=red+sox). La query specifica anche che i risultati devono provenire da siti web canadesi (cr=countryCA) e devono essere scritti in francese (lr=lang_fr). Infine, la query specifica i valori per i parametri client, output e cx, tutti e tre obbligatori.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Questo esempio utilizza alcuni dei parametri di query di ricerca avanzata per personalizzare ulteriormente la query di ricerca. Questa richiesta utilizza il parametro as_q (as_q=red+sox) anziché il parametro q. Utilizza anche il parametro as_eq per escludere dai risultati di ricerca i documenti contenenti la parola "Yankees" (as_eq=yankees).

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Definizioni dei parametri di query di Ricerca Google

c2coff
Descrizione

Facoltativo. Il parametro c2coff attiva o disattiva la funzionalità Ricerca in cinese semplificato e tradizionale.

Il valore predefinito di questo parametro è 0 (zero), il che significa che la funzionalità è abilitata. I valori per il parametro c2coff sono:

Valore Azione
1 Disabilitato
0 Attivato
Esempi q=google&c2coff=1

client
Descrizione

Required. Il parametro client deve essere impostato su google-csbe.
Esempi q=google&client=google-csbe

cr
Descrizione

Facoltativo. Il parametro cr limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare operatori booleani nel valore del parametro cr.

La Ricerca Google determina il paese di un documento mediante l'analisi di quanto segue:

  • il dominio di primo livello (TLD) dell'URL del documento
  • la posizione geografica dell'indirizzo IP del server web

Consulta la sezione Valori del parametro Paese (cr) per un elenco dei valori validi per questo parametro.
Esempi q=Frodo&cr=countryNZ

cx
Descrizione

Required. Il parametro cx specifica un codice univoco che identifica un motore di ricerca personalizzato. Devi specificare un Motore di ricerca programmabile utilizzando il parametro cx per recuperare i risultati di ricerca da quel motore.

Per trovare il valore del parametro cx, vai a Pannello di controllo > scheda Codici del tuo motore e lo troverai nell'area di testo sotto "Incolla questo codice nella pagina in cui vuoi che venga visualizzata la casella di ricerca". I risultati di ricerca verranno visualizzati in una pagina ospitata da Google.
Esempi q=Frodo&cx=00255077836266642015:u-scht7a-8i

filtro
Descrizione

Facoltativo. Il parametro filter attiva o disattiva il filtro automatico dei risultati della Ricerca Google. Per saperne di più sui filtri dei risultati di ricerca di Google, consulta la sezione Filtro automatico di questo documento.

Il valore predefinito per il parametro filter è 1, che indica che la funzionalità è attivata. I valori validi per questo parametro sono:

Valore Azione
1 Disabilitato
0 Attivato

Nota:per impostazione predefinita, Google applica il filtro a tutti i risultati di ricerca per migliorarne la qualità.
Esempi q=google&filter=0

gl
Descrizione

Facoltativo. Il valore del parametro gl è un codice paese di due lettere. Per i risultati di Ricerca Google, il parametro gl aumenta i risultati di ricerca il cui paese di origine corrisponde al valore parametro. Per un elenco dei valori validi, consulta la sezione Codici paese.

Specificare un valore parametro gl nelle richieste WebSearch dovrebbe migliorare la pertinenza dei risultati. Ciò vale in particolare per i clienti internazionali e, ancora più nello specifico, per i clienti dei paesi anglofoni diversi dagli Stati Uniti.
Esempi

Questa richiesta aumenta la visibilità dei documenti scritti nel Regno Unito nei risultati della ricerca web:
q=pizza&gl=uk

hl
Descrizione

Facoltativo. Il parametro hl specifica la lingua dell'interfaccia (lingua host) dell'interfaccia utente. Per migliorare il rendimento e la qualità dei risultati di ricerca, ti consigliamo vivamente di impostare questo parametro in modo esplicito.

Per ulteriori informazioni, consulta la sezione Lingue dell'interfaccia di Internazionalizzazione delle query e presentazione dei risultati e Lingue dell'interfaccia supportate per un elenco delle lingue supportate.
Esempi

Questa richiesta ha come target gli annunci per il vino in francese. (Vin è il termine francese per vino.)

q=vin&ip=10.10.10.10&ad=w5&hl=fr

hq
Descrizione

Facoltativo. Il parametro hq aggiunge i termini di query specificati alla query, come se fossero combinati con un operatore logico AND.

Esempi

Questa richiesta cerca "pizza" E "formaggio". L'espressione è uguale a q=pizza+cheese.

q=pizza&hq=cheese

ie
Descrizione

Facoltativo. Il parametro ie imposta la codifica dei caratteri da utilizzare per interpretare la stringa di query. Il valore predefinito di ie è latin1.

Consulta la sezione Codifica dei caratteri per scoprire quando potrebbe essere necessario utilizzare questo parametro.

Consulta la sezione Schemi di codifica dei caratteri per l'elenco dei possibili valori di ie.
Esempi q=google&ie=utf8&oe=utf8
lr
Descrizione

Facoltativo. Il parametro lr (restrizione di lingua) limita i risultati di ricerca ai documenti scritti in una determinata lingua.

La Ricerca Google determina la lingua di un documento mediante l'analisi di quanto segue:

  • il dominio di primo livello (TLD) dell'URL del documento
  • i meta tag della lingua all'interno del documento
  • la lingua principale utilizzata nel corpo del testo del documento
  • le lingue secondarie, se presenti, utilizzate nel corpo del testo del documento

Per un elenco dei valori validi per questo parametro, consulta la sezione Valori della raccolta (lr).
Esempi q=Frodo&lr=lang_en

num
Descrizione

Facoltativo. Il parametro num identifica il numero di risultati di ricerca da restituire.

Il valore predefinito di num è 10 e il valore massimo è 20. Se richiedi più di 20 risultati, ne verranno restituiti solo 20.

Nota:se il numero totale di risultati di ricerca è inferiore al numero di risultati richiesto, verranno restituiti tutti i risultati di ricerca disponibili.
Esempi q=google&num=10

oe
Descrizione

Facoltativo. Il parametro oe imposta la codifica dei caratteri da utilizzare per decodificare il risultato XML. Il valore predefinito di oe è latin1.

Consulta la sezione Codifica dei caratteri per scoprire quando potrebbe essere necessario utilizzare questo parametro.

Consulta la sezione Schemi di codifica dei caratteri per l'elenco dei possibili valori di oe.
Esempi q=google&ie=utf8&oe=utf8

output
Descrizione

Required. Il parametro output specifica il formato dei risultati XML. Gli unici valori validi per questo parametro sono xml e xml_no_dtd. Il grafico seguente spiega in che modo questi valori dei parametri differiscono.

Valore Formato di output
xml_no_dtd I risultati XML non includeranno un'istruzione !DOCTYPE. (consigliato)
xml I risultati XML conterranno un riferimento DTD di Google. La seconda riga del risultato identifica il tipo di definizione del documento (DTD) utilizzato dai risultati: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
Esempi output=xml_no_dtd
output=xml

q
Descrizione

Facoltativo. Il parametro q specifica la query di ricerca inserita dall'utente. Anche se questo parametro è facoltativo, devi specificare un valore per almeno uno dei parametri di ricerca (as_epq, as_lq, as_oq, as_q) per ottenere risultati di ricerca.

Esistono anche diversi termini di query speciali che possono essere utilizzati come parte del valore del parametro q. Consulta i Termini di query speciali per un elenco e le definizioni di questi termini.

Il pannello di controllo della Ricerca Google include un report delle principali query inviate utilizzando il parametro q.

Nota:il valore specificato per il parametro q deve essere sottoposto all'escape dell'URL.
Esempi q=vacation&as_oq=london+paris

sicurezza
Descrizione

Facoltativo. Il parametro safe indica come devono essere filtrati i risultati di ricerca per i contenuti per adulti e pornografici. Il valore predefinito del parametro safe è off. I valori dei parametri validi sono:

Valore Azione
off Disattivare SafeSearch
medium Attivare SafeSearch
high Attivare una versione più restrittiva di SafeSearch

Per ulteriori dettagli su questa funzionalità, consulta la sezione Filtro dei contenuti per adulti con SafeSearch.
Esempi q=adult&safe=high

start
Descrizione

Facoltativo. Il parametro start indica il primo risultato corrispondente da includere nei risultati di ricerca. Il parametro start utilizza un indice basato su zero, il che significa che il primo risultato è 0, il secondo risultato è 1 e così via.

Il parametro start funziona in combinazione con il parametro num per determinare quali risultati di ricerca restituire. Tieni presente che per qualsiasi query non verranno mai restituiti più di 1000 risultati, anche se più di 1000 documenti corrispondono alla query, quindi l'impostazione di start su 1000 o più non produrrà risultati.
Esempi start=10

ordinare
Descrizione

Facoltativo. Il parametro sort specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data.
Esempi

sort=date

ud
Descrizione

Facoltativo. Il parametro ud indica se la risposta XML deve includere l'URL con codifica IDN per il risultato di ricerca. La codifica IDN (International Domain Name) consente di visualizzare i domini utilizzando le lingue locali, ad esempio:

http://www.花井鮨.com

I valori validi per questo parametro sono 1 (valore predefinito), il che significa che il risultato XML deve includere URL codificati IDN, e 0, il che significa che il risultato XML non deve includere URL codificati IDN. Se il parametro ud è impostato su 1, l'URL codificato IDN verrà visualizzato nel tag UD nei risultati XML.

Se il parametro ud è impostato su 0, l'URL nell'esempio precedente verrà visualizzato come:

http://www.xn--elq438j.com.

Nota:questa è una funzionalità beta.
Esempi q=google&ud=1

I parametri di ricerca aggiuntivi elencati sotto l'immagine sono pertinenti alle query di ricerca avanzata. Quando invii una ricerca avanzata, i valori di diversi parametri (ad es. as_eq, as_epq, as_oq e così via) vengono tutti presi in considerazione nei termini di query per quella ricerca. L'immagine mostra la pagina della Ricerca avanzata di Google. Nell'immagine, il nome di ogni parametro di ricerca avanzata è scritto in testo rosso all'interno o accanto al campo della pagina a cui corrisponde il parametro.



Parametri di ricerca avanzata

as_dt
Descrizione

Facoltativo. Il parametro as_dt controlla se includere o escludere i risultati del sito indicato nel parametro as_sitesearch. I valori i e e indicano rispettivamente inclusione ed esclusione.
Esempi as_dt=i,as_dt=e

as_epq
Descrizione

Facoltativo. Il parametro as_epq identifica una frase che tutti i documenti nei risultati di ricerca devono contenere. Puoi anche utilizzare il termine di query ricerca di frasi per cercare una frase.
Esempi as_epq=abraham+lincoln

as_eq
Descrizione

Facoltativo. Il parametro as_eq identifica una parola o una frase che non deve essere presente in nessun documento nei risultati di ricerca. Puoi anche utilizzare il termine di query escludi per assicurarti che una determinata parola o frase non venga visualizzata nei documenti di un insieme di risultati di ricerca.
Esempi

q=bass&as_eq=music.

as_lq
Descrizione

Facoltativo. Il parametro as_lq specifica che tutti i risultati di ricerca devono contenere un link a un determinato URL. Puoi anche utilizzare il termine di query link: per questo tipo di query.

Esempi

as_lq=www.google.com

as_nlo
Descrizione

Facoltativo. Il parametro as_nlo specifica il valore iniziale per un intervallo di ricerca. Utilizza as_nlo e as_nhi per aggiungere un intervallo di ricerca inclusivo di as_nlo...as_nhi alla query.

Esempi

Il seguente esempio imposta un intervallo di ricerca da 5 a 10 inclusi:

as_nlo=5&as_nhi=10
as_nhi
Descrizione

Facoltativo. Il parametro as_nhi specifica il valore finale di un intervallo di ricerca. Utilizza as_nlo e as_nhi per aggiungere alla query un intervallo di ricerca inclusivo di as_nlo...as_nhi.
Esempi

Il seguente esempio imposta un intervallo di ricerca da 5 a 10 inclusi:

as_nlo=5&as_nhi=10
as_oq
Descrizione

Facoltativo. Il parametro as_oq fornisce termini di ricerca aggiuntivi da controllare in un documento, in cui ogni documento nei risultati di ricerca deve contenere almeno uno dei termini di ricerca aggiuntivi. Puoi anche utilizzare il termine di query OR booleano per questo tipo di query.
Esempi

q=vacation&as_oq=London+Paris

as_q
Descrizione

Facoltativo. Il parametro as_q fornisce i termini di ricerca da controllare in un documento. Questo parametro è anche di uso comune per consentire agli utenti di specificare termini aggiuntivi da cercare all'interno di un insieme di risultati di ricerca.
Esempi

q=president&as_q=John+Adams

as_qdr
Descrizione

Facoltativo. Il parametro as_qdr richiede risultati di ricerca da un periodo di tempo specificato (intervallo di date rapido). Sono supportati i seguenti valori:

d[number] richiede i risultati del numero specificato di giorni precedenti.
w[number] richiede i risultati del numero specificato di settimane precedenti.
m[number] richiede i risultati del numero specificato di mesi precedenti.
y[number] richiede i risultati del numero specificato di anni precedenti.
Esempi

Questo esempio richiede i risultati dell'ultimo anno:

as_qdr=y

Questo esempio richiede i risultati degli ultimi 10 giorni:

as_qdr=d10
as_sitesearch
Descrizione

Facoltativo. Il parametro as_sitesearch ti consente di specificare che tutti i risultati di ricerca devono essere pagine di un determinato sito. Impostando il parametro as_dt, puoi anche utilizzarlo per escludere le pagine di un determinato sito dai risultati di ricerca.
Esempi

q=vacation&as_sitesearch=www.google.com

Termini di query speciali

La Ricerca Google consente l'utilizzo di diversi termini di ricerca speciali che accedono a funzionalità aggiuntive del motore di ricerca Google. Questi termini di ricerca speciali devono essere inclusi nel valore del parametro di richiesta q. Come gli altri termini di ricerca, i termini di ricerca speciali devono essere con caratteri di escape nell'URL. Alcuni termini di ricerca speciali contengono i due punti (:). Anche questo carattere deve essere sottoposto a escape nell'URL; il suo valore con caratteri di escape nell'URL è %3A.

Backlink [link:]
Descrizione

Il termine di query link: recupera l'insieme di pagine web che rimandano a un determinato URL. La query di ricerca deve essere formattata come link:URL senza spazi tra il termine di query link: e l'URL.

La versione con escape URL di link: è link%3A.

Puoi anche utilizzare il parametro di richiesta as_lq per inviare una richiesta link:.

Nota:non puoi specificare altri termini di query quando utilizzi link:.
Esempi

http://www.google.com/search?q=link%3Awww.example.com

Ricerca booleana OR [ OR ]
Descrizione

Il termine di ricerca OR recupera i documenti che includono uno di una serie di (due o più) termini di ricerca. Per utilizzare il termine di query OR, inserisci il termine di ricerca OR, in lettere maiuscole, tra ogni termine della serie.

Puoi anche utilizzare il parametro di richiesta as_oq per inviare una ricerca di qualsiasi termine in un insieme di termini.

Nota:se una richiesta di ricerca specifica la query "Londra+OR+Parigi", i risultati di ricerca includeranno documenti contenenti almeno una di queste due parole. In alcuni casi, i documenti nei risultati di ricerca potrebbero contenere entrambe le parole.
Esempi

Cerca Londra o Parigi:

Input utente:london OR paris Termine di query:q=london+OR+paris

Cerca vacanze e Londra o Parigi:

Termine di query:q=vacation+london+OR+paris

Cerca vacanze e una delle seguenti parole: Londra, Parigi o cioccolatini:

Termine di query:  q=vacation+london+OR+paris+OR+chocolates

Cerca vacanze e cioccolatini e Londra o Parigi, con il peso minore dato ai cioccolatini:

Termine di query:  q=vacation+london+OR+paris+chocolates

Cerca vacanze, cioccolatini e fiori nei documenti che contengono anche Londra o Parigi:

Termine di query:  q=vacation+london+OR+paris+chocolates+flowers

Cerca vacanze e una delle città Londra o Parigi, nonché uno dei termini cioccolatini o fiori:

Termine di query:  q=vacation+london+OR+paris+chocolates+OR+flowers

Escludi termine di query [-]
Descrizione

Il termine di query escludi (-) limita i risultati di una determinata richiesta di ricerca ai documenti che non contengono una determinata parola o frase. Per utilizzare il termine di query escludi, devi anteporre alla parola o alla frase da escludere dai documenti corrispondenti il simbolo "-" (un segno meno).

La versione con escape URL di - è %2D.

Il termine di query di esclusione è utile quando un termine di ricerca ha più di un significato. Ad esempio, la parola "basso" potrebbe restituire risultati relativi a pesci o musica. Se stai cercando documenti sui pesci, puoi escludere dai risultati di ricerca i documenti sulla musica utilizzando il termine di query di esclusione.

Puoi anche utilizzare il parametro di richiesta as_eq per escludere dai risultati di ricerca i documenti che corrispondono a una determinata parola o frase.
Esempi Input utente: bass -music
Termine di query: q=bass+%2Dmusic

Esclusione del tipo di file [ -filetype: ]
Descrizione

Il termine di ricerca -filetype: esclude dai risultati di ricerca i documenti con una particolare estensione del file, ad esempio ".pdf" o ".doc". La query di ricerca deve essere formattata come -filetype:EXTENSION senza spazi tra il termine di query -filetype: e l'estensione specificata.

La versione con escape URL di -filetype: è %2Dfiletype%3A.

Nota:puoi escludere più tipi di file dai risultati di ricerca aggiungendo altri termini di query -filetype: alla query. Devi avere un termine di query -filetype: nella query di ricerca per ogni estensione di file da escludere dai risultati di ricerca.

I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (settimana 1, settimana 2, settimana 3, settimana 4, settimana 5, settimana i, settimana s, settimana u)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich Text Format (.rtf)
  • Shockwave Flash (swf)
  • Testo (ans, txt).

In futuro potrebbero essere aggiunti altri tipi di file. Un elenco aggiornato è sempre disponibile nelle domande frequenti sui tipi di file di Google.
Esempi

Questo esempio restituisce i documenti che menzionano "Google" ma che non sono documenti PDF:
q=Google+%2Dfiletype%3Apdf

Questo esempio restituisce i documenti che menzionano "Google" ma esclude sia i documenti PDF sia quelli di Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Filtro per tipo di file [ filetype: ]
Descrizione

Il termine di ricerca filetype: limita i risultati di ricerca a documenti con una determinata estensione del file, ad esempio ".pdf" o ".doc". La query di ricerca deve essere formattata come filetype:ESTENSIONE senza spazi tra il termine di ricerca filetype: e l'estensione specificata.

La versione con escape URL di filetype: è filetype%3A.

Puoi limitare i risultati di ricerca ai documenti che corrispondono a una delle diverse estensioni di file aggiungendo altri termini di query filetype: alla query. Nella query di ricerca devi avere un termine di query filetype: per ogni estensione di file da includere nei risultati di ricerca. Più termini di query filetype: devono essere separati utilizzando il termine di query OR.

Per impostazione predefinita, i risultati di ricerca includeranno i documenti con qualsiasi estensione di file.

I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (settimana 1, settimana 2, settimana 3, settimana 4, settimana 5, settimana i, settimana s, settimana u)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich Text Format (.rtf)
  • Shockwave Flash (swf)
  • Testo (ans, txt).

In futuro potrebbero essere aggiunti altri tipi di file. Un elenco aggiornato è sempre disponibile nelle domande frequenti sui tipi di file di Google.
Esempi

Questo esempio restituisce i documenti PDF che menzionano "Google":
q=Google+filetype%3Apdf

Questo esempio restituisce documenti PDF e Word che menzionano "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc

Includi termine di query [+]
Descrizione

Il termine di query di inclusione (+) specifica che una parola o una frase deve essere presente in tutti i documenti inclusi nei risultati di ricerca. Per utilizzare il termine di query di inclusione, devi anteporre il segno "+" (più) alla parola o alla frase che deve essere inclusa in tutti i risultati di ricerca.

La versione con escape dell'URL di + (un segno più) è %2B.

Devi utilizzare + prima di una parola comune che Google normalmente scarta prima di identificare i risultati di ricerca.
Esempi Input utente: Star Wars Episode +I
Termine di query: q=Star+Wars+Episode+%2BI

Ricerca solo link, tutti i termini [ allinlinks: ]
Descrizione

Il termine di ricerca allinlinks: richiede che i documenti nei risultati di ricerca contengano tutte le parole della query di ricerca nei link URL. La query di ricerca deve essere formattata come allinlinks: seguita dalle parole nella query di ricerca.

Se la query di ricerca include il termine allinlinks:, Google controllerà solo i link URL nei documenti per le parole nella query di ricerca, ignorando altro testo nei documenti, i titoli dei documenti e gli URL di ciascun documento. Tieni presente che l'URL del documento è diverso dai link URL contenuti nel documento.

La versione con escape URL di allinlinks: è allinlinks%3A.
Esempi Input utente:allinlinks: Google search
Termine di query:q=allinlinks%3A+Google+search

Ricerca di frasi
Descrizione

Il termine di query per la ricerca di frasi (") ti consente di cercare frasi complete racchiudendole tra virgolette o collegandole con trattini.

La versione con caratteri di escape dell'URL di " (un segno di virgolette) è %22.

Le ricerche di frasi sono particolarmente utili se stai cercando citazioni famose o nomi propri.

Puoi anche utilizzare il parametro di richiesta as_epq per inviare una ricerca di una frase esatta.
Esempi Input utente:"Abraham Lincoln"
Termine di query: q=%22Abraham+Lincoln%22


Informazioni sul documento web [info:]
Descrizione

Il termine di query info: recupera informazioni generali su un URL, a condizione che sia incluso nell'indice di ricerca di Google. La query di ricerca deve essere formattata come info:URL senza spazi tra il termine di query info: e l'URL.

La versione con URL in codifica escape di info: è info%3A.

Nota:non puoi specificare altri termini di query quando utilizzi info:.
Esempi Input utente: info:www.google.com
Termine di query: q=info%3Awww.google.com

Query immagine di esempio

Gli esempi riportati di seguito mostrano un paio di richieste HTTP di immagini per illustrare come vengono utilizzati i diversi parametri di query. Le definizioni dei diversi parametri di query sono fornite nelle sezioni Definizioni dei parametri di query delle immagini di questo documento.

Questa richiesta chiede i primi 5 risultati (start=0&num=5) per il termine di ricerca "scimmia" (q=monkey), di tipo .png. Infine, la query specifica i valori per i parametri client, output e cx, tutti e tre obbligatori.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Parametri di query della ricerca immagini

as_filetype
Descrizione

Facoltativo. Restituisce immagini di un tipo specificato. I valori consentiti sono: bmp, gif, png, jpg e svg.
Esempi q=google&as_filetype=png

imgsz
Descrizione

Facoltativo. Restituisce immagini di una dimensione specificata, dove la dimensione può essere una delle seguenti:

  • icon (piccolo)
  • small|medium|large|xlarge (medio)
  • xxlarge (grande)
  • huge (molto grande)

Esempi q=google&as_filetype=png&imgsz=icon

imgtype
Descrizione

Facoltativo. Restituisce immagini di un tipo, che può essere uno dei seguenti:

  • clipart (clipart)
  • face (faccia)
  • lineart (lineart)
  • news (notizie)
  • photo (foto)
Esempi q=google&as_filetype=png&imgtype=photo

imgc
Descrizione

Facoltativo. Restituisce immagini in bianco e nero, in scala di grigi o a colori:

  • mono (bianco e nero)
  • gray (scala di grigi)
  • color (colore)
Esempi q=google&as_filetype=png&imgc=gray

imgcolor
Descrizione

Facoltativo. Restituisce immagini di un colore dominante specifico:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Esempi q=google&as_filetype=png&imgcolor=yellow

as_rights
Descrizione

Facoltativo. Filtri basati sulle licenze. I valori supportati includono:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
Esempi q=cats&as_filetype=png&as_rights=cc_attribute

Limiti per le richieste

Il grafico seguente elenca le limitazioni delle richieste di ricerca che inviate a Google:

Componente Limite Commento
Lunghezza della richiesta di ricerca 2048 byte  
Numero di termini di query 10 include i termini nei seguenti parametri: q, as_epq, as_eq, as_lq, as_oq, as_q
Numero risultati 20 Se imposti il parametro num su un numero maggiore di 20, vengono restituiti solo 20 risultati. Per ottenere più risultati, dovrai inviare più richieste e aumentare il valore del parametro start a ogni richiesta.

Internazionalizzazione delle query e della presentazione dei risultati

Il servizio Ricerca Google ti consente di cercare documenti in più lingue. Puoi specificare la codifica dei caratteri da utilizzare per interpretare la richiesta HTTP e codificare la risposta XML (utilizzando i parametri di ricerca ie e oe). Puoi anche filtrare i risultati in modo da includere solo i documenti scritti in determinate lingue.

Le sezioni seguenti descrivono i problemi relativi alla ricerca in più lingue:

Codifica dei caratteri

I server inviano dati, come pagine web, agli user agent, ad esempio i browser, come sequenza di byte codificati. Lo user agent decodifica i byte in una sequenza di caratteri. Quando invii richieste al servizio WebSearch, puoi specificare gli schemi di codifica sia per la query di ricerca sia per la risposta XML che ricevi.

Puoi utilizzare il parametro di richiesta ie per specificare il meccanismo di codifica per i caratteri nella richiesta HTTP. Puoi anche utilizzare il parametro oe per specificare lo schema di codifica che Google deve utilizzare per codificare la risposta XML. Se utilizzi uno schema di codifica diverso da ISO-8859-1 (o latin1), assicurati di specificare i valori corretti per i parametri ie e oe.

Nota:se fornisci la funzionalità di ricerca per più lingue, ti consigliamo di utilizzare il valore di codifica utf8 (UTF-8) sia per i parametri ie sia per oe.

Per un elenco completo dei valori che puoi utilizzare per i parametri ie e oe, consulta l'appendice Schemi di codifica dei caratteri.

Per informazioni più generali sulla codifica dei caratteri, visita la pagina http://www.w3.org/TR/REC-html40/charset.html.

Lingue dell'interfaccia

Puoi utilizzare il parametro di richiesta hl per identificare la lingua dell'interfaccia grafica. Il valore del parametro hl può influire sui risultati di ricerca XML, in particolare sulle query internazionali quando la limitazione della lingua (tramite il parametro lr) non è specificata in modo esplicito. In questi casi, il parametro hl può promuovere i risultati di ricerca nella stessa lingua della lingua di input dell'utente.

Ti consigliamo di impostare in modo esplicito il parametro hl nei risultati di ricerca per assicurarti che Google selezioni i risultati di ricerca di qualità ottimale per ogni query.

Per un elenco completo dei valori validi per il parametro hl, consulta la sezione Lingue dell'interfaccia supportate.

Ricerca di documenti scritti in lingue specifiche

Puoi utilizzare il parametro di richiesta lr per limitare i risultati di ricerca ai documenti scritti in una determinata lingua o insieme di lingue.

Il parametro lr supporta gli operatori booleani per consentirti di specificare più lingue da includere (o escludere) dai risultati di ricerca.

Gli esempi seguenti mostrano come utilizzare gli operatori booleani per richiedere documenti in lingue diverse.

Per i documenti scritti in giapponese:

lr=lang_jp

Per i documenti scritti in italiano o tedesco:

lr=lang_it|lang_de

Per i documenti non scritti in ungherese o ceco:

lr=(-lang_hu).(-lang_cs)

Per un elenco completo dei valori possibili per il parametro lr, consulta la sezione Valori della raccolta di lingue e per una discussione completa sull'utilizzo di questi operatori, consulta la sezione Operatori booleani.

Il cinese semplificato e il cinese tradizionale sono due varianti di scrittura della lingua cinese. Lo stesso concetto può essere scritto in modo diverso in ogni variante. Data una query in una delle varianti, il servizio Ricerca Google può restituire risultati che includono pagine in entrambe le varianti.

Per usare questa funzionalità:

  1. Imposta il parametro di richiesta c2coff su 0
    e
  2. Esegui una delle seguenti operazioni:
    • Non impostare il parametro di richiesta lr
      o
    • Imposta il parametro di richiesta lr su lr=lang_zh-TW|lang_zh-CN

L'esempio seguente mostra i parametri di ricerca da includere in una richiesta di risultati in cinese semplificato e tradizionale. Tieni presente che le informazioni aggiuntive richieste, ad esempio il cliente, non sono incluse nell'esempio.

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Filtro dei risultati

La Ricerca Google offre diversi modi per filtrare i risultati di ricerca:

Filtro automatico dei risultati di ricerca

Per offrire i migliori risultati possibili, Google utilizza due tecniche per filtrare automaticamente i risultati di ricerca considerati in genere indesiderati:

  • Contenuti duplicati: se più documenti contengono le stesse informazioni, solo il documento più pertinente viene incluso nei risultati di ricerca.

  • Crowding degli host: se esistono molti risultati di ricerca per lo stesso sito, Google potrebbe non mostrare tutti i risultati del sito o potrebbe mostrarli in una posizione più bassa nel ranking rispetto a quella che avrebbero avuto altrimenti.

Ti consigliamo di lasciare attivi questi filtri per le richieste di ricerca tipiche perché migliorano significativamente la qualità della maggior parte dei risultati di ricerca. Tuttavia, puoi ignorare questi filtri automatici impostando il parametro di query filter su 0 nella richiesta di ricerca.

Filtro per lingua e paese

Il servizio Ricerca Google restituisce i risultati da un indice principale di tutti i documenti web. L'indice principale contiene sottoraccolte di documenti raggruppati in base a determinati attributi, tra cui la lingua e il paese di origine.

Puoi utilizzare i parametri di richiesta lr e cr per limitare i risultati di ricerca a sottoraccolte di documenti scritti in determinate lingue o provenienti da determinati paesi, rispettivamente.

La Ricerca Google determina la lingua di un documento mediante l'analisi di quanto segue:

  • il dominio di primo livello (TLD) dell'URL del documento
  • i meta tag della lingua all'interno del documento
  • la lingua principale utilizzata nel corpo del testo del documento


Per ulteriori informazioni sulla limitazione dei risultati in base alla lingua, consulta anche la definizione del parametro lr, la sezione relativa alla ricerca di documenti scritti in lingue specifiche e i valori della raccolta di lingue che possono essere utilizzati come valori per il parametro lr.

La Ricerca Google determina il paese di un documento mediante l'analisi di quanto segue:

  • il dominio di primo livello (TLD) dell'URL del documento
  • la posizione geografica dell'indirizzo IP del server web

Per ulteriori informazioni sulla limitazione dei risultati in base al paese di origine, consulta anche la definizione del parametro cr e i valori della raccolta di paesi che possono essere utilizzati come valori per il parametro cr.

Nota:puoi combinare i valori della lingua e del paese per personalizzare i risultati di ricerca. Ad esempio, potresti richiedere documenti scritti in francese e provenienti dalla Francia o dal Canada oppure potresti richiedere documenti provenienti dall'Olanda e non scritti in inglese. I parametri lr e cr supportano entrambi gli operatori booleani.

Filtrare i contenuti per adulti con SafeSearch

Molti clienti Google non vogliono visualizzare risultati di ricerca per siti che contengono contenuti per adulti. Utilizzando il nostro filtro SafeSearch, puoi filtrare i risultati di ricerca che contengono contenuti per adulti ed eliminarli. I filtri di Google utilizzano una tecnologia proprietaria per controllare parole chiave, frasi e URL. Sebbene nessun filtro sia preciso al 100%, SafeSearch rimuoverà la stragrande maggioranza dei contenuti per adulti dai risultati di ricerca.

Google si impegna a mantenere SafeSearch il più aggiornato e completo possibile eseguendo continuamente la scansione del web e incorporando gli aggiornamenti suggeriti dagli utenti.

SafeSearch è disponibile nelle seguenti lingue:

Olandese
Inglese
Francese
Tedesco 		Italiano
Portoghese (brasiliano)
Spagnolo
Cinese tradizionale

Puoi regolare il livello di filtraggio dei risultati per i contenuti per adulti da parte di Google utilizzando il parametro di query safe. La tabella seguente illustra le impostazioni di SafeSearch di Google e il modo in cui influiscono sui risultati di ricerca:

Livello di SafeSearch Descrizione
valore alto Attiva una versione più restrittiva della ricerca sicura.
media Blocca le pagine web contenenti pornografia e altri contenuti di natura sessuale espliciti.
off Non filtra i contenuti per adulti dai risultati di ricerca.

* L'impostazione SafeSearch predefinita è Off.

Se hai attivato SafeSearch e trovi siti che contengono contenuti offensivi nei risultati, invia un'email con l'URL del sito all'indirizzo safesearch@google.com e noi esamineremo il sito.

Risultati XML

DTD dei risultati XML di Google

Google utilizza lo stesso DTD per descrivere il formato XML per tutti i tipi di risultati di ricerca. Molti tag e attributi sono applicabili a tutti i tipi di ricerca. Tuttavia, alcuni tag sono applicabili solo a determinati tipi di ricerca. Di conseguenza, le definizioni nel DTD potrebbero essere meno restrittive rispetto a quelle riportate in questo documento.

Questo documento descrive gli aspetti della DTD pertinenti per WebSearch. Quando esamini la DTD, se lavori su WebSearch, puoi ignorare in sicurezza i tag e gli attributi che non sono documentati qui. Se la definizione differisce tra la DTD e la documentazione, questo fatto viene annotato in questo documento.

Google può restituire risultati XML con o senza riferimento alla DTD più recente. Il DTD è una guida per aiutare gli amministratori della ricerca e gli analizzatori XML a comprendere i risultati XML di Google. Poiché la grammatica XML di Google potrebbe cambiare di tanto in tanto, non devi configurare il parser in modo che utilizzi il DTD per convalidare ogni risultato XML.

Inoltre, non devi configurare il parser XML per recuperare il DTD ogni volta che invii una richiesta di ricerca. Google aggiorna il DTD di rado e queste richieste creano ritardi e requisiti di larghezza di banda non necessari.

Google consiglia di utilizzare il formato di output xml_no_dtd per ottenere risultati XML. Se specifichi il formato xml output nella richiesta di ricerca, l'unica differenza è l'inclusione della seguente riga nei risultati XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Puoi accedere all'ultimo DTD all'indirizzo http://www.google.com/google.dtd.

Tieni presente che al momento non tutte le funzionalità nel DTD potrebbero essere disponibili o supportate.

Informazioni sulla risposta XML

  • Tutti i valori degli elementi sono HTML validi adatti alla visualizzazione, a meno che non sia indicato diversamente nelle definizioni dei tag XML.
  • Alcuni valori degli elementi sono URL che devono essere codificati in HTML prima di essere visualizzati.
  • Il parser XML deve ignorare gli attributi e i tag non documentati. Ciò consente alla tua applicazione di continuare a funzionare senza modifiche se Google aggiunge altre funzionalità all'output XML.
  • Alcuni caratteri devono essere sottoposti a escape quando vengono inclusi come valori nei tag XML. Il tuo processore XML deve riconvertire queste entità nei caratteri appropriati. Se non converti correttamente le entità, il browser potrebbe, ad esempio, visualizzare il carattere & come "&amp;". Questi caratteri sono documentati negli standard XML e sono riprodotti nella tabella seguente:

    Personaggio Moduli di escape Entità Codice carattere
    E commerciale & &amp; &#38;
    Virgolette semplici ' &apos; &#39;
    Virgolette doppie " &quot; &#34;
    Maggiore di > &gt; &#62;
    Minore di < &lt; &#60;

Risultati XML per query di ricerca regolari e avanzate

Ricerca normale/avanzata: query di esempio e risultato XML

Questa richiesta WebSearch di esempio chiede 10 risultati (num=10) relativi al termine di ricerca "socer" (q=socer), che è la parola "soccer" scritta intenzionalmente in modo errato per questo esempio.

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i

Questa richiesta produce il risultato XML riportato di seguito. Tieni presente che nel risultato XML sono presenti diversi commenti per indicare dove verrebbero visualizzati determinati tag non inclusi nel risultato.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

Ricerca normale/avanzata: tag XML

Le risposte XML per le richieste di ricerca regolari e le richieste di ricerca avanzata utilizzano lo stesso insieme di tag XML. Questi tag XML sono mostrati nell'esempio XML riportato sopra e spiegati nelle tabelle seguenti.

I tag XML riportati di seguito sono elencati in ordine alfabetico in base al nome e ogni definizione di tag contiene una descrizione del tag, un esempio che mostra come apparirebbe in un risultato XML e il formato dei contenuti del tag. Se il tag è un tag secondario di un altro tag XML o se ha tag secondari o attributi propri, queste informazioni vengono fornite anche nella tabella di definizione del tag.

Alcuni simboli potrebbero essere visualizzati accanto ad alcuni sottotag nelle definizioni riportate di seguito. Tali simboli sono riportati di seguito, insieme al relativo significato:

? = sottotag facoltativo
* = zero o più istanze del sottotag
+ = una o più istanze del sottotag
R B C D V G H I L M N P D R S T U X

anchor_text
Definizione

Il tag <anchor_text> specifica il testo che devi mostrare agli utenti per identificare un'etichetta di affinamento associata a un insieme di risultati di ricerca. Poiché le etichette di affinamento sostituiscono i caratteri non alfanumerici con trattini bassi, non devi mostrare il valore del tag <label> nell'interfaccia utente. Devi invece mostrare il valore del tag <anchor_text>.

Esempio <anchor_text>campi da golf</anchor_text>
Sottotag di FacetItem
Formato dei contenuti Testo

BLOCCA
Definizione

Questo tag racchiude i contenuti di un blocco in una riga del corpo di un risultato di promozione. Ogni blocco ha i sottotag T, U e L. Un tag T non vuoto indica che il blocco contiene testo; i tag U e L non vuoti indicano che il blocco contiene un link (con l'URL specificato nel sottotag U e l'anchor text nel sottotag L).
Tag secondari T, U, L
Sottotag di BODY_LINE
Formato dei contenuti Vuoto

BODY_LINE
Definizione

Questo tag racchiude i contenuti di una riga nel corpo del risultato promozionale. Ogni riga del corpo è costituita da diversi tag BLOCK, che contengono testo o un link con URL e anchor text.
Tag secondari BLOCK*
Sottotag di SL_MAIN
Formato dei contenuti Vuoto

C
Definizione

Il tag <C> indica che il servizio WebSearch può recuperare una versione memorizzata nella cache di questo URL dei risultati di ricerca. Non puoi recuperare le pagine memorizzate nella cache tramite l'API XML, ma puoi reindirizzare gli utenti a www.google.com per questi contenuti.
Attributi
Nome Formato Descrizione
SZ Testo (numero intero + "k") Fornisce le dimensioni della versione memorizzata nella cache del risultato di ricerca in kilobyte ("k").
ID cliente Testo Identifica un documento nella cache di Google. Per recuperare il documento dalla cache, invia un termine di ricerca creato come segue:
cache:CIDtext:escapedURL

L'URL con caratteri di escape è disponibile nel tag UE.
Esempio <C SZ="6k" CID="kvOXK_cYSSgJ" />
Sottotag di HAS
Formato dei contenuti Vuoto

C2C
Definizione Il tag <C2C> indica che il risultato si riferisce a una pagina in cinese tradizionale. Questo tag viene visualizzato solo quando è attivata l'opzione Ricerca in cinese semplificato e tradizionale. Per ulteriori informazioni sull'attivazione e la disattivazione di questa funzionalità, consulta la definizione del parametro di query c2coff.
Formato dei contenuti Testo

Contesto
Definizione

Il tag <Context> racchiude un elenco di etichette di perfezionamento associate a un insieme di risultati di ricerca.
Esempio <Context>
Tag secondari title, Facet+
Formato dei contenuti Container

CRAWLDATE
Definizione

Il tag <CRAWLDATE> identifica la data dell'ultima scansione della pagina. CRAWLDATE non viene restituito per ogni pagina dei risultati di ricerca.
Esempio <CRAWLDATE>21 maggio 2005</CRAWLDATE>
Sottotag di R
Formato dei contenuti Testo

DI
Definizione

Il tag <DI> contiene le informazioni sulle categorie dell'Open Directory Project (ODP) per un singolo risultato di ricerca.
Esempio <DI>
Tag secondari DT?, DS?
Sottotag di HAS
Formato dei contenuti Vuoto

DS
Definizione

Il tag <DS> fornisce il riepilogo elencato per una singola categoria nella directory ODP.
Esempio <DS>Pubblica il tuo curriculum &lt;b&gt;calcistico&lt;/b&gt; direttamente su internet.</DS>
Sottotag di DI
Formato dei contenuti Testo (potrebbe contenere HTML)

DT
Definizione

Il tag <DT> fornisce il titolo di una singola categoria elencata nella directory ODP.
Esempio <DT>SoccerConnection.net</DT>
Sottotag di DI
Formato dei contenuti Testo (potrebbe contenere HTML)

Facet
Definizione

Il tag <Facet> contiene un raggruppamento logico di tag <FacetItem>. Puoi creare questi raggruppamenti utilizzando il formato della specifica XML del motore di ricerca programmabile. Se non crei questi raggruppamenti, il tag results_xml_tag_Context><Context> conterrà fino a quattro tag <Facet>. Gli elementi all'interno di ogni tag <Facet> verranno raggruppati a scopo di visualizzazione, ma potrebbero non avere una relazione logica.
Esempio <Facet>
Tag secondari FacetItem+, title+
Sottotag di Contesto
Formato dei contenuti Container

FacetItem
Definizione

Il tag <FacetItem> include informazioni su un'etichetta di perfezionamento associata a un insieme di risultati di ricerca.
Esempio <FacetItem>
Tag secondari label, anchor_text+
Sottotag di Facet
Formato dei contenuti FacetItem

FI
Definizione Il tag <FI> funge da indicatore che indica se è stato eseguito il filtro dei documenti per la ricerca. Per saperne di più sui filtri dei risultati di ricerca di Google, consulta la sezione Filtro automatico di questo documento.
Esempio <FI />
Sottotag di RES
Formato dei contenuti Vuoto

PSG
Definizione

Il tag <GSP> contiene tutti i dati restituiti nei risultati di ricerca XML di Google. "GSP" è l'abbreviazione di "Google Search Protocol".
Attributi
Nome Formato Descrizione
VER Testo (numero intero) L'attributo VER specifica la versione dell'output dei risultati di ricerca. La versione di output corrente è "3.2".
Esempio <GSP VER="3.2">
Tag secondari PARAM+, Q, RES?, TM
Formato dei contenuti Vuoto

HAS
Definizione Il tag <HAS> racchiude informazioni su eventuali parametri di richiesta di ricerca speciali supportati per un determinato URL.

Nota:la definizione di <HAS> per WebSearch è più restrittiva rispetto al DTD.

Tag secondari DI?, L?, C?, RT?
Sottotag di R

ISURL
Definizione Google restituisce il tag <ISURL> se la query di ricerca associata è un URL.
Sottotag di GSP
Formato dei contenuti Vuoto

L
Definizione La presenza del tag <L> indica che il servizio WebSearch può trovare altri siti che rimandano all'URL di questo risultato di ricerca. Per trovare questi siti, devi utilizzare il termine di query speciale link:.
Sottotag di HAS
Formato dei contenuti Vuoto

etichetta
Definizione

Il tag <label> specifica un'etichetta di perfezionamento che puoi utilizzare per filtrare i risultati di ricerca che ricevi. Per utilizzare un'etichetta di perfezionamento, aggiungi la stringa more:[[label tag value]] al valore del parametro q nella tua richiesta HTTP a Google come mostrato nell'esempio seguente. Tieni presente che questo valore deve essere codificato come URL prima di inviare la query a Google.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

Nota:il tag <label> non è uguale al tag <Label>, che identifica un'etichetta di perfezionamento associata a un determinato URL nei risultati di ricerca.
Esempio <label>golf_courses</label>
Sottotag di FacetItem
Formato dei contenuti Testo

lang
Definizione

Il tag <LANG> contiene la migliore ipotesi di Google sulla lingua del risultato di ricerca.
Esempio <LANG>it</LANG>
Sottotag di R
Formato dei contenuti Testo

M
Definizione

Il tag <M> identifica il numero totale stimato di risultati per la ricerca.

Nota: questa stima potrebbe non essere accurata.

Esempio <M>16200000</M>
Sottotag di RES
Formato dei contenuti Testo

Neonato
Definizione

Il tag <NB> contiene le informazioni di navigazione, ovvero i link alla pagina successiva dei risultati di ricerca o a quella precedente per il set di risultati.

Nota:questo tag è presente solo se sono disponibili altri risultati.
Esempio <NB>
Tag secondari NU?, PU?
Sottotag di RES
Formato dei contenuti Vuoto

NU
Definizione

Il tag <NU> contiene un link relativo alla pagina successiva dei risultati di ricerca.
Esempio <NU>/search?q=flowers&num=10&hl=en&ie=UTF-8
    &output=xml&client=test&start=10</NU>
Sottotag di NB
Formato dei contenuti Testo (URL relativo)

PARAM
Definizione

Il tag <PARAM> identifica un parametro di input inviato nella richiesta HTTP associata al risultato XML. Le informazioni sul parametro sono contenute negli attributi del tag: nome, valore, original_value. Ci sarà un tag PARAM per ogni parametro inviato nella richiesta HTTP.
Attributi
Nome Formato Descrizione
name Testo Nome parametro di input.
value HTML Versione in formato HTML del valore parametro di input.
original_value Testo Versione con escape URL originale del valore parametro di input.
Esempio <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Sottotag di GSP
Formato dei contenuti Complesso

PU
Definizione

Il tag <PU> fornisce un link relativo alla pagina precedente dei risultati di ricerca.
Esempio <PU>/search?q=flowers&num=10&hl=en&output=xml
    &client=test&start=10</PU>
Sottotag di NB
Formato dei contenuti Testo (URL relativo)

Q
Definizione

Il tag <Q> identifica la query di ricerca inviata nella richiesta HTTP associata al risultato XML.
Esempio

<Q>pizza</Q>
Sottotag di GSP
Formato dei contenuti Testo

R
Definizione

Il tag <R> contiene i dettagli di un singolo risultato di ricerca.

Nota:la definizione del tag <R> per WebSearch è più restrittiva rispetto al DTD.

Attributi
Nome Formato Descrizione
No Testo (numero intero) Indica l'indice (in base a 1) di questo risultato di ricerca.
MIME Testo Indica il tipo MIME del risultato di ricerca.
Tag secondari U, UE, T?, CRAWLDATE, S?, LANG?, HAS
Sottotag di RES

RES
Definizione

Il tag <RES> racchiude l'insieme dei singoli risultati di ricerca e i dettagli relativi a questi risultati.
Attributi
Nome Formato Descrizione
SN Testo (numero intero) Indica l'indice (in base a 1) del primo risultato di ricerca restituito in questo insieme di risultati.
IT Testo (numero intero) Indica l'indice (in base 1) dell'ultimo risultato di ricerca restituito in questo set di risultati.
Esempio <RES SN="1" EN="10">
Tag secondari M, FI?, XT?, NB?, R*
Sottotag di GSP
Formato dei contenuti Vuoto

S
Definizione

Il tag <S> contiene un estratto per un risultato di ricerca che mostra i termini di query evidenziati in grassetto. Le interruzioni di riga sono incluse nell'estratto per il corretto ritorno a capo del testo.
Esempio <S>Washington (CNN) -- Un'offerta per porre fine allo stallo del Senato sui candidati alla magistratura del presidente &lt;b&gt;Bush&#39;s&lt;/b&gt; consentirebbe a cinque candidati di passare a una votazione finale, preservando al contempo &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
Sottotag di R
Formato dei contenuti Testo (HTML)

SL_MAIN
Definizione

Questo tag racchiude i contenuti di un risultato della promozione. Utilizzare per analizzare le promozioni. L'anchor text e l'URL del link del titolo sono contenuti rispettivamente nei sottotag T e U. Le righe di testo del corpo e i link sono contenuti nei tag secondari BODY_LINE.
Tag secondari BODY_LINE*, T, U
Sottotag di SL_RESULTS
Formato dei contenuti Vuoto

SL_RESULTS
Definizione

Tag contenitore per i risultati promozionali. Uno di questi verrà visualizzato ogni volta che hai una promozione nei risultati di ricerca. Il subtag SL_MAIN contiene i dati principali dei risultati.
Tag secondari SL_MAIN*
Sottotag di R
Formato dei contenuti Vuoto

Ortografia
Definizione

Il tag <Spelling> racchiude un suggerimento ortografico alternativo per la query inviata. Questo tag viene visualizzato solo nella prima pagina dei risultati di ricerca. I suggerimenti ortografici sono disponibili in inglese, cinese, giapponese e coreano.

Nota:Google restituirà suggerimenti ortografici solo per le query in cui il valore del parametro gl è in lettere minuscole.
Esempio <Spelling>
Tag secondari Suggerimento
Sottotag di GSP
Formato dei contenuti Vuoto

Suggerimento
Definizione Il tag <Suggestion> contiene un suggerimento ortografico alternativo per la query inviata. Puoi utilizzare i contenuti del tag per suggerire l'ortografia alternativa all'utente che esegue la ricerca. Il valore dell'attributo q è il suggerimento ortografico con escape URL che puoi utilizzare come termine di ricerca.
Attributi
Nome Formato Descrizione
q Testo L'attributo q specifica la versione con escape URL del suggerimento ortografico.
Esempio <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion>
Sottotag di Ortografia
Formato dei contenuti Testo (HTML)

T
Definizione Il tag <T> contiene il titolo del risultato.
Esempio <T>Amici's East Coast Pizzeria</T>
Sottotag di R
Formato dei contenuti Testo (HTML)

titolo
Definizione

In quanto elemento secondario di <Context>, il tag <title> contiene il nome del tuo motore di ricerca programmabile.

Come elemento secondario di <Facet>, il tag <title> fornisce un titolo per un insieme di sfaccettature.
Esempio

Come elemento secondario di <Context>: <title>Il mio motore di ricerca</title>

Come elemento secondario di <Facet>: <title>facet title</title>
Sottotag di Contesto, Aspetto
Formato dei contenuti Testo

TM
Definizione

Il tag <TM> identifica il tempo totale del server necessario per restituire i risultati di ricerca, misurato in secondi.
Esempio <TM>0.100445</TM>
Sottotag di GSP
Formato dei contenuti Testo (rappresentazione in virgola mobile)

TT
Definizione Il tag <TT> fornisce un suggerimento per la ricerca.
Esempio <TT>&lt;i&gt;Suggerimento: per la maggior parte dei browser, premendo il tasto Invio si ottengono gli stessi risultati che si ottengono facendo clic sul pulsante Cerca.&lt;/i&gt;</TT>
Sottotag di GSP

U
Definizione Il tag <U> fornisce l'URL del risultato di ricerca.
Esempio <U>http://www.dominos.com/</U>
Sottotag di R
Formato dei contenuti Testo (URL assoluto)

UD
Definizione

Il tag <UD> fornisce l'URL con codifica IDN (nome di dominio internazionalizzato) per il risultato di ricerca. Il valore consente di visualizzare i domini utilizzando le lingue locali. Ad esempio, l'URL codificato IDN http://www.%E8%8A%B1%E4%BA%95.com potrebbe essere decodificato e visualizzato come http://www.花井鮨.com. Questo tag <UD> verrà incluso nei risultati di ricerca solo per le richieste che includono il parametro ud.

Nota:questa è una funzionalità beta.
Esempio <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
Sottotag di R
Formato dei contenuti Testo (URL con codifica IDN)

UE
Definizione Il tag <UE> fornisce l'URL del risultato di ricerca. Il valore è dotato di caratteri di escape URL, quindi è adatto per essere passato come parametro di query in un URL.
Esempio <UE>http://www.dominos.com/</UE>
Sottotag di R
Formato dei contenuti Testo (URL con escape)

XT
Definizione Il tag <XT> indica che il numero totale stimato di risultati, specificato dal tag M, rappresenta in realtà il numero totale esatto di risultati. Per maggiori dettagli, consulta la sezione Filtro automatico di questo documento.
Esempio <XT />
Sottotag di RES
Formato dei contenuti Vuoto


Risultati XML per le query di ricerca immagini

Questa richiesta di immagini di esempio chiede 5 risultati (num=5) relativi al termine di ricerca "scimmia" (q=scimmia). 

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Questa richiesta produce il risultato XML riportato di seguito. 

<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

Ricerca immagini: tag XML

La tabella seguente mostra altri tag XML utilizzati nelle risposte XML per le query di ricerca immagini.

Alcuni simboli potrebbero essere visualizzati accanto ad alcuni sottotag nelle definizioni riportate di seguito. Tali simboli sono riportati di seguito, insieme al relativo significato:

? = sottotag facoltativo
* = zero o più istanze del sottotag
+ = una o più istanze del sottotag

RG
Definizione

Il tag <RG> racchiude i dettagli di un singolo risultato di ricerca di immagini.
Attributi
Nome Formato Descrizione
No Testo (numero intero) Indica l'indice (in base a 1) di questo risultato di ricerca.
MIME Testo Indica il tipo MIME del risultato di ricerca.
Sottotag di RES
RU
Definizione

Il tag <RU tag> racchiude i dettagli di ogni risultato di ricerca di immagini.
Sottotag di R