Questa pagina fa riferimento alla versione XML dell'API JSON Custom Search, disponibile solo per i clienti di Google Site Search.
- Panoramica
- Formato della richiesta di Motore di ricerca programmabile
- Risultati XML
Panoramica
Il servizio Google Ricerca Web consente ai clienti di Google Site Search di mostrare i risultati di ricerca di Google sui propri siti web. Il servizio WebSearch utilizza un semplice protocollo basato su HTTP per fornire i risultati di ricerca. Gli amministratori della Ricerca hanno il controllo completo sul modo in cui richiedono i risultati di ricerca e sul modo in cui li presentano all'utente finale. Questo documento descrive i dettagli tecnici della richiesta di Ricerca Google e i formati dei risultati.
Per recuperare i risultati della Ricerca Google, l'applicazione invia a Google una semplice richiesta HTTP. Google restituisce quindi i risultati di ricerca in formato XML. I risultati in formato XML consentono di personalizzare il modo in cui vengono visualizzati i risultati di ricerca.
Formato della richiesta di WebSearch
- Panoramica della richiesta
- Termini di query
- Parametri di richiesta
- Esempi di query di Ricerca Google
- Definizioni dei parametri di query di Ricerca Web
- Esempi di query di immagini
- Definizioni dei parametri di query di ricerca immagini
- Ricerca avanzata
- Parametri di query della ricerca avanzata
- Termini di query speciali
- Limiti per le richieste
Panoramica richiesta
La richiesta di ricerca Google è un comando GET
HTTP standard. Include una raccolta di parametri pertinenti per le tue query. Questi parametri sono inclusi nell'URL della richiesta sotto forma di coppie nome=valore separate dalla e commerciale (&). I parametri includono dati come la query di ricerca e un ID motore univoco (cx
) che identifica il motore che effettua la richiesta HTTP. Il servizio WebSearch o Google Immagini restituisce risultati XML in risposta alle tue richieste HTTP.
Termini di query
La maggior parte delle richieste di ricerca include uno o più termini di query. Un termine di query viene visualizzato come valore di un parametro nella richiesta di ricerca.
I termini di query possono specificare diversi tipi di informazioni per filtrare e organizzare i risultati di ricerca restituiti da Google. Nelle query è possibile specificare:
- Parole o frasi da includere o
escludere
- Tutte le parole in una query di ricerca (impostazione predefinita)
- Una frase esatta nella query di ricerca
- Qualsiasi parola o frase in una query di ricerca
- Posizione in un documento in cui cercare i termini di ricerca
- Ovunque nel documento (impostazione predefinita)
- Solo nel corpo del documento
- Solo nel titolo del documento
- Solo nell'URL del documento
- Solo nei link del documento
- Restrizioni relative ai documenti stessi
- Inclusione o esclusione di documenti di determinati tipi di file (ad esempio file PDF o documenti Word)
- Query URL speciali che restituiscono informazioni su un determinato URL anziché eseguire una ricerca.
- Query che restituiscono informazioni generali su un URL, come la categoria, lo snippet o la lingua di Open Directory
- Query che restituiscono l'insieme di pagine web che rimandano a un URL
- Query che restituiscono un insieme di pagine web simili a un determinato URL
Ricerca predefinita
I valori dei parametri di query di ricerca devono contenere caratteri di escape dell'URL. Tieni presente che devi sostituire il segno più ("+") per tutte le sequenze di spazi vuoti nella query di ricerca. Questo aspetto viene discusso più in dettaglio nella sezione Interpretazione dei caratteri di escape per gli URL di questo documento.
Il termine della query di ricerca viene inviato al servizio WebSearch utilizzando il parametro q. Un esempio di termine della query di ricerca è:
q=horses+cows+pigs
Per impostazione predefinita, il servizio Ricerca Google restituisce solo documenti che includono tutti i termini nella query di ricerca.
Parametri di richiesta
Questa sezione elenca i parametri che puoi utilizzare quando effettui una richiesta di ricerca. I parametri sono suddivisi in due elenchi. Il primo elenco contiene i parametri pertinenti per tutte le richieste di ricerca. Il secondo elenco contiene parametri che sono pertinenti solo alle richieste di ricerca avanzata.
Sono necessari tre parametri di richiesta:
- Il parametro client deve essere impostato su
google-csbe
- Il parametro output specifica il formato dei risultati XML restituiti. I risultati possono essere restituiti con (xml) o senza (
xml_no_dtd
) un riferimento alla DTD di Google. Ti consigliamo di impostare questo valore suxml_no_dtd
. Nota: se non specifichi questo parametro, i risultati verranno restituiti in HTML anziché in XML.
- Il parametro cx che rappresenta l'ID univoco del motore.
I parametri di richiesta più comunemente utilizzati, diversi da quelli sopra menzionati sono:
- num: il numero richiesto di risultati di ricerca
- q: i termini di ricerca
- start: l'indice iniziale dei risultati.
Esempi di query di Ricerca Google
Gli esempi riportati di seguito mostrano un paio di richieste HTTP di WebSearch per illustrare come vengono utilizzati i diversi parametri di query. Le definizioni dei diversi parametri di query sono fornite nelle sezioni Definizioni dei parametri di query di Ricerca Web e Parametri delle query di ricerca avanzata di questo documento.
Questa richiesta chiede i primi 10 risultati (start=0&num=10
) per il termine di query "red sox" (q=red+sox
). La query specifica inoltre che i risultati devono provenire da siti web canadesi (cr=countryCA
) e devono essere scritti in francese (lr=lang_fr
). Infine, la query specifica i valori per i parametri client, output e cx, tutti e tre obbligatori.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
In questo esempio vengono utilizzati alcuni dei parametri avanzati per le query di ricerca per personalizzare ulteriormente la query di ricerca. Questa richiesta utilizza il parametro as_q (as_q=red+sox
) anziché il parametro q. Utilizza inoltre il parametro as_eq per escludere qualsiasi documento contenente la parola "Yankees" dai risultati di ricerca (as_eq=yankees
).
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Definizioni dei parametri di ricerca WebSearch
c2coff | |||||||
---|---|---|---|---|---|---|---|
Descrizione | (Facoltativo) Il parametro c2coff attiva o disattiva la funzionalità Ricerca in cinese semplificato e tradizionale. Il valore predefinito di questo parametro è
|
||||||
Esempi | q=google&c2coff=1 |
client | |
---|---|
Descrizione | Obbligatorio. Il parametro |
Esempi | q=google&client=google-csbe |
cr | |
---|---|
Descrizione | (Facoltativo) Il parametro La Ricerca Google determina il paese di un documento analizzando:
Consulta la sezione Valori parametro paese (cr) per un elenco dei valori validi per questo parametro. |
Esempi | q=Frodo&cr=countryNZ |
cx | |
---|---|
Descrizione | Obbligatorio. Il parametro |
Esempi | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
filter | |||||||
---|---|---|---|---|---|---|---|
Descrizione | (Facoltativo) Il parametro filter attiva o disattiva il filtro automatico dei risultati di ricerca di Google. Per ulteriori informazioni sui filtri dei risultati di ricerca di Google, consulta la sezione Filtri automatici di questo documento. Il valore predefinito del parametro
Nota: per impostazione predefinita, Google applica i filtri a tutti i risultati di ricerca per migliorarne la qualità. |
||||||
Esempi | q=google&filter=0 |
gl | |
---|---|
Descrizione | (Facoltativo) Il valore del parametro La specifica di un valore parametro |
Esempi | Questa richiesta potenzia i documenti scritti nel Regno Unito nei risultati di WebSearch: |
hl | |
---|---|
Descrizione | (Facoltativo) Il parametro Consulta la sezione Lingue dell'interfaccia di Internazionalizzazione di query e presentazione dei risultati per ulteriori informazioni e Lingue dell'interfaccia supportate per un elenco delle lingue supportate. |
Esempi | Questa richiesta ha come target gli annunci che promuovono vini in francese. (Vin è il termine francese per il vino). q=vin&ip=10.10.10.10&ad=w5&hl=fr |
HQ | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi | Questa richiesta cerca "pizza" E "formaggi". L'espressione è uguale a
|
ie | |
---|---|
Descrizione | (Facoltativo) Il parametro Consulta la sezione Codifica caratteri per sapere quando potrebbe essere necessario utilizzare questo parametro. Consulta la sezione Schemi di codifica
dei caratteri per l'elenco dei possibili valori |
Esempi | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Descrizione | (Facoltativo) Il parametro La Ricerca Google determina la lingua di un documento analizzando:
Consulta la sezione Valori della raccolta per lingua ( |
Esempi | q=Frodo&lr=lang_en |
num | |
---|---|
Descrizione | (Facoltativo) Il parametro Il valore predefinito di Nota: se il numero totale di risultati di ricerca è inferiore al numero di risultati richiesti, verranno restituiti tutti i risultati di ricerca disponibili. |
Esempi | q=google&num=10 |
oe | |
---|---|
Descrizione | (Facoltativo) Il parametro Consulta la sezione Codifica caratteri per sapere quando potrebbe essere necessario utilizzare questo parametro. Consulta la sezione Schemi di codifica
dei caratteri per l'elenco dei possibili valori |
Esempi | q=google&ie=utf8&oe=utf8 |
output | |||||||
---|---|---|---|---|---|---|---|
Descrizione | Obbligatorio. Il parametro
|
||||||
Esempi | output=xml_no_dtd |
q | |
---|---|
Descrizione | (Facoltativo) Il parametro Esistono anche una serie di termini di query speciali che possono essere utilizzati come parte del valore del parametro Il pannello di controllo della Ricerca Google include un report delle principali query inviate utilizzando il parametro Nota: il valore specificato per il parametro q deve contenere caratteri di escape dell'URL. |
Esempi | q=vacation&as_oq=london+paris |
sicuro | |||||||||
---|---|---|---|---|---|---|---|---|---|
Descrizione | (Facoltativo) Il parametro
Per ulteriori dettagli su questa funzionalità, consulta la sezione Filtro dei contenuti per adulti con SafeSearch. |
||||||||
Esempi | q=adult&safe=high |
inizio | |
---|---|
Descrizione | (Facoltativo) Il parametro Il parametro |
Esempi | start=10 |
ordinare | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi |
|
ud | |
---|---|
Descrizione | (Facoltativo) Il parametro http://www.花井鮨.com I valori validi per questo parametro sono Se il parametro http://www.xn--elq438j.com. Nota: questa è una funzionalità beta. |
Esempi | q=google&ud=1 |
Ricerca avanzata
I parametri di ricerca aggiuntivi elencati sotto l'immagine sono pertinenti alle query di ricerca avanzate. Quando invii una ricerca avanzata, i valori di diversi parametri (ad es. as_eq, as_epq, as_oq e così via) vengono tutti considerati nei termini di query per quella ricerca. L'immagine mostra la pagina Ricerca avanzata di Google. Nell'immagine, il nome di ogni parametro di ricerca avanzata è scritto in testo red all'interno o accanto al campo della pagina a cui corrisponde tale parametro.
Parametri di query della ricerca avanzata
as_dt | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi | as_dt=i,as_dt=e |
as_epq | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi | as_epq=abraham+lincoln |
as_eq | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi |
|
as_lq | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi |
|
as_nlo | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi | Quanto segue imposta un intervallo di ricerca da 5 a 10, inclusi:
|
as_nhi | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi | Quanto segue imposta un intervallo di ricerca da 5 a 10, inclusi:
|
as_oq | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi |
|
as_q | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi |
|
as_qdr | |
---|---|
Descrizione | (Facoltativo) Il parametro
|
Esempi |
Questo esempio richiede i risultati dell'ultimo anno:
In questo esempio vengono richiesti i risultati degli ultimi 10 giorni:
|
as_sitesearch | |
---|---|
Descrizione | (Facoltativo) Il parametro |
Esempi |
|
Termini di query speciali
La Ricerca Google consente l'utilizzo di diversi termini di query speciali che
accedono a funzionalità aggiuntive del motore di ricerca Google. Questi termini di query speciali devono essere inclusi nel valore del parametro di richiesta q. Come per altri termini di query, i termini di query speciali devono utilizzare l'URL di escape. Alcuni
termini di query speciali contengono i due punti (:). Questo carattere
deve anche contenere caratteri di escape nell'URL; il suo valore URL con escape è %3A
.
Link a ritroso [link:] | |
---|---|
Descrizione | Il termine di query La versione di Puoi anche utilizzare il parametro di richiesta as_lq per inviare una richiesta Nota: non puoi specificare altri termini di query quando utilizzi |
Esempi |
|
Ricerca booleana OR [ OR ] | |
---|---|
Descrizione | Il termine di query Puoi anche utilizzare il parametro di richiesta as_oq per inviare una ricerca di qualsiasi termine in un insieme di termini. Nota: se una richiesta di ricerca specifica la query "Londra+OR+Parigi", i risultati di ricerca includeranno documenti contenenti almeno una di queste due parole. In alcuni casi, i documenti nei risultati di ricerca potrebbero contenere entrambe le parole. |
Esempi | Cerca Londra o Parigi: Input utente:
london OR
paris Termine di ricerca:q=london+OR+paris Cerca vacanza e Londra o Parigi: Termine di query:
q=vacation+london+OR+paris Cerca una vacanza e una a Londra, Parigi o cioccolatini: Termine di query:
q=vacation+london+OR+paris+OR+chocolates Cerca vacanze, cioccolatini e Londra o Parigi, con il minimo peso dato ai cioccolatini: Termine di query:
q=vacation+london+OR+paris+chocolates Cerca vacanze, cioccolatini e fiori in documenti che contengono anche Londra o Parigi: Termine di query:
q=vacation+london+OR+paris+chocolates+flowers Cerca una vacanza e una a Londra o Parigi e cerca anche cioccolatini o fiori: Termine di query: q=vacation+london+OR+paris+chocolates+OR+flowers |
Escludi termine di query [-] | |
---|---|
Descrizione | Il termine di query di esclusione ( La versione di Il termine di query di esclusione è utile quando un termine di ricerca ha più di un significato. Ad esempio, la parola "spica" potrebbe restituire risultati relativi al pesce o alla musica. Se cerchi documenti relativi ai pesci, potresti escludere documenti relativi alla musica dai risultati di ricerca utilizzando il termine di query di esclusione. Puoi anche utilizzare il parametro di richiesta as_eq per escludere dai risultati di ricerca i documenti corrispondenti a una parola o frase specifica. |
Esempi | Input utente: bass -music Termine di ricerca: q=bass+%2Dmusic |
Esclusione del tipo di file [ -filetype: ] | |
---|---|
Descrizione | Il termine di query La versione di Nota: puoi escludere più tipi di file dai risultati di ricerca aggiungendo altri termini di query I tipi di file supportati da Google includono:
In futuro potrebbero essere aggiunti altri tipi di file. Un elenco aggiornato è sempre disponibile nelle Domande frequenti sui tipi di file di Google. |
Esempi | Questo esempio restituisce documenti che menzionano "Google", ma non sono documenti PDF: Questo esempio restituisce documenti che menzionano "Google", ma esclude sia i documenti PDF sia i documenti Word: |
Filtro tipo di file [ filetype: ] | |
---|---|
Descrizione | Il termine di query La versione di Puoi limitare i risultati di ricerca ai documenti che corrispondono a una delle diverse estensioni dei file aggiungendo altri termini di query Per impostazione predefinita, i risultati di ricerca includeranno documenti con qualsiasi estensione di file. I tipi di file supportati da Google includono:
In futuro potrebbero essere aggiunti altri tipi di file. Un elenco aggiornato è sempre disponibile nelle Domande frequenti sui tipi di file di Google. |
Esempi | Questo esempio restituisce documenti PDF che menzionano "Google": Questo esempio restituisce documenti PDF e Word che menzionano "Google": |
Includi termine di query [+] | |
---|---|
Descrizione | Il termine di query includi (+) specifica che una parola o una frase deve essere presente in tutti i documenti inclusi nei risultati di ricerca. Per utilizzare il termine di query di inclusione, devi aggiungere "+" (un segno più) alla parola o alla frase che deve essere inclusa in tutti i risultati di ricerca. La versione di Dovresti usare |
Esempi | Input utente: Star Wars Episode +I Termine di ricerca: q=Star+Wars+Episode+%2BI |
Ricerca solo link, tutti i termini [ allinlinks: ] | |
---|---|
Descrizione | Il termine di query Se la tua query di ricerca include il termine di query La versione di |
Esempi | Input utente:allinlinks: Google search Termine di ricerca: q=allinlinks%3A+Google+search |
Ricerca per frase | |
---|---|
Descrizione | Il termine di query di ricerca per frase (") consente di cercare frasi complete racchiudendole tra virgolette o unendole con trattini. La versione di Le ricerche per frase sono particolarmente utili se cerchi citazioni famose o nomi propri. Puoi anche utilizzare il parametro di richiesta as_epq per eseguire una ricerca per frase. |
Esempi | Input utente:"Abraham Lincoln" Termine di ricerca: q=%22Abraham+Lincoln%22 |
Ricerca di solo testo, tutti i termini [allintext:] | |
---|---|
Descrizione | Il termine di query Se la tua query di ricerca include il termine di query La versione di |
Esempi | Questo esempio specifica che le parole "Google" e "ricerca" devono apparire nel corpo di tutti i documenti inclusi nei risultati di ricerca: Input utente: allintext:Google search Termine query: q=allintext%3AGoogle+search |
Ricerca del titolo, singolo termine [intitle:] | |
---|---|
Descrizione | Il termine di query Nota: puoi specificare più di una parola da includere nel titolo del documento inserendo il termine di query La versione di |
Esempi | In questo esempio, la parola "Google" deve comparire nei titoli di qualsiasi documento e la parola "ricerca" deve apparire ovunque all'interno dei titoli, degli URL, dei link o del corpo del testo di questi documenti: |
Ricerca di titoli, tutti i termini [allintitle:] | |
---|---|
Descrizione | Il termine di query Nota: l'inserimento di La versione di |
Esempi | In questo esempio, le parole "Google" e "ricerca" devono comparire nei titoli di qualsiasi documento visualizzato nei risultati di ricerca: |
Ricerca URL, singolo termine [inurl:] | |
---|---|
Descrizione | Il termine di query Il termine di query La versione di |
Esempi | In questo esempio, la parola "Google" deve comparire
negli URL di qualsiasi documento nei risultati di ricerca e la parola "ricerca"
deve apparire ovunque all'interno dei titoli, degli URL, dei link o del corpo del testo di questi
documenti: |
Ricerca URL, tutti i termini [allinurl:] | |
---|---|
Descrizione | Il termine di query Il termine di query La versione di |
Esempi | In questo esempio, le parole "Google" e "ricerca" devono comparire negli URL di qualsiasi documento nei risultati di ricerca: |
Informazioni sul documento web [info:] | |
---|---|
Descrizione | Il termine di query La versione di Nota: non puoi specificare altri termini di query quando utilizzi |
Esempi | Input utente: info:www.google.com Termine di ricerca: q=info%3Awww.google.com |
Query immagine di esempio
Gli esempi riportati di seguito mostrano un paio di richieste HTTP immagine per illustrare come vengono utilizzati i diversi parametri di query. Le definizioni dei diversi parametri di ricerca sono fornite nelle sezioni Definizioni dei parametri di query delle immagini di questo documento.
Questa richiesta chiede i primi cinque risultati (start=0&num=5
) per il termine di query "scimmia" (q=monkey
), di tipo file .png. Infine, la query specifica i valori per i parametri client
, output
e cx
, tutti e tre obbligatori.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Parametri di query di ricerca immagini
as_filetype | |
---|---|
Descrizione | (Facoltativo) Restituisce immagini di un tipo specificato. I valori consentiti sono: |
Esempi | q=google&as_filetype=png |
imgsz | |
---|---|
Descrizione | (Facoltativo) Restituisce immagini di una dimensione specificata, dove la dimensione può essere una delle seguenti:
|
Esempi | q=google&as_filetype=png&imgsz=icon |
imgtype | |
---|---|
Descrizione | (Facoltativo) Restituisce immagini di un tipo, che può essere uno dei seguenti:
|
Esempi | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
Descrizione | (Facoltativo) Restituisce immagini in bianco e nero, in scala di grigi o a colori:
|
Esempi | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
Descrizione | (Facoltativo) Restituisce immagini di un colore dominante specifico:
|
Esempi | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Descrizione | (Facoltativo) Filtri basati sulle licenze. I valori supportati includono:
|
Esempi | q=cats&as_filetype=png&as_rights=cc_attribute |
Limiti per le richieste
Il grafico che segue elenca le limitazioni relative alle richieste di ricerca inviate a Google:
Componente | Limite | Commento |
---|---|---|
Durata richiesta di ricerca | 2048 byte | |
Numero di termini di query | 10 | include i termini nei seguenti parametri: q, as_epq, as_eq, as_lq, as_oq, as_q |
Numero risultati | 20 | Se imposti il parametro num su un numero maggiore di 20, vengono restituiti solo 20 risultati. Per ottenere più risultati, devi inviare più richieste e incrementare il valore del parametro start con ogni richiesta. |
Internazionalizzazione di query e presentazione dei risultati
Il servizio Ricerca Google consente di cercare documenti in più lingue. Puoi specificare la codifica dei caratteri da utilizzare per interpretare la richiesta HTTP e codificare la risposta XML (usando i parametri di ricerca ie e oe). Puoi anche filtrare i risultati per includere solo documenti scritti in determinate lingue.
Le seguenti sezioni illustrano problemi relativi alla ricerca in più lingue:
Codifica dei caratteri
I server inviano dati, ad esempio le pagine web, agli user agent, ad esempio i browser, sotto forma di sequenza di byte codificati. Lo user agent decodifica quindi i byte in una sequenza di caratteri. Quando invii richieste al servizio WebSearch, puoi specificare gli schemi di codifica sia per la query di ricerca sia per la risposta XML che ricevi.
Puoi utilizzare il parametro di richiesta ie per specificare il meccanismo di codifica per i caratteri nella richiesta HTTP. Puoi anche utilizzare il parametro oe per specificare lo schema di codifica che Google deve utilizzare per codificare la risposta XML. Se utilizzi uno schema di codifica diverso da ISO-8859-1
(o latin1
), assicurati di specificare i valori corretti per i parametri ie e oe.
Nota: se fornisci la funzionalità di ricerca per più lingue, ti consigliamo di utilizzare il valore di codifica utf8
(UTF-8) per entrambi i parametri ie e oe.
Consulta l'appendice Schemi di codifica dei caratteri per un elenco completo dei valori che puoi utilizzare per i parametri ie e oe.
Per informazioni più generali sulla codifica dei caratteri, consulta http://www.w3.org/TR/REC-html40/charset.html.
Lingue dell'interfaccia
Puoi utilizzare il parametro di richiesta hl per identificare la lingua dell'interfaccia grafica. Il valore del parametro hl potrebbe influire sui risultati di ricerca XML, in particolare in caso di query internazionali in cui la limitazione della lingua (utilizzando il parametro lr) non è specificata esplicitamente. In questi casi, il parametro hl può promuovere i risultati di ricerca nella stessa lingua di quella di input dell'utente.
Ti suggeriamo di impostare esplicitamente il parametro hl nei risultati di ricerca per assicurarti che Google selezioni i risultati di ricerca della massima qualità per ogni query.
Consulta la sezione Lingue dell'interfaccia supportate per un elenco completo dei valori validi per il parametro hl.
Ricerca di documenti scritti in lingue specifiche
Puoi utilizzare il parametro di richiesta lr per limitare i risultati di ricerca a documenti scritti in una lingua o in un determinato insieme di lingue.
Il parametro lr supporta gli operatori booleani per consentirti di specificare più lingue da includere (o escludere) dai risultati di ricerca.
I seguenti esempi mostrano come utilizzare gli operatori booleani per richiedere documenti in lingue diverse.
Per i documenti scritti in giapponese:
lr=lang_jp
Per i documenti scritti in italiano o tedesco:
lr=lang_it|lang_de
Per i documenti non scritti in ungherese o in ceco:
lr=(-lang_hu).(-lang_cs)
Consulta la sezione Valori raccolta lingua per un elenco completo dei possibili valori per il parametro lr e la sezione Operatori booleani per una discussione completa sull'uso di questi operatori.
Ricerca in cinese semplificato e tradizionale
Il cinese semplificato e il cinese tradizionale sono due varianti di scrittura della lingua cinese. Lo stesso concetto può essere scritto in modo diverso in ogni variante. Data una query in una delle varianti, il servizio Ricerca Google può restituire risultati che includono pagine in entrambe le varianti.
Per utilizzare questa funzione, procedi nel seguente modo:
- Imposta il parametro di richiesta c2coff su 0
e - Esegui una delle seguenti operazioni:
L'esempio seguente mostra i parametri di query che dovresti includere in una richiesta di risultati in cinese semplificato e tradizionale. Tieni presente che le informazioni aggiuntive richieste, come il client, non sono incluse nell'esempio.
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Filtro dei risultati
La Ricerca Google offre diversi modi per filtrare i risultati di ricerca:
- Filtro automatico dei risultati di ricerca
- Filtri per lingua e paese
- Filtrare i contenuti per adulti con SafeSearch
Filtro automatico dei risultati di ricerca
Per offrire i migliori risultati possibili, Google utilizza due tecniche per filtrare automaticamente i risultati di ricerca generalmente considerati indesiderati:
-
Contenuti duplicati: se più documenti contengono le stesse informazioni, solo il documento più pertinente viene incluso nei risultati di ricerca.
-
Crowding degli host: se esistono molti risultati di ricerca per lo stesso sito, Google potrebbe non mostrare tutti i risultati di quel sito oppure mostrare i risultati più in basso
nel ranking rispetto a quanto sarebbe stato altrimenti.
Ti consigliamo di lasciare attivi questi filtri per le richieste di ricerca standard, poiché i filtri migliorano notevolmente la qualità della maggior parte dei risultati di ricerca. Tuttavia, puoi ignorare questi filtri automatici impostando il parametro di query filter su 0 nella richiesta di ricerca.
Filtro per lingua e paese
Il servizio Ricerca Google restituisce i risultati da un indice master di tutti i documenti web. L'indice principale contiene sottoraccolte di documenti raggruppati in base a determinati attributi, tra cui lingua e paese di origine.
Puoi utilizzare i parametri di richiesta lr e cr per limitare i risultati di ricerca a sottoraccolte di documenti scritti in determinate lingue o provenienti da determinati paesi.
La Ricerca Google determina la lingua di un documento mediante l'analisi di:
- Il dominio di primo livello (TLD) dell'URL del documento
- i meta tag del linguaggio all'interno del documento
- La lingua principale utilizzata nel corpo del testo del documento
Consulta anche la definizione del parametro lr, la sezione sulla ricerca di documenti scritti in lingue specifiche e i valori di raccolta delle lingue che possono essere utilizzati come valori per il parametro lr per ulteriori
informazioni sulla limitazione dei risultati in base alla lingua.
La Ricerca Google determina il paese di un documento analizzando:
- Il dominio di primo livello (TLD) dell'URL del documento
- la posizione geografica dell'indirizzo IP del server web
Consulta anche la definizione del parametro cr e dei valori della raccolta paesi che possono essere utilizzati come valori per il parametro cr per maggiori informazioni sulla limitazione dei risultati per paese di origine.
Nota: puoi combinare i valori delle lingue e dei paesi per personalizzare i risultati di ricerca. Ad esempio, potresti richiedere documenti scritti in francese e provenienti dalla Francia o dal Canada, oppure documenti che provengono dall'Olanda e non sono scritti in inglese. I parametri lr e cr supportano entrambi gli operatori booleani.
Filtrare i contenuti per adulti con SafeSearch
Molti clienti di Google non vogliono mostrare risultati di ricerca per siti con contenuti per adulti. Con il nostro filtro SafeSearch puoi filtrare i risultati di ricerca che includono contenuti per adulti ed eliminarli. I filtri di Google utilizzano una tecnologia proprietaria per controllare parole chiave, frasi e URL. Anche se nessun filtro è preciso al 100%, SafeSearch rimuoverà la stragrande maggioranza dei contenuti per adulti dai risultati di ricerca.
Google si impegna a mantenere SafeSearch il più possibile aggiornato e completo attraverso la scansione continua del web e incorporando aggiornamenti dai suggerimenti degli utenti.
SafeSearch è disponibile nelle seguenti lingue:
Olandese Inglese Francese Tedesco |
Italiano Portoghese (brasiliano) Spagnolo Cinese tradizionale |
Puoi modificare il livello di filtro con cui Google filtra i risultati per contenuti per adulti utilizzando il parametro di ricerca safe. La tabella seguente illustra le impostazioni SafeSearch di Google e il modo in cui influiranno su di esse sui risultati di ricerca:
Livello SafeSearch | Descrizione |
---|---|
high | Abilita una versione più rigida di SafeSearch. |
media | Blocca le pagine web che includono pornografia e altri contenuti espliciti di natura sessuale. |
off | Non filtra i contenuti per adulti nei risultati di ricerca. |
* L'impostazione predefinita di SafeSearch è disattivata.
Se hai attivato SafeSearch e nei tuoi risultati trovi siti che includono contenuti offensivi, invia un'email all'URL del sito all'indirizzo safesearch@google.com ed effettueremo accertamenti sul sito.
Risultati XML
- Google XML Risultati DTD
- Informazioni sulla risposta XML
- Risultati XML per query di ricerca standard e avanzate
- Ricerca normale/avanzata: query di esempio e risultato XML
- Ricerca normale/avanzata: tag XML
DTD dei risultati XML di Google
Google utilizza lo stesso DTD per descrivere il formato XML per tutti i tipi di risultati di ricerca. Molti dei tag e degli attributi sono applicabili a tutti i tipi di ricerca. Alcuni tag, tuttavia, sono applicabili solo per determinati tipi di ricerca. Di conseguenza, le definizioni nella DTD potrebbero essere meno restrittive rispetto a quelle fornite in questo documento.
Questo documento descrive questi aspetti della DTD che sono pertinenti per la Ricerca Google. Quando esamini la DTD, se lavori su WebSearch, puoi tranquillamente ignorare i tag e gli attributi che non sono documentati qui. Se la definizione è diversa tra DTD e documentazione, questo fatto è indicato nel presente documento.
Google può restituire risultati XML con o senza un riferimento alla DTD più recente. La DTD è una guida per aiutare gli amministratori della ricerca e i parser XML a comprendere i risultati XML di Google. Poiché di tanto in tanto la grammatica XML di Google può cambiare, non devi configurare il parser in modo da utilizzare il DTD per convalidare ogni risultato XML.
Inoltre, non devi configurare il tuo parser XML per recuperare il DTD ogni volta che invii una richiesta di ricerca. Google aggiorna le DTD raramente e queste richieste creano inutili requisiti di ritardo e larghezza di banda.
Google consiglia di utilizzare il formato di output xml_no_dtd per ottenere risultati XML. Se specifichi il formato xml output nella richiesta di ricerca, l'unica differenza è l'inclusione della seguente riga nei risultati XML:
<!DOCTYPE GSP SYSTEM "google.dtd">
Puoi accedere alla versione più recente di DTD all'indirizzo http://www.google.com/google.dtd.
Tieni presente che al momento non tutte le funzioni della DTD possono essere disponibili o supportate.
Informazioni sulla risposta XML
- Tutti i valori dell'elemento sono codice HTML valido, adatto alla visualizzazione, salvo diversa indicazione nelle definizioni dei tag XML.
- Alcuni valori degli elementi sono URL che devono essere codificati in HTML prima di essere visualizzati.
- Il parser XML dovrebbe ignorare tag e attributi non documentati. Ciò consente all'applicazione di continuare a funzionare senza modifiche se Google aggiunge altre funzionalità all'output XML.
- Alcuni caratteri devono essere preceduti da caratteri di escape quando sono inclusi come valori nei tag XML. Il processore XML dovrebbe riconvertire queste entità nei caratteri appropriati. Se non converti correttamente le entità, il browser potrebbe, ad esempio, visualizzare il carattere & come "&".
Lo standard XML documenta questi caratteri, che sono riprodotti nella tabella seguente:
Basato su caratteri Moduli con caratteri di escape Entità Codice carattere E commerciale & & & Virgolette semplici ' ' ' Virgolette doppie " " " Maggiore di > > > Minore di < < <
Risultati XML per query di ricerca regolari e avanzate
Ricerca normale/avanzata: query di esempio e risultato XML
Questa richiesta WebSearch di esempio chiede 10 risultati (num=10
) relativi al termine di ricerca "socer" (q=socer
), ovvero la parola "calcio" scritta intenzionalmente in modo errato per questo esempio.
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
Questa richiesta restituisce il risultato XML riportato di seguito. Tieni presente che il risultato XML contiene diversi commenti per indicare il punto in cui vengono visualizzati determinati tag non inclusi nel risultato.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Ricerca normale/avanzata: tag XML
Le risposte XML per le richieste di ricerca normali e per le richieste di ricerca avanzata utilizzano entrambe lo stesso insieme di tag XML. Questi tag XML sono mostrati nell'esempio XML riportato sopra e sono spiegati nelle tabelle seguenti.
I tag XML di seguito sono elencati in ordine alfabetico in base al nome del tag e ogni definizione di tag contiene una descrizione del tag, un esempio che mostra come il tag apparirebbe in un risultato XML e il formato dei contenuti del tag. Se il tag è un sottotag di un altro tag XML o se il tag ha sottotag o attributi propri, queste informazioni vengono fornite anche nella tabella di definizione del tag.
Nelle definizioni riportate di seguito potrebbero essere visualizzati alcuni simboli accanto ad alcuni sottotag. Tali simboli sono riportati di seguito, insieme al relativo significato:
* = zero o più istanze del sottotag
+ = una o più istanze del sottotag
PE | B | C | G | C | G | A | I | S | L | N | P | D | R | S | T | U | X |
anchor_text | |
---|---|
Definizione | Il tag <anchor_text> specifica il testo da mostrare agli utenti per identificare un'etichetta di perfezionamento associata a un set di risultati di ricerca. Poiché le etichette di perfezionamento sostituiscono i caratteri non alfanumerici con trattini bassi, non dovresti visualizzare il valore del tag <label> nell'interfaccia utente. Dovresti invece visualizzare il valore del tag <anchor_text>. |
Esempio | <anchor_text>Campi da golf</anchor_text> |
Sottotag di | FacetItem |
Formato dei contenuti | Testo |
BLOCCA | |
---|---|
Definizione | Questo tag include i contenuti di un blocco nel corpo del risultato di una promozione. Ogni blocco include i sottotag T, U e L. Un tag T non vuoto indica che il blocco contiene testo; i tag U e L non vuoti indicano che il blocco contiene un link (con l'URL specificato nel sottotag U e anchor text nel sottotag L). |
Sottotag | T, U, L |
Sottotag di | BODY_LINE |
Formato dei contenuti | Vuoto |
BODY_LINE | |
---|---|
Definizione | Questo tag racchiude i contenuti di una riga nel corpo del risultato promosso. Ogni riga del corpo è composta da diversi tag BLOCK, che contengono del testo o un link con URL e anchor text. |
Sottotag | BLOCCA* |
Sottotag di | SL_MAIN |
Formato dei contenuti | Vuoto |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definizione | Il tag <C> indica che il servizio WebSearch può recuperare una versione memorizzata nella cache di questo URL del risultato di ricerca. Non puoi recuperare le pagine memorizzate nella cache tramite l'API XML, ma puoi reindirizzare gli utenti a www.google.com per questi contenuti. |
|||||||||
Attributi |
|
|||||||||
Esempio | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
Sottotag di | HAS | |||||||||
Formato dei contenuti | Vuoto |
C2C | |
---|---|
Definizione | Il tag <C2C> indica che il risultato fa riferimento a una pagina in lingua cinese tradizionale. Questo tag viene visualizzato solo quando è attiva la ricerca in cinese semplificato e tradizionale. Consulta la definizione del parametro di query c2coff per ulteriori informazioni su come abilitare e disabilitare questa funzionalità. |
Formato dei contenuti | Testo |
Contesto | |
---|---|
Definizione | Il tag <Context> include un elenco di etichette di perfezionamento associate a un insieme di risultati di ricerca. |
Esempio | <Context> |
Sottotag | title, Facet+ |
Formato dei contenuti | Container |
CRAWLDATE | |
---|---|
Definizione | Il tag <CRAWLDATE> identifica la data dell'ultima scansione della pagina. |
Esempio | <CRAWLDATE>21 maggio 2005</CRAWLDATE> |
Sottotag di | R |
Formato dei contenuti | Testo |
D | |
---|---|
Definizione | Il tag <DI> include informazioni sulla categoria Open Directory Project (ODP) relative a un singolo risultato di ricerca. |
Esempio | <DI> |
Sottotag | DT?, DS? |
Sottotag di | HAS |
Formato dei contenuti | Vuoto |
DS | |
---|---|
Definizione | Il tag <DS> fornisce il riepilogo di una singola categoria nella directory ODP. |
Esempio | <DS>Pubblica il tuo curriculum <b>calcio</b> direttamente su Internet.</DS> |
Sottotag di | DI |
Formato dei contenuti | Testo (può contenere HTML) |
DT | |
---|---|
Definizione | Il tag <DT> fornisce il titolo di una singola categoria elencata nella directory ODP. |
Esempio | <DT>CalcioConnection.net</DT> |
Sottotag di | DI |
Formato dei contenuti | Testo (può contenere HTML) |
Facet | |
---|---|
Definizione | Il tag <Facet> contiene un raggruppamento logico di tag <FacetItem>. Puoi creare questi raggruppamenti utilizzando il formato delle specifiche XML di Motore di ricerca programmabile. Se non crei questi raggruppamenti, il tag results_xml_tag_Context><Context> conterrà fino a quattro tag <Facet>. Gli elementi all'interno di ogni tag <Facet> saranno raggruppati a scopo di visualizzazione, ma potrebbero non avere una relazione logica. |
Esempio | <Facet> |
Sottotag | FacetItem+, title+ |
Sottotag di | Contesto |
Formato dei contenuti | Container |
FacetItem | |
---|---|
Definizione | Il tag <FacetItem> include informazioni su un'etichetta di perfezionamento associata a un insieme di risultati di ricerca. |
Esempio | <FacetItem> |
Sottotag | etichetta, anchor_text+ |
Sottotag di | Facet |
Formato dei contenuti | FacetItem |
FI | |
---|---|
Definizione | Il tag <FI> funge da flag che indica se è stato applicato il filtro dei documenti per la ricerca. Per saperne di più sui filtri dei risultati di ricerca di Google, consulta la sezione Filtri automatici di questo documento. |
Esempio | <i> |
Sottotag di | RES |
Formato dei contenuti | Vuoto |
PSG | |||||||
---|---|---|---|---|---|---|---|
Definizione | Il tag <GSP> racchiude tutti i dati restituiti nei risultati di ricerca XML di Google. "GSP" è l'abbreviazione di "Google Search Protocol". |
||||||
Attributi |
|
||||||
Esempio | <GSP VER="3.2"> | ||||||
Sottotag | PARAM+, Q, RES?, [TM] | ||||||
Formato dei contenuti | Vuoto |
HAS | |
---|---|
Definizione | Il tag <HAS> contiene informazioni su eventuali parametri di richiesta di ricerca speciali supportati per un determinato URL.
Nota: la definizione di <HAS> per la Ricerca Web è più restrittiva rispetto alla definizione di DTD. |
Sottotag | DI?, E?, C?, RT? |
Sottotag di | R |
ISURL | |
---|---|
Definizione | Google restituisce il tag <ISURL> se la query di ricerca associata è un URL. |
Sottotag di | SPG |
Formato dei contenuti | Vuoto |
L | |
---|---|
Definizione | La presenza del tag <L> indica che il servizio WebSearch può trovare altri siti che rimandano a questo URL del risultato di ricerca. Per trovare questi siti, devi utilizzare il termine di query speciale link:. |
Sottotag di | HAS |
Formato dei contenuti | Vuoto |
etichetta | |
---|---|
Definizione | Il tag <label> specifica un'etichetta di perfezionamento che puoi utilizzare per filtrare i risultati di ricerca che ricevi. Per utilizzare un'etichetta di perfezionamento, aggiungi la stringa more:[[label tag value]] al valore del parametro q nella richiesta HTTP a Google, come mostrato nell'esempio seguente. Tieni presente che questo valore deve contenere caratteri di escape dell'URL prima di inviare la query a Google. This example uses the refinement label golf_courses to Nota: il tag <label> non corrisponde al tag <Label>, che identifica un'etichetta di perfezionamento associata a un determinato URL nei risultati di ricerca. |
Esempio | <label>corsi_golf</label> |
Sottotag di | FacetItem |
Formato dei contenuti | Testo |
lang | |
---|---|
Definizione | Il tag <LANG> contiene la migliore ipotesi di Google in merito alla lingua del risultato di ricerca. |
Esempio | <LANG>en</LANG> |
Sottotag di | R |
Formato dei contenuti | Testo |
L | |
---|---|
Definizione | Il tag <M> identifica il numero totale stimato di risultati per la ricerca. Nota: questa stima potrebbe non essere precisa. |
Esempio | <M>16200000</M> |
Sottotag di | RES |
Formato dei contenuti | Testo |
Neonato | |
---|---|
Definizione | Il tag <NB> include informazioni di navigazione relative all'insieme di risultati, ovvero rimanda alla pagina successiva o precedente dei risultati di ricerca. Nota: questo tag è presente solo se sono disponibili più risultati. |
Esempio | <NB> |
Sottotag | NU?, PU? |
Sottotag di | RES |
Formato dei contenuti | Vuoto |
NU | |
---|---|
Definizione | Il tag <NU> contiene un link relativo alla pagina successiva dei risultati di ricerca. |
Esempio | <NU>/search?q=fiori&num=10&hl=it&ie=UTF-8 &output=xml&client=test&start=10</NU> |
Sottotag di | NB |
Formato dei contenuti | Testo (URL relativo) |
PARAMETRO | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Definizione | Il tag <PARAM> identifica un parametro di input inviato nella richiesta HTTP associata al risultato XML. Le informazioni sul parametro sono contenute negli attributi del tag (name, value, original_value) e sarà presente un tag PARAM per ogni parametro inviato nella richiesta HTTP. |
||||||||||||
Attributi |
|
||||||||||||
Esempio | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
Sottotag di | SPG | ||||||||||||
Formato dei contenuti | Complesso |
PU | |
---|---|
Definizione | Il tag <PU> fornisce un link relativo alla pagina precedente dei risultati di ricerca. |
Esempio | <PU>/search?q=flowers&num=10&hl=it&output=xml &client=test&start=10</PU> |
Sottotag di | NB |
Formato dei contenuti | Testo (URL relativo) |
D | |
---|---|
Definizione | Il tag <Q> identifica la query di ricerca inviata nella richiesta HTTP associata al risultato XML. |
Esempio | <Q>pizza</Q> |
Sottotag di | SPG |
Formato dei contenuti | Testo |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definizione | Il tag <R> include i dettagli di un singolo risultato di ricerca. Nota: la definizione del tag <R> per la Ricerca Google è più restrittiva rispetto alla definizione del tag DTD. |
|||||||||
Attributi |
|
|||||||||
Sottotag | U, UE, T?, CRAWLDATE, C?, LING?, HAS | |||||||||
Sottotag di | RES |
RES | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definizione | Il tag <RES> include l'insieme di singoli risultati di ricerca e i relativi dettagli. |
|||||||||
Attributi |
|
|||||||||
Esempio | <RES SN="1" EN="10"> | |||||||||
Sottotag | M, FI?, XT?, NB?, R* | |||||||||
Sottotag di | SPG | |||||||||
Formato dei contenuti | Vuoto |
S | |
---|---|
Definizione | Il tag <S> contiene un estratto di un risultato di ricerca che mostra i termini di query evidenziati in grassetto. Le interruzioni di riga sono incluse nell'estratto per un corretto ritorno a capo. |
Esempio | <S>Washington (CNN) - La proposta di porre fine alla situazione di stallo del Senato nei confronti del Presidente <b>Bush's</b> scelte giudiziarie consentirebbe a cinque candidati di passare a un voto finale preservando la |
Sottotag di | R |
Formato dei contenuti | Testo (HTML) |
SL_MAIN | |
---|---|
Definizione | Questo tag racchiude i contenuti del risultato di una promozione. Da utilizzare per l'analisi delle promozioni. L'anchor text e l'URL del link del titolo sono contenuti rispettivamente nei sottotag T e U. Le righe del corpo del testo e dei link sono contenute nei sottotag BODY_LINE. |
Sottotag | BODY_LINE*, T, U |
Sottotag di | SL_RESULTS |
Formato dei contenuti | Vuoto |
SL_RESULTS | |
---|---|
Definizione | Tag contenitore per i risultati promossi. Una di queste verrà visualizzata ogni volta che è presente una promozione nei risultati di ricerca. Il sottotag SL_MAIN contiene i dati dei risultati principali. |
Sottotag | SL_MAIN* |
Sottotag di | R |
Formato dei contenuti | Vuoto |
Ortografia | |
---|---|
Definizione | Il tag <Spelling> contiene un suggerimento ortografico alternativo per la query inviata. Questo tag viene visualizzato solo nella prima pagina dei risultati di ricerca. I suggerimenti ortografici sono disponibili in inglese, cinese, giapponese e coreano. Nota: Google restituirà suggerimenti ortografici solo per le query in cui il valore del parametro gl è scritto in lettere minuscole. |
Esempio | <Spelling> |
Sottotag | Suggerimento |
Sottotag di | SPG |
Formato dei contenuti | Vuoto |
Suggerimento | |||||||
---|---|---|---|---|---|---|---|
Definizione | Il tag <Suggestion> contiene un suggerimento ortografico alternativo per la query inviata. Puoi utilizzare i contenuti del tag per suggerire la grafia alternativa all'utente che effettua la ricerca. Il valore dell'attributo q è il suggerimento ortografico con escape dell'URL che puoi utilizzare come termine di query. | ||||||
Attributi |
|
||||||
Esempio | <Suggerimento q="soccer"><b><i>calcio</i></b></Suggestion> | ||||||
Sottotag di | Ortografia | ||||||
Formato dei contenuti | Testo (HTML) |
T | |
---|---|
Definizione | Il tag <T> contiene il titolo del risultato. |
Esempio | <T>Pizzeria di Amici's East Coast</T> |
Sottotag di | R |
Formato dei contenuti | Testo (HTML) |
title | |
---|---|
Definizione | In quanto elemento secondario di <Context>, il tag <title> contiene il nome del tuo Motore di ricerca programmabile. Come elemento secondario di <Facet>, il tag <title> fornisce un titolo per un insieme di facet. |
Esempio | In quanto elemento secondario di <Context>: <title>My Search Engine</title> Come figlio di <Facet>: <title>facet title</title> |
Sottotag di | Contesto, Facet |
Formato dei contenuti | Testo |
TM | |
---|---|
Definizione | Il tag <TM> identifica il tempo totale impiegato dal server per restituire i risultati di ricerca, misurato in secondi. |
Esempio | <TM>0,100445</TM> |
Sottotag di | SPG |
Formato dei contenuti | Testo (numero con virgola mobile) |
TT | |
---|---|
Definizione | Il tag <TT> fornisce un suggerimento per la ricerca. |
Esempio | <TT><i>Suggerimento: per la maggior parte dei browser, la pressione del tasto Invio produce gli stessi risultati di un clic sul pulsante Cerca.</i></TT> |
Sottotag di | SPG |
U | |
---|---|
Definizione | Il tag <U> fornisce l'URL del risultato di ricerca. |
Esempio | <U>http://www.dominos.com/</U> |
Sottotag di | R |
Formato dei contenuti | Testo (URL assoluto) |
UD | |
---|---|
Definizione | Il tag <UD> fornisce l'URL con codifica IDN (International Domain Name) del risultato di ricerca. Il valore consente di visualizzare i domini nelle lingue locali. Ad esempio, l'URL con codifica IDN http://www.%E8%8A%B1%E4%BA%95.com potrebbe essere decodificato e visualizzato come http://www.花す鮨.com. Questo tag <UD> verrà incluso nei risultati di ricerca solo per le richieste che includevano il parametro ud. Nota: questa è una funzionalità beta. |
Esempio | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Sottotag di | R |
Formato dei contenuti | Testo (URL con codifica IDN) |
UE | |
---|---|
Definizione | Il tag <UE> fornisce l'URL del risultato di ricerca. Il valore contiene caratteri di escape dell'URL per poterlo trasmettere come parametro di ricerca in un URL. |
Esempio | <UE>http://www.dominos.com/</UE> |
Sottotag di | R |
Formato dei contenuti | Testo (URL con caratteri di escape) |
XT | |
---|---|
Definizione | Il tag <XT> indica che il numero totale stimato di risultati, come specificato dal tag M, rappresenta in realtà il numero totale esatto di risultati. Per ulteriori dettagli, consulta la sezione Filtri automatici di questo documento. |
Esempio | <XT /> |
Sottotag di | RES |
Formato dei contenuti | Vuoto |
Risultati XML per le query di ricerca di immagini
In questa richiesta di immagine di esempio vengono richiesti 5 risultati (num=5) relativi al termine di ricerca "scimmia" (q=scimmia).
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Questa richiesta restituisce il risultato XML riportato di seguito.
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
Ricerca immagini: tag XML
La tabella seguente mostra i tag XML aggiuntivi utilizzati nelle risposte XML per le query di ricerca di immagini.
Nelle definizioni riportate di seguito potrebbero essere visualizzati alcuni simboli accanto ad alcuni sottotag. Tali simboli sono riportati di seguito, insieme al relativo significato:
* = zero o più istanze del sottotag
+ = una o più istanze del sottotag
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definizione | Il tag <RG> include i dettagli di un risultato di ricerca di una singola immagine. |
|||||||||
Attributi |
| |||||||||
Sottotag di | RES |
RU | |
---|---|
Definizione | Il tag <tag RU> include i dettagli di ogni risultato di ricerca di immagini. |
Sottotag di | R |