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

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

c2coff
Descrizione

Facoltativo. Il parametro c2coff attiva o disattiva la funzionalità Semplificata e ricerca in cinese tradizionale.

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

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

client
Descrizione

Required. Il parametro client deve essere impostato su google-csbe.

Esempi q=google&client=google-csbe

cr
Descrizione

Facoltativo. Il parametro cr limita i risultati di ricerca ai documenti che hanno origine in un di un determinato paese. Puoi usare gli strumenti booleani nel parametro cr valore.

La Ricerca Google determina il paese di un documento in base a analisi:

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

Consulta il parametro Paese (cr) Valori per un elenco di valori validi per questo parametro.

Esempi q=Frodo&cr=countryNZ

cx
Descrizione

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

Per trovare il valore del parametro cx, vai a Pannello di controllo > Codici del motore e la troverai nell'area di testo in "Incolla questo codice nella pagina in cui desideri che la casella di ricerca vengono visualizzate. I risultati di ricerca verranno mostrati in una pagina in hosting su Google".

Esempi q=Frodo&cx=00255077836266642015:u-scht7a-8i

filtro
Descrizione

Facoltativo. Il parametro filter attiva o disattiva il filtro automatico dei risultati di ricerca di Google. Consulta la sezione Filtro automatico di questo documento per ulteriori informazioni sui filtri dei risultati di ricerca di Google.

Il valore predefinito del parametro filter è 1, che indica che la funzionalità è attiva. Valori validi sono:

Valore Azione
1 Disabilitato
0 Attivato

Nota:per impostazione predefinita, Google applica i filtri a tutti risultati di ricerca per migliorare la qualità di questi risultati.

Esempi q=google&filter=0

gl
Descrizione

Facoltativo. Il valore del parametro gl è un il codice paese di due lettere. Per i risultati della Ricerca Google, il parametro gl potenzia i risultati di ricerca il cui paese di origine corrisponde alla . Consulta la sezione Codici paese per un elenco di valori validi.

Specifica di un valore parametro gl nelle richieste WebSearch dovrebbe migliorare la pertinenza dei risultati. Questo è in particolare è vero per i clienti internazionali e, più in particolare, per per i clienti in paesi anglofoni diversi dagli Stati Uniti.

Esempi

Questa richiesta promuove i documenti scritti nel Regno Unito in Risultati della Ricerca Google:
q=pizza&gl=uk


hl
Descrizione

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

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

Esempi

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

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

hq
Descrizione

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

Esempi

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

q=pizza&hq=cheese


ie
Descrizione

Facoltativo. Il parametro ie imposta il carattere schema di codifica da usare per interpretare la stringa di query. La Il valore predefinito di ie è latin1.

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

Consulta la sezione Codifica dei caratteri Sezione Schemi per l'elenco dei possibili valori ie.

Esempi q=google&ie=utf8&oe=utf8
lr
Descrizione

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

La Ricerca Google determina la lingua di un documento tramite analisi:

  • 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
  • lingue secondarie, se presenti, utilizzate nel corpo del testo del documento

Consulta la Lingua (lr) Sezione Valori della raccolta per un elenco di valori validi per questo .

Esempi q=Frodo&lr=lang_en

num
Descrizione

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

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

Nota:se il numero totale di risultati di ricerca è inferiore rispetto al numero di risultati richiesto, tutti i risultati di ricerca disponibili da restituire.

Esempi q=google&num=10

oe
Descrizione

Facoltativo. Il parametro oe imposta il carattere schema di codifica da usare per decodificare il risultato XML. La Il valore predefinito di oe è latin1.

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

Consulta la sezione Codifica dei caratteri Sezione Schemi per l'elenco dei possibili valori oe.

Esempi q=google&ie=utf8&oe=utf8

output
Descrizione

Required. Il parametro output specifica il formato dei risultati XML. L'unico valore i valori di questo parametro sono xml e xml_no_dtd. La la seguente tabella spiega le differenze tra questi valori parametro.

Valore Formato di output
xml_no_dtd I risultati XML non includeranno un Istruzione !DOCTYPE. (Opzione consigliata)
xml I risultati XML conterranno un'etichetta Google Riferimento DTD. La seconda riga del risultato identificherà il 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 ricerca query inserita dall'utente. Anche se questo parametro è facoltativo, Devi specificare un valore per almeno uno dei parametri di query (as_epq, as_lq, as_oq, as_q per ottenere i risultati di ricerca.

Esistono anche una serie di termini di query speciali utilizzato come parte del parametro q valore. Consulta la sezione Termini speciali per le query per un elenco e le definizioni di questi termini.

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

Nota: il valore specificato per il parametro q devono contenere caratteri di escape nell'URL.

Esempi q=vacation&as_oq=london+paris

sicuro
Descrizione

Facoltativo. Il parametro safe indica in che modo filtrare i risultati di ricerca per contenuti per adulti e contenuti pornografici. Il valore predefinito del parametro safe è off. Valori parametro validi sono:

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

Consulta la pagina Filtro dei contenuti per adulti con SafeSearch per maggiori dettagli su questa funzionalità.

Esempi q=adult&safe=high

start
Descrizione

Facoltativo. Il parametro start indica il primo risultato corrispondente che deve essere incluso nei risultati di ricerca. Il parametro start usa un indice in base zero, il che significa che il primo risultato è 0, il secondo risultato è 1 e così via.

Il parametro start funziona in congiunzione con il parametro num per determinare quali risultati di ricerca restituire. Tieni presente che per ogni query non verranno mai restituiti più di 1000 risultati, anche se più di 1000 documenti corrispondono alla query, quindi l'impostazione di un valore pari o superiore a 1000 non produrrà risultati.

Esempi start=10

ordinare
Descrizione

Facoltativo. Il parametro sort consente di specificare che i risultati vengono ordinati in base all'espressione specificata. Ad esempio, ordina per data.

Esempi

sort=date


ud
Descrizione

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

http://www.花井鮨.com

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

Se il parametro ud viene impostato su 0, l'URL dell'esempio precedente sarà visualizzato come:

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

Nota: questa è una funzionalità beta.

Esempi q=google&ud=1

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

as_dt
Descrizione

Facoltativo. Il parametro as_dt consente di stabilire se per includere o escludere i risultati dal sito indicato nel parametro as_sitesearch. La 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 un frase che tutti i documenti nei risultati di ricerca devono contenere. Puoi utilizza anche il termine di query di ricerca a frase per cerca una frase.

Esempi as_epq=abraham+lincoln

as_eq
Descrizione

Facoltativo. Il parametro as_eq identifica una parola o una frase che non deve apparire in nessun documento nella ricerca che consentono di analizzare i dati e visualizzare i risultati. Puoi anche utilizzare la query escludi per garantire che una determinata parola o frase non venga visualizzata nel documenti in 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. Puoi anche Utilizza il termine di query link: per questo tipo di query.

Esempi

as_lq=www.google.com


as_nlo
Descrizione

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

Esempi

Di seguito viene impostato un intervallo di ricerca compreso tra 5 e 10 inclusi:

as_nlo=5&as_nhi=10

as_nhi
Descrizione

Facoltativo. Il parametro as_nhi specifica valore finale per un intervallo di ricerca. Usa as_nlo e as_nhi per aggiungere un intervallo di ricerca compreso di as_nlo...as_nhi per la query.

Esempi

Di seguito viene impostato un intervallo di ricerca compreso tra 5 e 10 inclusi:

as_nlo=5&as_nhi=10

as_oq
Descrizione

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

Esempi

q=vacation&as_oq=London+Paris


as_q
Descrizione

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

Esempi

q=president&as_q=John+Adams


as_qdr
Descrizione

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

d[number] richiede i risultati per il numero specificato di giorni precedenti.
w[number] richiede i risultati per il numero specificato di settimane passate.
m[number] di richieste di risultati per il numero specificato di mesi precedenti.
Risultati di y[number] richieste per il numero specificato di anni precedenti.

Esempi

In questo esempio vengono richiesti i risultati dell'anno scorso:

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 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 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.

Link indietro [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 nel formato link:URL e non deve spaziare tra il termine di query link: e l'URL.

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

Puoi anche utilizzare la richiesta as_lq per inviare una richiesta link:.

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

Esempi

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


Ricerca booleana OR [ OPPURE ]
Descrizione

Il termine di query OR recupera i documenti che includono uno di una serie di (due o più) termini di query. Per usare la query OR termine, inserisci il termine di ricerca OR in maiuscolo tra un termine e l'altro della serie.

Puoi anche utilizzare la richiesta as_oq per eseguire una ricerca di un termine in un insieme di termini.

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

Esempi

Cerca Londra o Parigi:

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

Cerca vacanza e Londra o Parigi:

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

Cerca vacanza e una di Londra, Parigi o dei cioccolatini:

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

Cerca vacanze e cioccolatini e o Londra o Parigi, con il minor peso assegnato ai cioccolatini:

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

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

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

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

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

Escludi termine di query [-]
Descrizione

Il termine di query di esclusione (-) limita i risultati per un specifica richiesta di ricerca ai documenti che non contengono parola o frase specifica. Per utilizzare il termine di query escludi, prefigura la parola o la frase da escludere dai documenti corrispondenti con "-" (un segno meno).

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

Il termine di query di esclusione è utile quando un termine di ricerca ha più di un significato. Ad esempio, la parola "basso" potrebbe restituire risultati di pesce o musica. Se stavi cercando documenti su pesce, puoi escludere documenti relativi alla musica dai risultati di ricerca utilizzando il termine di query escludi.

Puoi anche utilizzare la richiesta as_eq per escludere i documenti che corrispondono a una parola o una frase specifica dai risultati di ricerca.

Esempi Input utente: bass -music
Termine della query: q=bass+%2Dmusic

Esclusione del tipo di file [ -filetype: ]
Descrizione

Il termine di query -filetype: esclude i documenti con un con una particolare estensione del file, ad esempio ".pdf" o ".doc" dalla ricerca che consentono di analizzare i dati e visualizzare i risultati. La query di ricerca deve essere nel formato -filetype:EXTENSION e non deve spaziare tra il termine di query -filetype: e dell'estensione specificata.

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

Nota: puoi escludere più tipi di file dai risultati di ricerca aggiungendo altre -filetype: query termini specifici per la query. Devi avere un termine di query -filetype: nella query di ricerca per ogni estensione del file da escludere 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, sett.2, sett.3, sett4, sett.5, wki, sett., wku)
  • Lotus WordPro (LWP)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (documento)
  • Microsoft Works (wks, wps, wdb)
  • Scrittura Microsoft (wri)
  • Rich Text Format (rtf)
  • Flash Shockwave (SDF)
  • Testo (ans, txt).

In futuro potrebbero essere aggiunti altri tipi di file. Un modello di progettazione disponibile nelle Domande frequenti sui tipi di file di Google.

Esempi

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

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


Filtro del tipo di file [ filetype: ]
Descrizione

Il termine di query filetype: limita i risultati di ricerca a documenti con una particolare estensione di file, ad esempio ".pdf" o ".doc". La query di ricerca deve essere nel formato filetype:EXTENSION con nessuno spazio tra il termine di query filetype: e il valore specificato .

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

Puoi limitare la ricerca ai documenti che corrispondono a una delle varie estensioni di file aggiungendo più filetype: termini di query alla tua query. Dovresti avere un termine di query filetype: nella query di ricerca per ogni estensione del file da includere nei risultati di ricerca. Separare più termini di query filetype: nel termine OR.

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

I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Loto 1-2-3 (sett.1, sett.2, sett.3, sett4, sett.5, wki, sett., wku)
  • Lotus WordPro (LWP)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (documento)
  • Microsoft Works (wks, wps, wdb)
  • Scrittura Microsoft (wri)
  • Rich Text Format (rtf)
  • Flash Shockwave (SDF)
  • Testo (ans, txt).

In futuro potrebbero essere aggiunti altri tipi di file. Un modello di progettazione disponibile nelle Domande frequenti sui tipi di file di Google.

Esempi

Questo esempio restituisce documenti PDF che contengono la parola "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 include (+) specifica che una parola o una frase devono essere presenti in tutti i documenti inclusi nei risultati di ricerca. Per utilizzare includi il termine di ricerca, dovresti precedere la parola o la frase che deve essere incluso in tutti i risultati di ricerca con "+" (un segno più).

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

Dovresti usare + prima di una parola comune che Google di solito ignora prima di identificare i risultati di ricerca.

Esempi Input utente: Star Wars Episode +I
Termine della query: q=Star+Wars+Episode+%2BI

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

Il termine di query allinlinks: richiede documenti in risultati di ricerca per contenere tutte le parole nella query di ricerca in URL . Il formato della query di ricerca deve essere allinlinks: seguito dalle parole della query di ricerca.

Se la tua query di ricerca include la query allinlinks: termine, Google controlla solo i link URL nei documenti per verificare la presenza nella query di ricerca, ignorando l'altro testo nei documenti, titoli e URL di ogni documento. Tieni presente che il documento L'URL è diverso dall'URL dei link contenuti nel documento.

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

Esempi Input utente:allinlinks: Google search
Termine della query:q=allinlinks%3A+Google+search

Ricerca per frase
Descrizione

Il termine di query per la ricerca a frase (") ti consente di cercare le frasi complete racchiudindole tra virgolette o collegandoli con i trattini.

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

La ricerca per frase è particolarmente utile se stai cercando per citazioni famose o nomi propri.

Puoi anche utilizzare la richiesta as_epq per inviare una ricerca per frase.

Esempi Input utente:"Abraham Lincoln"
Termine della query: q=%22Abraham+Lincoln%22

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

Il termine di query allintext: richiede che ogni documento in i risultati di ricerca in modo che contengano tutte le parole nella query di ricerca il corpo del documento. Il formato della query deve essere allintext: seguito dalle parole della query di ricerca.

Se la tua query di ricerca include la query allintext: termine, Google controllerà solo nel corpo del testo dei documenti nella query di ricerca, ignorando i link in quei documenti, titoli e URL dei documenti.

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

Esempi Questo esempio specifica che le parole "Google" e "cerca" devono apparire nel corpo di tutti i documenti inclusi nei risultati di ricerca:
Input utente:allintext:Google search
Termine di query:q=allintext%3AGoogle+search

Ricerca di titoli, singolo termine [intitle:]
Descrizione

Il termine di query intitle: limita i risultati di ricerca a documenti che contengono una determinata parola nel titolo. La la query di ricerca deve essere nel formato intitle:WORD senza spazio tra il termine di query intitle: e la parola seguente.

Nota: puoi specificare ulteriori di una parola che deve essere inclusa nel titolo del documento mettendo il termine di query intitle: davanti a ogni parola di questo tipo. Puoi utilizza anche il termine di query allintitle: per specifica che tutte le parole della query devono essere incluse nei titoli documenti presenti nei risultati della ricerca.

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

Esempi

Questo esempio specifica che la parola "Google" devono apparire in: i titoli di qualsiasi documento nei risultati di ricerca e la parola "cerca" devono apparire in qualsiasi punto di titoli, URL, link o corpo del testo di questi documenti:
Input utente:intitle:Google search
Termine di query:q=intitle%3AGoogle+search


Ricerca del titolo, tutti i termini [allintitle:]
Descrizione

Il termine di query allintitle: limita i risultati di ricerca a documenti che contengono tutte le parole della query nel titolo del documento. A usa il termine di query allintitle: e includi "allintitle:" al all'inizio della query di ricerca.

Nota. Il posizionamento di allintitle: all'inizio di una query di ricerca è equivalente alla collocazione di intitle: davanti a ogni parola della ricerca. query.

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

Esempi

Questo esempio specifica che le parole "Google" e "cerca" devono apparire nei titoli di tutti i documenti presenti nei risultati di ricerca:
Input utente:allintitle: Google search
Termine di query: q=allintitle%3A+Google+search


Ricerca URL, singolo termine [inurl:]
Descrizione

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

La query inurl: ignora la punteggiatura e utilizza solo la prima parola che segue l'operatore inurl:. Puoi specificare più di una parola che deve essere inclusa in l'URL del documento mettendo il termine di query inurl: davanti a ognuna di queste parole. Puoi anche utilizzare il termine di query allinurl: per specificare che tutte le parole di query devono essere incluse negli URL di documenti presenti nei risultati di ricerca.

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

Esempi

Questo esempio specifica che la parola "Google" devono apparire in: gli URL di eventuali documenti nei risultati di ricerca e la parola "ricerca" devono apparire in qualsiasi punto nei titoli, negli URL, nei link o nel corpo del testo documenti:
Input utente: inurl:Google search
Termine di query: q=inurl%3AGoogle+search


Ricerca URL, tutti i termini [allinurl:]
Descrizione

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

Il termine di query allinurl: ignora la punteggiatura, quindi funziona solo per le parole, non per l'URL componenti. Ad esempio, allinurl: uk/scotland limiterà i risultati ai documenti che contengono le parole "uk" e "scozia" negli URL, ma non richiede che queste due parole compaiano in un particolare o che siano separate da una barra.

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

Esempi

Questo esempio specifica che le parole "Google" e "cerca" devono figurare negli URL di qualsiasi documento visualizzato nei risultati di ricerca:
Input utente: allinurl: Google search
Termine di query: q=allinurl%3A+Google+search



Informazioni sul documento web [info:]
Descrizione

Il termine di query info: recupera informazioni generali su un URL purché questo sia incluso nell'indice di ricerca di Google. La query di ricerca deve essere nel formato info:URL senza spazio tra il termine di query info: e l'URL.

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

Nota:non puoi specificare altri termini di query quando utilizzando info:.

Esempi Input utente: info:www.google.com
Termine della query: q=info%3Awww.google.com

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

as_filetype
Descrizione

Facoltativo. Restituisce immagini di un tipo specificato. I valori consentiti sono: bmp, gif, png, jpg e svg.

Esempi q=google&as_filetype=png

imgsz
Descrizione

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

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

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

tipo di img
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 uno specifico colore dominante:

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

as_rights
Descrizione

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

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

Esempi q=cats&as_filetype=png&as_rights=cc_attribute

Limiti per le richieste

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

Componente Limite Commento
Lunghezza della richiesta di ricerca 2048 byte  
Numero di termini di query 10 include 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. A per ottenere più risultati, devi inviare più richieste incrementa il valore del parametro start con per ogni richiesta.

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:

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 .

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:

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:

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

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:

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

* L'impostazione predefinita di SafeSearch è disattivata.

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

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 "&amp;". 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 & &amp; &#38;
    Virgolette semplici ' &apos; &#39;
    Virgolette doppie " &quot; &#34;
    Maggiore di > &gt; &#62;
    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:

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

anchor_text
Definizione

Il tag &lt;anchor_text&gt; specifica il testo che da mostrare agli utenti per identificare un perfezionamento un'etichetta associata a un insieme di risultati di ricerca. Poiché le etichette di perfezionamento sostituire i caratteri non alfanumerici con trattini bassi, visualizza il valore del tag <label> nell'interfaccia utente. Dovresti invece visualizzare il valore il tag &lt;anchor_text&gt;.

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

BLOCCA
Definizione

Questo tag racchiude i contenuti di un blocco in una riga di corpo del risultato di una promozione. Ogni blocco ha i sottotag T, U e L. Un tag T non vuoto indica che il blocco contiene testo; I tag U e L non vuoti indicano che il blocco contiene un link (con l'URL indicato nel sottotag U e l'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 BLOCCA 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 &lt;C&gt; indica che il servizio WebSearch può recuperare una versione memorizzata nella cache dell'URL di questo risultato di ricerca. Non puoi recupera le pagine memorizzate nella cache tramite l'API XML, ma puoi reindirizzare gli utenti su www.google.com per questo contenuti.

Attributi
Nome Formato Descrizione
SZ Testo (numero intero + "K") Fornisce le dimensioni della versione memorizzata nella cache del risultato di ricerca in kilobyte ("k").
ID cliente Testo Identifica un documento nella cache di Google. Per recuperare il documento dalla cache, invia un termine di ricerca creato come segue:
cache:CIDtext:escapedURL

L'URL con caratteri di escape è disponibile nel tag UE.

Esempio <C SZ="6000" CID=&quot;kvOXK_cYSSgJ&quot; /&gt;
Sottotag di CON
Formato dei contenuti Vuoto

C2C
Definizione Il tag <C2C> indica che il risultato si riferisce a una pagina in lingua cinese tradizionale. Questo tag appare solo quando semplificato e tradizionale La ricerca cinese sia attiva. Consulta la definizione del parametro di query c2coff per ulteriori informazioni sull'attivazione e la gestione disattivando questa funzione.
Formato dei contenuti Testo

Contesto
Definizione

Il tag &lt;Context&gt; racchiude un elenco di etichette di perfezionamento associate a un insieme di risultati di ricerca.

Esempio &lt;Context&gt;
Sottotag title, Facet+
Formato dei contenuti Container

CRAWLDATE
Definizione

Il tag &lt;CRAWLDATE&gt; identifica la data in cui è stata eseguita l'ultima scansione. CRAWLDATE non viene restituito in ogni pagina dei risultati di ricerca.

Esempio <CRAWLDATE>21 maggio 2005</CRAWLDATE>
Sottotag di R
Formato dei contenuti Testo

D
Definizione

Il tag &lt;DI&gt; include Open Directory Project informazioni sulla categoria (ODP) per un singolo risultato di ricerca.

Esempio &lt;DI&gt;
Sottotag DT? DS?
Sottotag di CON
Formato dei contenuti Vuoto

DS
Definizione

Il tag &lt;DS&gt; fornisce il riepilogo elencato per un nella directory ODP.

Esempio <DS>Pubblica la tua &lt;b&gt;calcio&lt;/b&gt; riprendi direttamente Internet.</DS>
Sottotag di DI
Formato dei contenuti Testo (può contenere HTML)

DT
Definizione

Il tag &lt;DT&gt; fornisce il titolo di un singolo presente nella directory ODP.

Esempio &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
Sottotag di DI
Formato dei contenuti Testo (può contenere HTML)

Facet
Definizione

Il tag <Facet> contiene un raggruppamento logico di tag &lt;FacetItem&gt;. Puoi crea di questi raggruppamenti usando il Motore di ricerca programmabile formato della specifica XML del motore. Se non crei questi di ricerca, results_xml_tag_Context><Context> del tag contengono fino a quattro tag <Facet>. Gli elementi all'interno di ogni tag <Facet> verranno raggruppati ai fini della visualizzazione, ma potrebbero non avere una logica relazione tra utenti.

Esempio <Facet>
Sottotag FacetItem+, title+
Sottotag di Contesto
Formato dei contenuti Container

FacetItem
Definizione

Il tag &lt;FacetItem&gt; racchiude informazioni su un'etichetta di perfezionamento associata a un insieme di risultati di ricerca.

Esempio &lt;FacetItem&gt;
Sottotag label, anchor_text+
Sottotag di Facet
Formato dei contenuti FacetItem

FI
Definizione Il tag &lt;FI&gt; funge da flag che indica se è stato applicato un filtro ai documenti per la ricerca. Consulta la sezione Filtro automatico di questo documento per ulteriori informazioni sui risultati di ricerca di Google filtri corretti.
Esempio <FI />
Sottotag di RES
Formato dei contenuti Vuoto

PSG
Definizione

Il tag &lt;GSP&gt; racchiude tutti i dati restituiti nei risultati di ricerca XML di Google. "GSP" sono un'abbreviazione di "Google Search Protocol".

Attributi
Nome Formato Descrizione
VER Testo (numero intero) L'attributo VER specifica la versione dell'output dei risultati di ricerca. La l'attuale versione di output è "3.2".
Esempio <GSP VER="3.2">
Sottotag PARAM+, Q, RES?, TM
Formato dei contenuti Vuoto

CON
Definizione Il tag &lt;HAS&gt; incapsula informazioni su eventuali ricerche speciali parametri di richiesta supportati per un determinato URL.

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

Sottotag DI?, L?, C?, ?
Sottotag di R

ISURL
Definizione Google restituisce il tag &lt;ISURL&gt; se la query di ricerca associata è un URL.
Sottotag di GSP
Formato dei contenuti Vuoto

L
Definizione La presenza del tag &lt;L&gt; indica che il servizio WebSearch può trovare altri siti che rimandano a questo URL del risultato di ricerca. Per trovare questi siti, utilizza lo speciale termine di query link:.
Sottotag di CON
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]] a il valore del parametro q nella richiesta HTTP a Google come come mostrato nell'esempio che segue. Questo valore deve essere URL con caratteri di escape 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 è identico al Il tag &lt;Label&gt;, che identifica un'etichetta di perfezionamento associati a un determinato URL nei tuoi risultati di ricerca.

Esempio &lt;label&gt;golf_courses&lt;/label&gt;
Sottotag di FacetItem
Formato dei contenuti Testo

lang
Definizione

Il tag &lt;LANG&gt; contiene la migliore ipotesi di Google di la lingua del risultato di ricerca.

Esempio <lang>it</lang>
Sottotag di R
Formato dei contenuti Testo

M
Definizione

Il tag &lt;M&gt; identifica il totale stimato numero 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 &lt;NB&gt; include informazioni di navigazione: rimanda alla pagina successiva dei risultati di ricerca o alla pagina precedente di risultati di ricerca per l'insieme di risultati.

Nota: questo tag è presente solo se sono disponibili più risultati.

Esempio &lt;NB&gt;
Sottotag NU? PU?
Sottotag di RES
Formato dei contenuti Vuoto

NU
Definizione

Il tag &lt;NU&gt; contiene un link relativo al tag pagina successiva dei risultati di ricerca.

Esempio <NU>/search?q=flowers&num=10&hl=it&ie=UTF-8
&output=xml&client=test&start=10</NU>
Sottotag di Nota
Formato dei contenuti Testo (URL relativo)

PARAMETRO
Definizione

Il tag &lt;PARAM&gt; identifica un parametro di input inviato nella richiesta HTTP associata con il risultato XML. Le informazioni sul parametro sono contenute in gli attributi del tag (name, value, originali_value) e ci saranno un tag PARAM per ogni parametro inviato nella richiesta HTTP.

Attributi
Nome Formato Descrizione
name Testo Nome del parametro di input.
value HTML Versione dell'input in formato HTML .
original_value Testo Versione originale con URL con caratteri di escape del valore del parametro di input.
Esempio <PARAM name="cr" value=&quot;countryNZ&quot; origin_value="countryNZ" /&gt;
Sottotag di GSP
Formato dei contenuti Complesso

PU
Definizione

Il tag &lt;PU&gt; fornisce un link relativo al pagina precedente dei risultati di ricerca.

Esempio <PU>/search?q=flowers&num=10&hl=it&output=xml
&client=test&start=10</PU>
Sottotag di Nota
Formato dei contenuti Testo (URL relativo)

Q
Definizione

Il tag &lt;Q&gt; identifica la query di ricerca inviate nella richiesta HTTP associata al risultato XML.

Esempio

<Q>pizza</Q>

Sottotag di GSP
Formato dei contenuti Testo

R
Definizione

Il tag &lt;R&gt; racchiude i dettagli di una singolo risultato di ricerca.

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

Attributi
Nome Formato Descrizione
N Testo (numero intero) Indica l'indice (in base 1) di questo risultato di ricerca.
MIME Testo Indica il tipo MIME della ricerca o il risultato finale.
Sottotag U, UE, T?, CRAWLDATE, D?, LANG?, CON
Sottotag di RES

RES
Definizione

Il tag &lt;RES&gt; racchiude l'insieme di i risultati di ricerca e i relativi dettagli.

Attributi
Nome Formato Descrizione
SN Testo (numero intero) Indica l'indice (in base 1) del il primo risultato di ricerca restituito in questa serie di risultati.
EN Testo (numero intero) Indica l'indice (in base 1) degli ultimi risultato di ricerca restituito in questo insieme di risultati.
Esempio <RES SN="1" IT="10">
Sottotag M, FI?, XT?, NB?, R*
Sottotag di GSP
Formato dei contenuti Vuoto

S
Definizione

Il tag &lt;S&gt; contiene un estratto di una ricerca che mostra i termini di query evidenziati in grassetto. Le interruzioni di riga sono incluse nell'estratto per un corretto testo a capo.

Esempio <S>Washington (CNN): un tentativo di porre fine alla Distanziamento del Senato sul presidente &lt;b&gt;s&lt;/b&gt; le scelte del tribunale lasciare che cinque candidati passino al voto finale mantenendo &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
Sottotag di R
Formato dei contenuti Testo (HTML)

SL_MAIN
Definizione

Questo tag racchiude i contenuti dei risultati 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 i link sono contenuti 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. Uno di questi verrà visualizzato ogni volta che sarà presente una promozione nei risultati di ricerca. Il sottotag SL_MAIN contiene i principali dati dei risultati.

Sottotag SL_MAIN*
Sottotag di R
Formato dei contenuti Vuoto

Ortografia
Definizione

Il tag <Spelling> include una stringa alternativa suggerimento ortografico per la query inviata. Questo tag compare solo su la prima pagina dei risultati di ricerca. I suggerimenti ortografici sono disponibili in inglese, cinese, giapponese e coreano.

Nota: Google restituirà suggerimenti ortografici solo per in cui il valore del parametro gl è in lettere minuscole.

Esempio <Ortografia>
Sottotag Suggerimento
Sottotag di GSP
Formato dei contenuti Vuoto

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

T
Definizione Il tag &lt;T&gt; contiene il titolo del risultato.
Esempio <T>La costa orientale di Amici Pizzeria</T>
Sottotag di R
Formato dei contenuti Testo (HTML)

titolo
Definizione

Come elemento secondario di &lt;Context&gt;, il tag &lt;Context&gt; contiene il nome di Motore di ricerca programmabile.

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

Esempio

Come figlio di <Context>: <title>La mia ricerca Engine&lt;/title&gt;

Come elemento secondario di <Facet>: <title>facet titolo</title>

Sottotag di Contesto, Facet
Formato dei contenuti Testo

TM
Definizione

Il tag &lt;TM&gt; identifica il tempo totale del server. necessarie per restituire i risultati di ricerca, misurati in secondi.

Esempio <TM>0,100445</TM>
Sottotag di GSP
Formato dei contenuti Testo (numero con rappresentazione in virgola mobile)

TT
Definizione Il tag &lt;TT&gt; fornisce una funzionalità di ricerca mancia.
Esempio <TT>&lt;i&gt;Suggerimento: per la maggior parte browser, premendo il tasto Invio vengono visualizzati gli stessi risultati del clic il pulsante Cerca.&lt;/i&gt;</TT>
Sottotag di GSP

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

UD
Definizione

Il tag &lt;UD&gt; fornisce la codifica IDN (Nome di dominio internazionale) del risultato di ricerca. Il valore consente domini da mostrare 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. Il tag &lt;UD&gt; viene incluso soltanto nei risultati di ricerca relativi a che includevano il parametro ud.

Nota: questa è una funzionalità beta.

Esempio &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
Sottotag di R
Formato dei contenuti Testo (URL con codifica IDN)

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

XT
Definizione Il tag &lt;XT&gt; indica che il numero totale stimato di risultati, come specificato dal tag M, rappresenta in realtà il numero numero totale di risultati. Vedi l'opzione Automatico Sezione Filtri di questo documento per ulteriori dettagli.
Esempio <XT />
Sottotag di RES
Formato dei contenuti Vuoto


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:

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

RG
Definizione

Il tag &lt;RG&gt; racchiude i dettagli di un singolo risultato di ricerca di immagini.

Attributi
Nome Formato Descrizione
N Testo (numero intero) Indica l'indice (in base 1) di questo risultato di ricerca.
MIME Testo Indica il tipo MIME della ricerca o il risultato finale.
Sottotag di RES
RU
Definizione

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

Sottotag di R