Riferimento API XML

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

1. Panoramica
2. Formato di richiesta di Motore di ricerca programmabile
   .
   1. Panoramica della richiesta
   2. Termini per le query
   3. Parametri della richiesta
      .
      1. Esempi di query di WebSearch
      2. Definizioni dei parametri di query di WebSearch
      3. Ricerca avanzata
      4. Parametri delle query di ricerca avanzata
      5. Termini speciali per le query
      6. Query immagine di esempio
      7. Parametri delle query di ricerca 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. Filtrare i 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 risultati XML Google
   2. Informazioni sulla risposta XML
   3. Risultati XML per Normali, Illustrati e Query di ricerca avanzate
      .
      1. Ricerca regolare/avanzata: query di esempio e risultato XML
      2. Ricerca regolare/avanzata: tag XML
      3. Risultati XML per le query di ricerca immagini
      4. Ricerca immagini: query di esempio e risultato XML
      5. Ricerca immagini: tag XML

Panoramica

Il servizio Google WebSearch attiva Google Site Search ai clienti di visualizzare i risultati di ricerca di Google sui propri siti web. La Il servizio WebSearch utilizza un semplice protocollo basato su HTTP per gestire la ricerca che consentono di analizzare i dati e visualizzare i risultati. Gli amministratori della Ricerca hanno il controllo completo sul modo in cui richiedere i risultati di ricerca e il modo in cui li presentano per l'utente finale. Questo documento descrive i dettagli tecnici del richiesta di ricerca e formati dei risultati.

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

Formato richiesta WebSearch

• Richiedi Panoramica
• Termini per le query
• Parametri della richiesta
• Esempi di query di WebSearch
• Query di WebSearch Definizioni dei parametri
• Query immagine di esempio
• Query di ricerca immagini Definizioni dei parametri
• Ricerca avanzata
  
• Ricerca avanzata Parametri di query
• Termini speciali per le query
• Limiti per le richieste

Panoramica richiesta

La richiesta di ricerca su Google è un comando HTTP GET standard. it include una raccolta di parametri pertinenti query. Questi parametri sono inclusi nell'URL della richiesta come name=value in coppie separate da e commerciali (&). I parametri includono come la query di ricerca e un ID motore univoco (cx) che identifica che effettua la richiesta HTTP. Il servizio WebSearch o Ricerca immagini restituisce Il formato XML restituisce una 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 query viene visualizzato come valore di un parametro nella richiesta di ricerca.

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

• Parole o frasi da includere o escludi
  .
  • Tutte le parole di una query di ricerca (impostazione predefinita)
  • Una frase esatta nella query di ricerca
  • Qualsiasi parola o frase in una query di ricerca
• Dove in un documento cercare il termini di ricerca
  .
  • In qualsiasi punto del documento (impostazione predefinita)
  • Solo nel corpo del documento
  • Solo nel titolo del documento
  • Solo nell'URL del documento
  • Solo nei link nel 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, 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 delle query di ricerca devono contenere caratteri di escape per l'URL. Tieni presente che sostituisce il segno più ("+") con qualsiasi sequenza di spazi vuoti la query di ricerca. Questo argomento verrà discusso più in dettaglio nella sezione Escatting degli URL del presente documento.

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

q=horses+cows+pigs

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

Parametri richiesta

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

Sono richiesti tre parametri di richiesta:

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

I parametri di richiesta più utilizzati, diversi da quelli di cui sopra:

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

Esempi di query WebSearch

Gli esempi di seguito mostrano un paio di richieste HTTP di WebSearch a illustrano come vengono usati i diversi parametri di query. Definizioni per Nel WebSearch Query sono disponibili parametri di query diversi Definizioni dei parametri e la Query di ricerca avanzata Parametri di questo documento.

Questa richiesta richiede i primi 10 risultati (start=0&num=10) per il termine di query "red sox" (q=red+sox). La query specifica che i risultati devono provenire da siti web canadesi (cr=countryCA) e devono essere scritte in francese (lr=lang_fr). Infine, la query specifica i valori per client, output, e cx, che sono 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 termini di ricerca avanzata per personalizzare ulteriormente la query di ricerca. Questa richiesta utilizza as_q (as_q=red+sox) anziché il parametro q. Utilizza anche Parametro as_eq per escludere eventuali documenti contenenti la parola "Yankees" dal 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 query di WebSearch

    <!DOCTYPE GSP SYSTEM "google.dtd">

Ricerca avanzata

Gli altri parametri di ricerca 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 nella query termini per la ricerca. L'immagine mostra la pagina Ricerca avanzata di Google. Nell'immagine, il nome di ogni il parametro di ricerca avanzata è scritto in testo rosso all'interno o accanto a al campo della pagina a cui corrisponde tale parametro.

Parametri delle query di ricerca avanzata

Termini speciali

La Ricerca Google consente l'utilizzo di vari termini di query speciali che accedere a funzionalità aggiuntive del motore di ricerca Google. Questi È necessario includere termini di query speciali nel valore del parametro di richiesta q. Come per altri termini di query, termini di query speciali devono essere con caratteri di escape nell'URL. R di termini di query speciali contiene i due punti (:). Questo carattere devono inoltre contenere caratteri di escape nell'URL; il suo valore con escape URL è %3A.

Esempi di query immagine

Gli esempi riportati di seguito mostrano un paio di richieste HTTP immagine per illustrare l'utilizzo dei 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 riguarda i primi 5 risultati (start=0&num=5) per il termine di query "scimmia" (q=monkey), di tipo file .png. Infine, la query specifica i valori dei 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 delle query di ricerca immagini

Limiti per le richieste

Il grafico seguente elenca le limitazioni relative alle richieste di ricerca che invia a Google:

Internazionalizzazione della presentazione di query e risultati

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

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

• Carattere Codifica
• Lingue dell'interfaccia
• Cinese semplificato e tradizionale Ricerca

Codifica dei caratteri

I server inviano dati, ad esempio le pagine web, agli user agent come come una sequenza di byte codificati. Lo user agent decodifica quindi i byte in una sequenza di caratteri. Quando si inviano richieste WebSearch, puoi specificare gli schemi di codifica per i tuoi query di ricerca e 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 utilizza anche il parametro oe per specificare la codifica che Google deve utilizzare per codificare la tua risposta XML. Se utilizzando 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 funzionalità di ricerca per più lingue diverse, consigliamo di utilizzare il valore di codifica utf8 (UTF-8) per entrambi i parametri ie e oe.

Fai riferimento alla sezione Caratteri Schemi di codifica per un elenco completo dei valori che che puoi utilizzare per i parametri ie e oe.

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

Lingue dell'interfaccia

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

Ti suggeriamo di impostare esplicitamente il parametro hl nei risultati di ricerca per fare in modo che Google selezioni la qualità risultati di ricerca per ogni query.

Consulta l'interfaccia supportata Lingue 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 limita i risultati di ricerca a documenti scritti in un particolare lingua o insieme di lingue.

Il parametro lr supporta gli operatori booleani per consentire di specificare più lingue da includere (o escludere) dalla ricerca che consentono di analizzare i dati e visualizzare i risultati.

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 ceco:

lr=(-lang_hu).(-lang_cs)

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

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 ciascuna variante. Data una query in una delle varianti, Google Il servizio Ricerca Google può restituire risultati che includono pagine in varianti di prodotto.

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 query che includeresti in una richiesta di risultati sia in cinese semplificato che tradizionale. Tieni presente che le informazioni aggiuntive richieste, come client, non è incluso 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 la ricerca risultati:

• Automatico Filtrare i risultati di ricerca
• Filtri per lingua e paese
• Filtrare i contenuti per adulti con SafeSearch

Filtro automatico dei risultati di ricerca

Nel tentativo di fornire i migliori risultati di ricerca possibili, Google utilizza due tecniche per filtrare automaticamente i risultati di ricerca generalmente considerati indesiderati:

• Contenuti duplicati: se più documenti contengono i seguenti elementi: le stesse informazioni, solo il documento più pertinente incluse nei tuoi risultati di ricerca.

• Crowding degli host: se esistono molti risultati di ricerca provenienti dal stesso sito, Google potrebbe non mostrare tutti i risultati di tale sito o mostra i risultati più in basso a
  rispetto al passato.

Ti consigliamo di lasciare attivi questi filtri per le richieste di ricerca standard perché i filtri migliorano notevolmente la qualità della maggior parte dei risultati che consentono di analizzare i dati e visualizzare i risultati. Tuttavia, puoi ignorare questi filtri automatici impostando il parametro di query filter su 0 nel tuo 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 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 in determinati paesi.

La Ricerca Google determina la lingua di un documento analizzando:

• 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

Consulta anche la definizione del parametro lr, la sezione sulla ricerca di Documenti scritti in lingue specifiche e i valori della raccolta linguistica 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,

Vedi anche la definizione del parametro cr e la Raccolta del paese Valori che possono essere utilizzati come valori per il parametro cr per ulteriori informazioni sulla limitazione dei risultati per paese di origine dati.

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

Filtrare i contenuti per adulti con SafeSearch

Molti clienti Google non desiderano mostrare risultati di ricerca per siti che includono contenuti per adulti. Con il nostro filtro SafeSearch, puoi filtrare per 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 rimuove la stragrande maggioranza dei contenuti per adulti dalla ricerca che consentono di analizzare i dati e visualizzare i risultati.

Google si impegna a mantenere SafeSearch aggiornato e completo possibili eseguendo continuamente la scansione del Web e incorporando aggiornamenti dai suggerimenti degli utenti.

SafeSearch è disponibile nelle seguenti lingue:

Puoi modificare la misura in cui Google filtra i risultati per contenuti per adulti utilizzando il parametro di query safe. La tabella seguente illustra le impostazioni SafeSearch di Google e il modo in cui influiranno sui risultati di ricerca:

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

Risultati XML

• XML di Google DTD risultati
• Informazioni sulla risposta XML
• XML Risultati per query di ricerca normali e avanzate
• Ricerca regolare/avanzata: query di esempio e XML Result
• Ricerca regolare/avanzata: tag XML

Google XML Risultati DTD

Google utilizza lo stesso DTD per descrivere il formato XML per tutti i tipi di risultati di ricerca. Molti dei tag e attributi sono applicabili a tutte tipi di ricerca. Alcuni tag, tuttavia, sono applicabili solo per determinati tipi di ricerca. Di conseguenza, le definizioni nella DTD possono essere restrittive rispetto alle definizioni contenute nel presente documento.

Il presente documento descrive gli aspetti della DTD che sono pertinenti per la Ricerca Google. Quando osservi il file DTD, se stai lavorando Ricerca Google, puoi tranquillamente ignorare tag e attributi che non sono documentati qui. Se la definizione differisce tra il DTD e il documentazione, questo fatto è osservato nel presente documento.

Google può restituire risultati XML con o senza riferimento a la DTD più recente. Il DTD è una guida per aiutare gli amministratori nella ricerca e i parser XML comprendono i risultati XML di Google. Poiché il linguaggio XML di Google la grammatica può cambiare di tanto in tanto, non devi configurare analizzatore sintattico di utilizzare il DTD per convalidare ogni risultato XML.

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

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

Tieni presente che al momento non tutte le funzioni nella DTD sono disponibili o supportate.

Informazioni sulla risposta XML

• Tutti i valori dell'elemento devono essere HTML validi e adatti alla visualizzazione, a meno che altrimenti indicato nelle definizioni dei tag XML.
• I valori di alcuni elementi sono URL che devono essere codificati in HTML prima vengono visualizzate.
• Il parser XML dovrebbe ignorare tag e attributi 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 preceduti dal carattere di escape se inclusi come valori in XML. Il tuo processore XML deve riconvertire queste entità nel formato i caratteri appropriati. Se non converti correttamente le entità, browser può, ad esempio, eseguire il rendering & come "&". Il file XML Lo standard documenta questi caratteri; questi caratteri sono riprodotti nella tabella seguente:

  Carattere	Moduli con caratteri di escape	Entità	Codice carattere
  E commerciale	&	&	&
  Virgolette semplici	'	'	'
  Virgolette doppie	"	"	"
  Maggiore di	>	>	>
  Minore di	<	&lt;	&#60;

Risultati XML per query di ricerca normali e avanzate

Ricerca regolare/avanzata: query di esempio e risultato XML

Questa richiesta di esempio nella Ricerca Google richiede 10 risultati (num=10) sul termine di ricerca "socer" (q=socer), che è la parola "calcio" scritto 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 ci sono diversi commenti nel risultato XML per indicare dove alcuni tag non incluse 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 regolare/avanzata: tag XML

Risposte XML per richieste di ricerca standard e ricerca avanzata usano entrambi lo stesso set di tag XML. Questi tag XML vengono mostrati l'esempio XML riportato sopra e spiegato nelle tabelle seguenti.

I tag XML di seguito sono elencati in ordine alfabetico per nome di tag e ognuno La definizione del tag contiene una descrizione del tag, un esempio che mostra l'aspetto del tag in un risultato XML e il formato contenuti. Se il tag è un sottotag di un altro tag XML o se il tag ha o attributi propri, queste informazioni sono fornite anche tabella di definizione del tag.

Alcuni simboli possono essere visualizzati accanto ad alcuni sottotag nella le definizioni seguenti. 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 immagine di esempio richiede 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 immagini.

Alcuni simboli possono essere visualizzati accanto ad alcuni sottotag nella le definizioni seguenti. Tali simboli sono riportati di seguito, insieme al relativo significato: