Riferimento API XML

Questa pagina fa riferimento alla versione XML dell'API JSON Custom Search, disponibile solo per i clienti di Google Site Search.

  1. Panoramica
  2. Formato della richiesta di Motore di ricerca programmabile
    1. Panoramica della richiesta
    2. Termini di query
    3. Parametri di richiesta
      1. Esempi di query di Ricerca Google
      2. Definizioni dei parametri di query di Ricerca Web
      3. Ricerca avanzata
      4. Parametri di query di ricerca avanzata
      5. Termini di query speciali
      6. Esempi di query di immagini
      7. Parametri di query di ricerca di immagini
      8. Limiti per le richieste
    4. Internazionalizzazione di query e presentazione dei risultati
      1. Codifica dei caratteri
      2. Lingue dell'interfaccia
      3. Ricerca in cinese semplificato e tradizionale
    5. Filtro dei risultati
      1. Filtro automatico dei risultati di ricerca
      2. Filtri 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 standard, immagine e avanzata
      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 immagini: query di esempio e risultato XML
      5. Ricerca immagini: tag XML

Panoramica

Il servizio Google Ricerca Web consente ai clienti di Google Site Search di mostrare i risultati di ricerca di Google sui propri siti web. Il servizio WebSearch utilizza un semplice protocollo basato su HTTP per fornire 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 della richiesta di Ricerca Google e i formati dei risultati.

Per recuperare i risultati della Ricerca Google, l'applicazione invia a Google una semplice richiesta HTTP. Google restituisce quindi i risultati di ricerca in formato XML. I risultati in formato XML consentono di personalizzare il modo in cui vengono visualizzati i risultati di ricerca.

Formato della richiesta di WebSearch

Panoramica richiesta

La richiesta di ricerca Google è un comando GET HTTP standard. Include una raccolta di parametri pertinenti per le tue query. Questi parametri sono inclusi nell'URL della richiesta sotto forma di coppie nome=valore separate dalla e commerciale (&). 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 WebSearch o Google Immagini restituisce risultati XML in risposta alle tue richieste HTTP.

Termini di query

La maggior parte delle richieste di ricerca include uno o più termini di query. Un termine di query 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. Nelle query è possibile specificare:

  • Parole o frasi da includere o escludere
    • Tutte le parole in una query di ricerca (impostazione predefinita)
    • Una frase esatta nella query di ricerca
    • Qualsiasi parola o frase in una query di ricerca
  • Posizione in un documento in cui cercare i termini di ricerca
    • Ovunque nel documento (impostazione predefinita)
    • Solo nel corpo del documento
    • Solo nel titolo del documento
    • Solo nell'URL del documento
    • Solo nei link del documento
  • Restrizioni relative ai documenti stessi
    • Inclusione o esclusione di 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, come 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 contenere caratteri di escape dell'URL. Tieni presente che devi sostituire il segno più ("+") per tutte le sequenze di spazi vuoti nella query di ricerca. Questo aspetto viene discusso più in dettaglio nella sezione Interpretazione dei caratteri di escape per gli URL di questo documento.

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

q=horses+cows+pigs

Per impostazione predefinita, il servizio Ricerca Google restituisce solo 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 i parametri pertinenti per tutte le richieste di ricerca. Il secondo elenco contiene parametri che sono pertinenti solo alle richieste di ricerca avanzata.

Sono necessari tre parametri di 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 alla 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 più comunemente utilizzati, diversi da quelli sopra menzionati sono:

  • num: il numero richiesto di risultati di ricerca
  • q: i termini di ricerca
  • start: l'indice iniziale dei risultati.

Esempi di query di Ricerca Google

Gli esempi riportati di seguito mostrano un paio di richieste HTTP di 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 di query di Ricerca Web e Parametri delle query di ricerca avanzata di questo documento.

Questa richiesta chiede i primi 10 risultati (start=0&num=10) per il termine di query "red sox" (q=red+sox). La query specifica inoltre 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

In questo esempio vengono utilizzati alcuni dei parametri avanzati per le query di ricerca per personalizzare ulteriormente la query di ricerca. Questa richiesta utilizza il parametro as_q (as_q=red+sox) anziché il parametro q. Utilizza inoltre il parametro as_eq per escludere qualsiasi documento contenente la parola "Yankees" dai risultati di ricerca (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 ricerca WebSearch

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), a indicare che la funzionalità è abilitata. I valori del parametro c2coff sono:

Valore Azione
1 Disabilitata
0 Abilitati
Esempi q=google&c2coff=1

client
Descrizione

Obbligatorio. 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 a documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro cr.

La Ricerca Google determina il paese di un documento analizzando:

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

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

cx
Descrizione

Obbligatorio. Il parametro cx specifica un codice univoco che identifica un motore di ricerca personalizzato. Per recuperare i risultati di ricerca da quel motore, devi specificare un Motore di ricerca programmabile utilizzando il parametro cx.

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

filter
Descrizione

(Facoltativo) Il parametro filter attiva o disattiva il filtro automatico dei risultati di ricerca di Google. Per ulteriori informazioni sui filtri dei risultati di ricerca di Google, consulta la sezione Filtri automatici di questo documento.

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

Valore Azione
1 Disabilitata
0 Abilitati

Nota: per impostazione predefinita, Google applica i filtri 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 della Ricerca Web, il parametro gl incrementa i risultati di ricerca il cui paese di origine corrisponde al valore del parametro. Consulta la sezione Codici paese per un elenco dei valori validi.

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

Questa richiesta potenzia i documenti scritti nel Regno Unito nei risultati di WebSearch:
q=pizza&gl=uk

hl
Descrizione

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

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

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

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

HQ
Descrizione

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

Esempi

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

q=pizza&hq=cheese

ie
Descrizione

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

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

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

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

La Ricerca Google determina la lingua di un documento analizzando:

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

Consulta la sezione Valori della raccolta per lingua (lr) per un elenco dei valori validi per questo parametro.
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, mentre 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 richiesti, verranno restituiti tutti i risultati di ricerca disponibili.
Esempi q=google&num=10

oe
Descrizione

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

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

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

output
Descrizione

Obbligatorio. Il parametro output specifica il formato dei risultati XML. Gli unici valori validi per questo parametro sono xml e xml_no_dtd. Il grafico riportato di seguito spiega le differenze tra i valori di questi parametri.

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 identificherà il tipo di definizione di 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 i risultati di ricerca.

Esistono anche una serie di termini di query speciali che possono essere utilizzati come parte del valore del parametro q. Consulta la sezione Termini di query speciali per un elenco e le relative definizioni.

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 contenere caratteri di escape dell'URL.
Esempi q=vacation&as_oq=london+paris

sicuro
Descrizione

(Facoltativo) Il parametro safe indica come filtrare i risultati di ricerca in base ai contenuti per adulti e pornografici. Il valore predefinito del parametro safe è off. I valori validi del parametro 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

inizio
Descrizione

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

Il parametro start funziona in combinazione con il parametro num per determinare quali risultati di ricerca restituire. Tieni presente che non verranno restituiti più di 1000 risultati per ogni query, anche se più di 1000 documenti corrispondono alla query, quindi l'impostazione di un inizio 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 del 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 con codifica IDN e 0, il che significa che il risultato XML non deve includere URL con codifica IDN. Se il parametro ud è impostato su 1, l'URL con codifica IDN verrà visualizzato nel tag UD dei risultati XML.

Se il parametro ud è impostato su 0, l'URL nell'esempio precedente viene 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 avanzate. Quando invii una ricerca avanzata, i valori di diversi parametri (ad es. as_eq, as_epq, as_oq e così via) vengono tutti considerati nei termini di query per quella ricerca. L'immagine mostra la pagina Ricerca avanzata di Google. Nell'immagine, il nome di ogni parametro di ricerca avanzata è scritto in testo red all'interno o accanto al campo della pagina a cui corrisponde tale parametro.



Parametri di query della ricerca avanzata

as_dt
Descrizione

(Facoltativo) Il parametro as_dt consente di stabilire 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 deve contenere tutti i documenti nei risultati di ricerca. Per cercare una frase, puoi anche utilizzare il termine di query di ricerca per frase.
Esempi as_epq=abraham+lincoln

as_eq
Descrizione

(Facoltativo) Il parametro as_eq identifica una parola o una frase che non deve comparire in nessun documento dei risultati di ricerca. Puoi anche utilizzare il termine di query escludi per assicurarti che una parola o frase specifica non venga visualizzata nei documenti di una serie 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. Per questo tipo di query puoi anche utilizzare il termine di query link:.

Esempi

as_lq=www.google.com

as_nlo
Descrizione

(Facoltativo) Il parametro as_nlo specifica il valore iniziale 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

Quanto segue 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

Quanto segue 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 verificare in un documento; ciascun documento nei risultati di ricerca deve contenere almeno uno dei termini di ricerca aggiuntivi. Per questo tipo di query puoi anche utilizzare il termine di query booleano OR.
Esempi

q=vacation&as_oq=London+Paris

as_q
Descrizione

(Facoltativo) Il parametro as_q fornisce i termini di ricerca da verificare in un documento. Questo parametro viene inoltre comunemente utilizzato 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 i risultati di ricerca relativi a un periodo di tempo specificato (intervallo di date rapido). Sono supportati i seguenti valori:

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

Questo esempio richiede i risultati dell'ultimo anno:

as_qdr=y

In questo esempio vengono richiesti 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. Se imposti il parametro as_dt, puoi utilizzarlo anche 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 query speciali che accedono a funzionalità aggiuntive del motore di ricerca Google. Questi termini di query speciali devono essere inclusi nel valore del parametro di richiesta q. Come per altri termini di query, i termini di query speciali devono utilizzare l'URL di escape. Alcuni termini di query speciali contengono i due punti (:). Questo carattere deve anche contenere caratteri di escape nell'URL; il suo valore URL con escape è %3A.

Link a ritroso [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 di link: con URL con caratteri di escape è 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 query OR recupera i documenti che includono uno di una serie di (due o più) termini di query. Per utilizzare il termine di query OR, devi inserire 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 ricerca:q=london+OR+paris

Cerca vacanza e Londra o Parigi:

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

Cerca una vacanza e una a Londra, Parigi o cioccolatini:

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

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

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

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

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

Cerca una vacanza e una a Londra o Parigi e cerca anche cioccolatini o fiori:

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

Escludi termine di query [-]
Descrizione

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

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

Il termine di query di esclusione è utile quando un termine di ricerca ha più di un significato. Ad esempio, la parola "spica" potrebbe restituire risultati relativi al pesce o alla musica. Se cerchi documenti relativi ai pesci, potresti escludere documenti relativi alla musica dai risultati di ricerca utilizzando il termine di query di esclusione.

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

Esclusione del tipo di file [ -filetype: ]
Descrizione

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

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

Nota: puoi escludere più tipi di file dai risultati di ricerca aggiungendo altri termini di query -filetype: alla query. Nella query di ricerca deve essere presente un termine di query -filetype: per ogni estensione del file che deve essere esclusa dai risultati di ricerca.

I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Loto 1-2-3 (sett.1, ss2, sst3, ss4, ss5, sw, ss, ss.)
  • WordPro Lotus (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (documento)
  • Microsoft Works (sett., 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 documenti che menzionano "Google", ma non sono documenti PDF:
q=Google+%2Dfiletype%3Apdf

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

Filtro tipo di file [ filetype: ]
Descrizione

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

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

Puoi limitare i risultati di ricerca ai documenti che corrispondono a una delle diverse estensioni dei file aggiungendo altri termini di query filetype: alla query. Nella query di ricerca deve essere presente 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 documenti con qualsiasi estensione di file.

I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Loto 1-2-3 (sett.1, ss2, sst3, ss4, ss5, sw, ss, ss.)
  • WordPro Lotus (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (documento)
  • Microsoft Works (sett., 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 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 includi (+) 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 aggiungere "+" (un segno più) alla parola o alla frase che deve essere inclusa in tutti i risultati di ricerca.

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

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

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

Il termine di query allinlinks: richiede che i documenti nei risultati di ricerca contengano tutte le parole della query di ricerca nei link URL. Il formato della query di ricerca deve essere allinlinks: seguito dalle parole contenute nella query.

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

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

Ricerca per frase
Descrizione

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

La versione di " (virgolette) con URL in formato escape è %22.

Le ricerche per frase sono particolarmente utili se cerchi citazioni famose o nomi propri.

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

Ricerca di solo testo, tutti i termini [allintext:]
Descrizione

Il termine di query allintext: richiede che ogni documento nei risultati di ricerca contenga tutte le parole della query di ricerca nel corpo del documento. Il formato della query deve essere allintext: seguito dalle parole contenute nella query di ricerca.

Se la tua query di ricerca include il termine di query allintext:, Google controllerà solo il corpo del testo dei documenti per trovare le parole nella tua query di ricerca, ignorando i link in tali documenti, nei titoli dei documenti e negli URL dei documenti.

La versione di allintext: con URL con caratteri di escape è allintext%3A.
Esempi Questo esempio specifica che le parole "Google" e "ricerca" devono apparire nel corpo di tutti i documenti inclusi nei risultati di ricerca:
Input utente:allintext:Google search
Termine query:q=allintext%3AGoogle+search

Ricerca del titolo, singolo termine [intitle:]
Descrizione

Il termine di query intitle: limita i risultati di ricerca ai documenti che contengono una parola specifica nel titolo del documento. La query di ricerca deve essere formattata come intitle:WORD senza spazi tra il termine di query intitle: e la parola seguente.

Nota: puoi specificare più di una parola da includere nel titolo del documento inserendo il termine di query intitle: davanti a ogni parola. Puoi anche utilizzare il termine di query allintitle: per specificare che tutte le parole della query devono essere incluse nei titoli dei documenti che si trovano nei risultati di ricerca.

La versione di intitle: con URL con caratteri di escape è intitle%3A.
Esempi

In questo esempio, la parola "Google" deve comparire nei titoli di qualsiasi documento e la parola "ricerca" deve apparire ovunque all'interno dei titoli, degli URL, dei link o del corpo del testo di questi documenti:
Input utente:intitle:Google search
Termine della query:q=intitle%3AGoogle+search

Ricerca di titoli, tutti i termini [allintitle:]
Descrizione

Il termine di query allintitle: limita i risultati di ricerca ai documenti che contengono tutte le parole della query nel titolo del documento. Per utilizzare il termine di query allintitle:, includi "allintitle:" all'inizio della query di ricerca.

Nota: l'inserimento di allintitle: all'inizio di una query di ricerca equivale a inserire intitle: davanti a ogni parola nella query di ricerca.

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

In questo esempio, le parole "Google" e "ricerca" devono comparire nei titoli di qualsiasi documento visualizzato nei risultati di ricerca:
Input utente: allintitle: Google search
Termine della query: q=allintitle%3A+Google+search

Ricerca URL, singolo termine [inurl:]
Descrizione

Il termine di query inurl: limita i risultati di ricerca ai documenti che contengono una determinata parola nell'URL del documento. La query di ricerca deve essere formattata come inurl:WORD senza spazi tra il termine di query inurl: e la parola seguente.

Il termine di query inurl: ignora la punteggiatura e utilizza solo la prima parola che segue l'operatore inurl:. Puoi specificare più di una parola da includere nell'URL del documento inserendo il termine di query inurl: davanti a ogni parola. Puoi anche utilizzare il termine di query allinurl: per specificare che tutte le parole della query devono essere incluse negli URL dei documenti presenti nei risultati di ricerca.

La versione di inurl: con URL con caratteri di escape è inurl%3A.
Esempi

In questo esempio, la parola "Google" deve comparire negli URL di qualsiasi documento nei risultati di ricerca e la parola "ricerca" deve apparire ovunque all'interno dei titoli, degli URL, dei link o del corpo del testo di questi documenti:
Input utente: inurl:Google search
Termine della query: q=inurl%3AGoogle+search

Ricerca URL, tutti i termini [allinurl:]
Descrizione

Il termine di query allinurl: limita i risultati di ricerca ai documenti che contengono tutte le parole della query nell'URL del documento. Per utilizzare il termine di query allinurl:, includi allinurl: all'inizio della query di ricerca.

Il termine di query allinurl: ignora la punteggiatura, quindi funziona solo sulle parole, non sui componenti dell'URL. Ad esempio, allinurl: uk/scotland limiterà i risultati ai documenti che contengono le parole "uk" e "scotland" nei propri URL, ma non richiederà che queste due parole siano visualizzate in un ordine particolare o che siano separate da una barra.

La versione di allinurl: con URL con caratteri di escape è allinurl%3A.
Esempi

In questo esempio, le parole "Google" e "ricerca" devono comparire negli URL di qualsiasi documento nei risultati di ricerca:
Input utente: allinurl: Google search
Termine della query: q=allinurl%3A+Google+search


Informazioni sul documento web [info:]
Descrizione

Il termine di query info: recupera informazioni generali su un URL, a condizione che l'URL 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 di info: con URL con caratteri di escape è info%3A.

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

Query immagine di esempio

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

Questa richiesta chiede i primi cinque risultati (start=0&num=5) per il termine di query "scimmia" (q=monkey), di tipo file .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 di 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 (piccola)
  • small|medium|large|xlarge (media)
  • 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 (volto)
  • lineart (lineare)
  • 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 che segue elenca le limitazioni relative alle richieste di ricerca inviate a Google:

Componente Limite Commento
Durata 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, devi inviare più richieste e incrementare il valore del parametro start con ogni richiesta.

Internazionalizzazione di query e presentazione dei risultati

Il servizio Ricerca Google 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 (usando i parametri di ricerca ie e oe). Puoi anche filtrare i risultati per includere solo documenti scritti in determinate lingue.

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

Codifica dei caratteri

I server inviano dati, ad esempio le pagine web, agli user agent, ad esempio i browser, sotto forma di sequenza di byte codificati. Lo user agent decodifica quindi 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) per entrambi i parametri ie e oe.

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

Per informazioni più generali sulla codifica dei caratteri, consulta 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 potrebbe influire sui risultati di ricerca XML, in particolare in caso di query internazionali in cui la limitazione della lingua (utilizzando il parametro lr) non è specificata esplicitamente. In questi casi, il parametro hl può promuovere i risultati di ricerca nella stessa lingua di quella di input dell'utente.

Ti suggeriamo di impostare esplicitamente il parametro hl nei risultati di ricerca per assicurarti che Google selezioni i risultati di ricerca della massima qualità per ogni query.

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

Ricerca di documenti scritti in lingue specifiche

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

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

I seguenti esempi 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 in ceco:

lr=(-lang_hu).(-lang_cs)

Consulta la sezione Valori raccolta lingua per un elenco completo dei possibili valori per il parametro lr e la sezione Operatori booleani per una discussione completa sull'uso di questi operatori.

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 utilizzare questa funzione, procedi nel seguente modo:

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

L'esempio seguente mostra i parametri di query che dovresti includere in una richiesta di risultati in cinese semplificato e tradizionale. Tieni presente che le informazioni aggiuntive richieste, come il client, 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 generalmente considerati 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 di quel sito oppure mostrare i risultati più in basso
    nel ranking rispetto a quanto sarebbe stato altrimenti.

Ti consigliamo di lasciare attivi questi filtri per le richieste di ricerca standard, poiché i filtri migliorano notevolmente 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 master di tutti i documenti web. L'indice principale contiene sottoraccolte di documenti raggruppati in base a determinati attributi, tra cui lingua e 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.

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

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


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

La Ricerca Google determina il paese di un documento analizzando:

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

Consulta anche la definizione del parametro cr e dei valori della raccolta paesi che possono essere utilizzati come valori per il parametro cr per maggiori informazioni sulla limitazione dei risultati per paese di origine.

Nota: puoi combinare i valori delle lingue e dei paesi per personalizzare i risultati di ricerca. Ad esempio, potresti richiedere documenti scritti in francese e provenienti dalla Francia o dal Canada, oppure documenti che provengono dall'Olanda e non sono scritti in inglese. I parametri lr e cr supportano entrambi gli operatori booleani.

Filtrare i contenuti per adulti con SafeSearch

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

Google si impegna a mantenere SafeSearch il più possibile aggiornato e completo attraverso la scansione continua del web e incorporando aggiornamenti dai suggerimenti degli utenti.

SafeSearch è disponibile nelle seguenti lingue:

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

Puoi modificare il livello di filtro con cui Google filtra i risultati per contenuti per adulti utilizzando il parametro di ricerca safe. La tabella seguente illustra le impostazioni SafeSearch di Google e il modo in cui influiranno su di esse sui risultati di ricerca:

Livello SafeSearch Descrizione
high Abilita una versione più rigida di SafeSearch.
media Blocca le pagine web che includono pornografia e altri contenuti espliciti di natura sessuale.
off Non filtra i contenuti per adulti nei risultati di ricerca.

* L'impostazione predefinita di SafeSearch è disattivata.

Se hai attivato SafeSearch e nei tuoi risultati trovi siti che includono contenuti offensivi, invia un'email all'URL del sito all'indirizzo safesearch@google.com ed effettueremo accertamenti sul 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 dei tag e degli attributi sono applicabili a tutti i tipi di ricerca. Alcuni tag, tuttavia, sono applicabili solo per determinati tipi di ricerca. Di conseguenza, le definizioni nella DTD potrebbero essere meno restrittive rispetto a quelle fornite in questo documento.

Questo documento descrive questi aspetti della DTD che sono pertinenti per la Ricerca Google. Quando esamini la DTD, se lavori su WebSearch, puoi tranquillamente ignorare i tag e gli attributi che non sono documentati qui. Se la definizione è diversa tra DTD e documentazione, questo fatto è indicato nel presente documento.

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

Inoltre, non devi configurare il tuo parser XML per recuperare il DTD ogni volta che invii una richiesta di ricerca. Google aggiorna le DTD raramente e queste richieste creano inutili requisiti di ritardo e larghezza di banda.

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 alla versione più recente di DTD all'indirizzo http://www.google.com/google.dtd.

Tieni presente che al momento non tutte le funzioni della DTD possono essere disponibili o supportate.

Informazioni sulla risposta XML

  • Tutti i valori dell'elemento sono codice HTML valido, adatto alla visualizzazione, salvo diversa indicazione nelle definizioni dei tag XML.
  • Alcuni valori degli elementi sono URL che devono essere codificati in HTML prima di essere visualizzati.
  • Il parser XML dovrebbe ignorare tag e attributi non documentati. Ciò consente all'applicazione di continuare a funzionare senza modifiche se Google aggiunge altre funzionalità all'output XML.
  • Alcuni caratteri devono essere preceduti da caratteri di escape quando sono inclusi come valori nei tag XML. Il processore XML dovrebbe riconvertire queste entità nei caratteri appropriati. Se non converti correttamente le entità, il browser potrebbe, ad esempio, visualizzare il carattere & come "&amp;". Lo standard XML documenta questi caratteri, che sono riprodotti nella tabella seguente:

    Basato su caratteri Moduli con caratteri 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), ovvero la parola "calcio" 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 restituisce il risultato XML riportato di seguito. Tieni presente che il risultato XML contiene diversi commenti per indicare il punto in cui vengono 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 normali e per le richieste di ricerca avanzata utilizzano entrambe lo stesso insieme di tag XML. Questi tag XML sono mostrati nell'esempio XML riportato sopra e sono spiegati nelle tabelle seguenti.

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

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

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

anchor_text
Definizione

Il tag <anchor_text> specifica il testo da mostrare agli utenti per identificare un'etichetta di perfezionamento associata a un set di risultati di ricerca. Poiché le etichette di perfezionamento sostituiscono i caratteri non alfanumerici con trattini bassi, non dovresti visualizzare il valore del tag <label> nell'interfaccia utente. Dovresti invece visualizzare 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 include i contenuti di un blocco nel corpo del risultato di una promozione. Ogni blocco include 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 anchor text nel sottotag L).
Sottotag 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 promosso. Ogni riga del corpo è composta da diversi tag BLOCK, che contengono del testo o un link con URL e anchor text.
Sottotag BLOCCA*
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 del risultato 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") Indica 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:escapeURL

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 fa riferimento a una pagina in lingua cinese tradizionale. Questo tag viene visualizzato solo quando è attiva la ricerca in cinese semplificato e tradizionale. Consulta la definizione del parametro di query c2coff per ulteriori informazioni su come abilitare e disabilitare questa funzionalità.
Formato dei contenuti Testo

Contesto
Definizione

Il tag <Context> include un elenco di etichette di perfezionamento associate a un insieme di risultati di ricerca.
Esempio <Context>
Sottotag 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

D
Definizione

Il tag <DI> include informazioni sulla categoria Open Directory Project (ODP) relative a un singolo risultato di ricerca.
Esempio <DI>
Sottotag DT?, DS?
Sottotag di HAS
Formato dei contenuti Vuoto

DS
Definizione

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

DT
Definizione

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

Facet
Definizione

Il tag <Facet> contiene un raggruppamento logico di tag <FacetItem>. Puoi creare questi raggruppamenti utilizzando il formato delle specifiche XML di 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> saranno raggruppati a scopo di visualizzazione, ma potrebbero non avere una relazione logica.
Esempio <Facet>
Sottotag 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>
Sottotag etichetta, anchor_text+
Sottotag di Facet
Formato dei contenuti FacetItem

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

PSG
Definizione

Il tag <GSP> racchiude 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 della ricerca. L'attuale versione dell'output è "3.2".
Esempio <GSP VER="3.2">
Sottotag PARAM+, Q, RES?, [TM]
Formato dei contenuti Vuoto

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

Nota: la definizione di <HAS> per la Ricerca Web è più restrittiva rispetto alla definizione di DTD.

Sottotag DI?, E?, C?, RT?
Sottotag di R

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

L
Definizione La presenza del tag <L> indica che il servizio WebSearch può trovare altri siti che rimandano a questo URL del 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 richiesta HTTP a Google, come mostrato nell'esempio seguente. Tieni presente che questo valore deve contenere caratteri di escape dell'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 corrisponde al tag <Label>, che identifica un'etichetta di perfezionamento associata a un determinato URL nei risultati di ricerca.
Esempio <label>corsi_golf</label>
Sottotag di FacetItem
Formato dei contenuti Testo

lang
Definizione

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

L
Definizione

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

Nota: questa stima potrebbe non essere precisa.

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

Neonato
Definizione

Il tag <NB> include informazioni di navigazione relative all'insieme di risultati, ovvero rimanda alla pagina successiva o precedente dei risultati di ricerca.

Nota: questo tag è presente solo se sono disponibili più risultati.
Esempio <NB>
Sottotag 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=fiori&num=10&hl=it&ie=UTF-8
&output=xml&client=test&start=10</NU>
Sottotag di NB
Formato dei contenuti Testo (URL relativo)

PARAMETRO
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 (name, value, original_value) e sarà presente un tag PARAM per ogni parametro inviato nella richiesta HTTP.
Attributi
Nome Formato Descrizione
name Testo Nome del parametro di input.
value HTML Versione in formato HTML del valore del parametro di input.
original_value Testo Versione originale con caratteri di escape del valore del parametro di input.
Esempio <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Sottotag di SPG
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=it&output=xml
&client=test&start=10</PU>
Sottotag di NB
Formato dei contenuti Testo (URL relativo)

D
Definizione

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

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

R
Definizione

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

Nota: la definizione del tag <R> per la Ricerca Google è più restrittiva rispetto alla definizione del tag 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.
Sottotag U, UE, T?, CRAWLDATE, C?, LING?, HAS
Sottotag di RES

RES
Definizione

Il tag <RES> include l'insieme di singoli risultati di ricerca e i relativi dettagli.
Attributi
Nome Formato Descrizione
SN Testo (numero intero) Indica l'indice (in base 1) del primo risultato di ricerca restituito in questo set di risultati.
EN 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">
Sottotag M, FI?, XT?, NB?, R*
Sottotag di SPG
Formato dei contenuti Vuoto

S
Definizione

Il tag <S> contiene un estratto di un risultato di ricerca che mostra i termini di query evidenziati in grassetto. Le interruzioni di riga sono incluse nell'estratto per un corretto ritorno a capo.
Esempio <S>Washington (CNN) - La proposta di porre fine alla situazione di stallo del Senato nei confronti del Presidente &lt;b&gt;Bush&#39;s&lt;/b&gt; scelte giudiziarie consentirebbe a cinque candidati di passare a un voto finale preservando la
Sottotag di R
Formato dei contenuti Testo (HTML)

SL_MAIN
Definizione

Questo tag racchiude i contenuti del risultato di una promozione. Da utilizzare per l'analisi delle promozioni. L'anchor text e l'URL del link del titolo sono contenuti rispettivamente nei sottotag T e U. Le righe del corpo del testo e dei link sono contenute nei sottotag BODY_LINE.
Sottotag BODY_LINE*, T, U
Sottotag di SL_RESULTS
Formato dei contenuti Vuoto

SL_RESULTS
Definizione

Tag contenitore per i risultati promossi. Una di queste verrà visualizzata ogni volta che è presente una promozione nei risultati di ricerca. Il sottotag SL_MAIN contiene i dati dei risultati principali.
Sottotag SL_MAIN*
Sottotag di R
Formato dei contenuti Vuoto

Ortografia
Definizione

Il tag <Spelling> contiene 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 è scritto in lettere minuscole.
Esempio <Spelling>
Sottotag Suggerimento
Sottotag di SPG
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 la grafia alternativa all'utente che effettua la ricerca. Il valore dell'attributo q è il suggerimento ortografico con escape dell'URL che puoi utilizzare come termine di query.
Attributi
Nome Formato Descrizione
q Testo L'attributo q specifica la versione URL con caratteri di escape del suggerimento ortografico.
Esempio <Suggerimento q="soccer">&lt;b&gt;&lt;i&gt;calcio&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>Pizzeria di Amici's East Coast</T>
Sottotag di R
Formato dei contenuti Testo (HTML)

title
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 facet.
Esempio

In quanto elemento secondario di <Context>: <title>My Search Engine</title>

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

TM
Definizione

Il tag <TM> identifica il tempo totale impiegato dal server per restituire i risultati di ricerca, misurato in secondi.
Esempio <TM>0,100445</TM>
Sottotag di SPG
Formato dei contenuti Testo (numero con 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, la pressione del tasto Invio produce gli stessi risultati di un clic sul pulsante Cerca.&lt;/i&gt;</TT>
Sottotag di SPG

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 (International Domain Name) del risultato di ricerca. Il valore consente di visualizzare i domini nelle lingue locali. Ad esempio, l'URL con codifica 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 includevano 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 contiene caratteri di escape dell'URL per poterlo trasmettere come parametro di ricerca in un URL.
Esempio <UE>http://www.dominos.com/</UE>
Sottotag di R
Formato dei contenuti Testo (URL con caratteri di escape)

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


Risultati XML per le query di ricerca di immagini

In questa richiesta di immagine di esempio vengono richiesti 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 restituisce 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 i tag XML aggiuntivi utilizzati nelle risposte XML per le query di ricerca di immagini.

Nelle definizioni riportate di seguito potrebbero essere visualizzati alcuni simboli accanto ad alcuni sottotag. 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> include i dettagli di un risultato di ricerca di una singola immagine.
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 <tag RU> include i dettagli di ogni risultato di ricerca di immagini.
Sottotag di R