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 della richiesta
• Termini di query
• Parametri di richiesta
• Query di ricerca web di esempio
• Definizioni dei parametri di query di WebSearch
• Query di esempio per le immagini
• Query di ricerca di immagini Definizioni dei parametri
• Ricerca avanzata
  
• Parametri di query della ricerca avanzata
• Termini di query speciali
• Limiti per le richieste

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

    <!DOCTYPE GSP SYSTEM "google.dtd">

Ricerca avanzata

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

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.

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

Limiti per le richieste

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

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
• Lingue dell'interfaccia
• Ricerca in cinese semplificato e tradizionale

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.

Ricerca in cinese semplificato e tradizionale

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
• Filtro per lingua e paese
• Filtrare i contenuti per adulti con SafeSearch

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:

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:

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
• Informazioni sulla risposta XML
• XML Risultati per query di ricerca regolari e avanzate
• Ricerca normale/avanzata: query di esempio e risultato XML
• Ricerca normale/avanzata: tag 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 "&". Questi caratteri sono documentati negli standard XML e sono riprodotti nella tabella seguente:

  Personaggio	Moduli di escape	Entità	Codice carattere
  E commerciale	&	&	&
  Virgolette semplici	'	'	'
  Virgolette doppie	"	"	"
  Maggiore di	>	>	>
  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:

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

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: