Risposta a una richiesta di ricerca personalizzata.
| Rappresentazione JSON |
|---|
{ "kind": string, "url": { "type": string, "template": string }, "queries": { "previousPage": [ { "title": string, "totalResults": string, "searchTerms": string, "count": integer, "startIndex": integer, "startPage": integer, "language": string, "inputEncoding": string, "outputEncoding": string, "safe": string, "cx": string, "sort": string, "filter": string, "gl": string, "cr": string, "googleHost": string, "disableCnTwTranslation": string, "hq": string, "hl": string, "siteSearch": string, "siteSearchFilter": string, "exactTerms": string, "excludeTerms": string, "linkSite": string, "orTerms": string, "relatedSite": string, "dateRestrict": string, "lowRange": string, "highRange": string, "fileType": string, "rights": string, "searchType": string, "imgSize": string, "imgType": string, "imgColorType": string, "imgDominantColor": string } ], "request": [ { "title": string, "totalResults": string, "searchTerms": string, "count": integer, "startIndex": integer, "startPage": integer, "language": string, "inputEncoding": string, "outputEncoding": string, "safe": string, "cx": string, "sort": string, "filter": string, "gl": string, "cr": string, "googleHost": string, "disableCnTwTranslation": string, "hq": string, "hl": string, "siteSearch": string, "siteSearchFilter": string, "exactTerms": string, "excludeTerms": string, "linkSite": string, "orTerms": string, "relatedSite": string, "dateRestrict": string, "lowRange": string, "highRange": string, "fileType": string, "rights": string, "searchType": string, "imgSize": string, "imgType": string, "imgColorType": string, "imgDominantColor": string } ], "nextPage": [ { "title": string, "totalResults": string, "searchTerms": string, "count": integer, "startIndex": integer, "startPage": integer, "language": string, "inputEncoding": string, "outputEncoding": string, "safe": string, "cx": string, "sort": string, "filter": string, "gl": string, "cr": string, "googleHost": string, "disableCnTwTranslation": string, "hq": string, "hl": string, "siteSearch": string, "siteSearchFilter": string, "exactTerms": string, "excludeTerms": string, "linkSite": string, "orTerms": string, "relatedSite": string, "dateRestrict": string, "lowRange": string, "highRange": string, "fileType": string, "rights": string, "searchType": string, "imgSize": string, "imgType": string, "imgColorType": string, "imgDominantColor": string } ] }, "promotions": [ { object ( |
| Campi | |
|---|---|
kind |
Identificatore univoco del tipo di oggetto corrente. Per questa API, si tratta di trattative per la ricerca#search. |
url |
L'elemento URL OpenSearch che definisce il modello per questa API. |
url.type |
Il tipo MIME del modello di URL OpenSearch per l'API JSON Ricerca personalizzata. |
url.template |
Il modello OpenSearch effettivo per questa API. |
queries |
Contiene uno o più set di metadati di query, associati al nome del ruolo. I possibili nomi dei ruoli includono |
queries.previousPage[] |
Metadati che rappresentano la pagina dei risultati precedente, se applicabile. |
queries.previousPage[].title |
Una descrizione della query. |
queries.previousPage[].totalResults |
Numero stimato dei risultati di ricerca totali. Potrebbe non essere preciso. |
queries.previousPage[].searchTerms |
I termini di ricerca inseriti dall'utente. |
queries.previousPage[].count |
Numero di risultati di ricerca restituiti in questo set. |
queries.previousPage[].startIndex |
L'indice dell'insieme corrente di risultati di ricerca nel set totale di risultati, dove l'indice del primo risultato è 1. |
queries.previousPage[].startPage |
Il numero di pagina di questo insieme di risultati, in cui la lunghezza della pagina è impostata dalla proprietà |
queries.previousPage[].language |
La lingua dei risultati di ricerca. |
queries.previousPage[].inputEncoding |
La codifica dei caratteri supportata per le richieste di ricerca. |
queries.previousPage[].outputEncoding |
La codifica dei caratteri supportata per i risultati di ricerca. |
queries.previousPage[].safe |
Specifica il livello SafeSearch utilizzato per filtrare i risultati per adulti. Questa è una proprietà personalizzata non definita nelle specifiche di OpenSearch. I valori parametro validi sono:
|
queries.previousPage[].cx |
L'identificatore di un motore creato utilizzando il pannello di controllo di Motore di ricerca programmabile. Questa è una proprietà personalizzata non definita nelle specifiche di OpenSearch. Questo parametro è obbligatorio. |
queries.previousPage[].sort |
Specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data. |
queries.previousPage[].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 l'articolo Filtro automatico. I valori validi per questo parametro sono:
Nota: per impostazione predefinita, Google applica un filtro a tutti i risultati di ricerca per migliorarne la qualità. |
queries.previousPage[].gl |
Potenzia i risultati di ricerca il cui paese di origine corrisponde al valore del parametro. Consulta la sezione Codici paese per un elenco dei valori validi. L'indicazione di un valore parametro |
queries.previousPage[].cr |
Limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro La Ricerca Google determina il paese di un documento analizzando quanto segue:
Consulta Valori parametro paese (cr) per un elenco dei valori validi per questo parametro. |
queries.previousPage[].googleHost |
Specifica il dominio Google (ad esempio, google.com, google.de o google.fr) a cui deve essere limitata la ricerca. |
queries.previousPage[].disableCnTwTranslation |
Attiva o disattiva la funzionalità di ricerca in cinese semplificato e tradizionale. I valori supportati sono:
|
queries.previousPage[].hq |
Aggiunge i termini specificati alla query, come se fossero combinati con un operatore logico |
queries.previousPage[].hl |
Specifica la lingua dell'interfaccia (host) della tua interfaccia utente. L'impostazione esplicita di questo parametro migliora il rendimento e la qualità dei risultati di ricerca. Consulta la sezione Lingue di interfaccia di Internazionalizzazione di query e presentazione dei risultati per ulteriori informazioni e Lingue di interfaccia supportate per un elenco delle lingue supportate. |
queries.previousPage[].siteSearch |
Limita i risultati agli URL di un sito specifico. |
queries.previousPage[].siteSearchFilter |
Specifica se includere o escludere i risultati dal sito indicato nel parametro
|
queries.previousPage[].exactTerms |
Identifica una frase che deve contenere tutti i documenti nei risultati di ricerca. |
queries.previousPage[].excludeTerms |
Identifica una parola o una frase che non deve comparire in nessun documento nei risultati di ricerca. |
queries.previousPage[].linkSite |
Specifica che tutti i risultati devono contenere un link a un URL specifico. |
queries.previousPage[].orTerms |
Fornisce termini di ricerca aggiuntivi da verificare in un documento, dove ogni documento nei risultati di ricerca deve contenere almeno uno dei termini di ricerca aggiuntivi. Per questo tipo di query puoi anche utilizzare il termine di query OR booleano. |
queries.previousPage[].relatedSite |
Specifica che tutti i risultati di ricerca devono essere pagine correlate all'URL specificato. Il valore del parametro deve essere un URL. |
queries.previousPage[].dateRestrict |
Limita i risultati agli URL in base alla data. I valori supportati includono:
|
queries.previousPage[].lowRange |
Specifica il valore iniziale per un intervallo di ricerca. Utilizza |
queries.previousPage[].highRange |
Specifica il valore finale di un intervallo di ricerca. Utilizza |
queries.previousPage[].fileType |
Limita i risultati ai file con un'estensione specificata. 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. |
queries.previousPage[].rights |
Filtri basati sulle licenze. I valori supportati includono:
|
queries.previousPage[].searchType |
I valori consentiti sono |
queries.previousPage[].imgSize |
Limita i risultati alle immagini di dimensioni specificate. I valori supportati sono:
|
queries.previousPage[].imgType |
Limita i risultati alle immagini di un tipo specificato. I valori supportati sono:
|
queries.previousPage[].imgColorType |
Limita i risultati alle immagini di un tipo di colore specificato. I valori supportati sono:
|
queries.previousPage[].imgDominantColor |
Limita i risultati alle immagini con un colore dominante specifico. I valori supportati sono:
|
queries.request[] |
Metadati che rappresentano la richiesta corrente. |
queries.request[].title |
Una descrizione della query. |
queries.request[].totalResults |
Numero stimato dei risultati di ricerca totali. Potrebbe non essere preciso. |
queries.request[].searchTerms |
I termini di ricerca inseriti dall'utente. |
queries.request[].count |
Numero di risultati di ricerca restituiti in questo set. |
queries.request[].startIndex |
L'indice dell'insieme corrente di risultati di ricerca nel set totale di risultati, dove l'indice del primo risultato è 1. |
queries.request[].startPage |
Il numero di pagina di questo insieme di risultati, in cui la lunghezza della pagina è impostata dalla proprietà |
queries.request[].language |
La lingua dei risultati di ricerca. |
queries.request[].inputEncoding |
La codifica dei caratteri supportata per le richieste di ricerca. |
queries.request[].outputEncoding |
La codifica dei caratteri supportata per i risultati di ricerca. |
queries.request[].safe |
Specifica il livello SafeSearch utilizzato per filtrare i risultati per adulti. Questa è una proprietà personalizzata non definita nelle specifiche di OpenSearch. I valori parametro validi sono:
|
queries.request[].cx |
L'identificatore di un motore creato utilizzando il pannello di controllo di Motore di ricerca programmabile. Questa è una proprietà personalizzata non definita nelle specifiche di OpenSearch. Questo parametro è obbligatorio. |
queries.request[].sort |
Specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data. |
queries.request[].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 l'articolo Filtro automatico. I valori validi per questo parametro sono:
Nota: per impostazione predefinita, Google applica un filtro a tutti i risultati di ricerca per migliorarne la qualità. |
queries.request[].gl |
Potenzia i risultati di ricerca il cui paese di origine corrisponde al valore del parametro. Consulta la sezione Codici paese per un elenco dei valori validi. L'indicazione di un valore parametro |
queries.request[].cr |
Limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro La Ricerca Google determina il paese di un documento analizzando quanto segue:
Consulta Valori parametro paese (cr) per un elenco dei valori validi per questo parametro. |
queries.request[].googleHost |
Specifica il dominio Google (ad esempio, google.com, google.de o google.fr) a cui deve essere limitata la ricerca. |
queries.request[].disableCnTwTranslation |
Attiva o disattiva la funzionalità di ricerca in cinese semplificato e tradizionale. I valori supportati sono:
|
queries.request[].hq |
Aggiunge i termini specificati alla query, come se fossero combinati con un operatore logico |
queries.request[].hl |
Specifica la lingua dell'interfaccia (host) della tua interfaccia utente. L'impostazione esplicita di questo parametro migliora il rendimento e la qualità dei risultati di ricerca. Consulta la sezione Lingue di interfaccia di Internazionalizzazione di query e presentazione dei risultati per ulteriori informazioni e Lingue di interfaccia supportate per un elenco delle lingue supportate. |
queries.request[].siteSearch |
Limita i risultati agli URL di un sito specifico. |
queries.request[].siteSearchFilter |
Specifica se includere o escludere i risultati dal sito indicato nel parametro
|
queries.request[].exactTerms |
Identifica una frase che deve contenere tutti i documenti nei risultati di ricerca. |
queries.request[].excludeTerms |
Identifica una parola o una frase che non deve comparire in nessun documento nei risultati di ricerca. |
queries.request[].linkSite |
Specifica che tutti i risultati devono contenere un link a un URL specifico. |
queries.request[].orTerms |
Fornisce termini di ricerca aggiuntivi da verificare in un documento, dove ogni documento nei risultati di ricerca deve contenere almeno uno dei termini di ricerca aggiuntivi. Per questo tipo di query puoi anche utilizzare il termine di query OR booleano. |
queries.request[].relatedSite |
Specifica che tutti i risultati di ricerca devono essere pagine correlate all'URL specificato. Il valore del parametro deve essere un URL. |
queries.request[].dateRestrict |
Limita i risultati agli URL in base alla data. I valori supportati includono:
|
queries.request[].lowRange |
Specifica il valore iniziale per un intervallo di ricerca. Utilizza |
queries.request[].highRange |
Specifica il valore finale di un intervallo di ricerca. Utilizza |
queries.request[].fileType |
Limita i risultati ai file con un'estensione specificata. 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. |
queries.request[].rights |
Filtri basati sulle licenze. I valori supportati includono:
|
queries.request[].searchType |
I valori consentiti sono |
queries.request[].imgSize |
Limita i risultati alle immagini di dimensioni specificate. I valori supportati sono:
|
queries.request[].imgType |
Limita i risultati alle immagini di un tipo specificato. I valori supportati sono:
|
queries.request[].imgColorType |
Limita i risultati alle immagini di un tipo di colore specificato. I valori supportati sono:
|
queries.request[].imgDominantColor |
Limita i risultati alle immagini con un colore dominante specifico. I valori supportati sono:
|
queries.nextPage[] |
Metadati che rappresentano la pagina successiva dei risultati, se applicabile. |
queries.nextPage[].title |
Una descrizione della query. |
queries.nextPage[].totalResults |
Numero stimato dei risultati di ricerca totali. Potrebbe non essere preciso. |
queries.nextPage[].searchTerms |
I termini di ricerca inseriti dall'utente. |
queries.nextPage[].count |
Numero di risultati di ricerca restituiti in questo set. |
queries.nextPage[].startIndex |
L'indice dell'insieme corrente di risultati di ricerca nel set totale di risultati, dove l'indice del primo risultato è 1. |
queries.nextPage[].startPage |
Il numero di pagina di questo insieme di risultati, in cui la lunghezza della pagina è impostata dalla proprietà |
queries.nextPage[].language |
La lingua dei risultati di ricerca. |
queries.nextPage[].inputEncoding |
La codifica dei caratteri supportata per le richieste di ricerca. |
queries.nextPage[].outputEncoding |
La codifica dei caratteri supportata per i risultati di ricerca. |
queries.nextPage[].safe |
Specifica il livello SafeSearch utilizzato per filtrare i risultati per adulti. Questa è una proprietà personalizzata non definita nelle specifiche di OpenSearch. I valori parametro validi sono:
|
queries.nextPage[].cx |
L'identificatore di un motore creato utilizzando il pannello di controllo di Motore di ricerca programmabile. Questa è una proprietà personalizzata non definita nelle specifiche di OpenSearch. Questo parametro è obbligatorio. |
queries.nextPage[].sort |
Specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data. |
queries.nextPage[].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 l'articolo Filtro automatico. I valori validi per questo parametro sono:
Nota: per impostazione predefinita, Google applica un filtro a tutti i risultati di ricerca per migliorarne la qualità. |
queries.nextPage[].gl |
Potenzia i risultati di ricerca il cui paese di origine corrisponde al valore del parametro. Consulta la sezione Codici paese per un elenco dei valori validi. L'indicazione di un valore parametro |
queries.nextPage[].cr |
Limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro La Ricerca Google determina il paese di un documento analizzando quanto segue:
Consulta Valori parametro paese (cr) per un elenco dei valori validi per questo parametro. |
queries.nextPage[].googleHost |
Specifica il dominio Google (ad esempio, google.com, google.de o google.fr) a cui deve essere limitata la ricerca. |
queries.nextPage[].disableCnTwTranslation |
Attiva o disattiva la funzionalità di ricerca in cinese semplificato e tradizionale. I valori supportati sono:
|
queries.nextPage[].hq |
Aggiunge i termini specificati alla query, come se fossero combinati con un operatore logico |
queries.nextPage[].hl |
Specifica la lingua dell'interfaccia (host) della tua interfaccia utente. L'impostazione esplicita di questo parametro migliora il rendimento e la qualità dei risultati di ricerca. Consulta la sezione Lingue di interfaccia di Internazionalizzazione di query e presentazione dei risultati per ulteriori informazioni e Lingue di interfaccia supportate per un elenco delle lingue supportate. |
queries.nextPage[].siteSearch |
Limita i risultati agli URL di un sito specifico. |
queries.nextPage[].siteSearchFilter |
Specifica se includere o escludere i risultati dal sito indicato nel parametro
|
queries.nextPage[].exactTerms |
Identifica una frase che deve contenere tutti i documenti nei risultati di ricerca. |
queries.nextPage[].excludeTerms |
Identifica una parola o una frase che non deve comparire in nessun documento nei risultati di ricerca. |
queries.nextPage[].linkSite |
Specifica che tutti i risultati devono contenere un link a un URL specifico. |
queries.nextPage[].orTerms |
Fornisce termini di ricerca aggiuntivi da verificare in un documento, dove ogni documento nei risultati di ricerca deve contenere almeno uno dei termini di ricerca aggiuntivi. Per questo tipo di query puoi anche utilizzare il termine di query OR booleano. |
queries.nextPage[].relatedSite |
Specifica che tutti i risultati di ricerca devono essere pagine correlate all'URL specificato. Il valore del parametro deve essere un URL. |
queries.nextPage[].dateRestrict |
Limita i risultati agli URL in base alla data. I valori supportati includono:
|
queries.nextPage[].lowRange |
Specifica il valore iniziale per un intervallo di ricerca. Utilizza |
queries.nextPage[].highRange |
Specifica il valore finale di un intervallo di ricerca. Utilizza |
queries.nextPage[].fileType |
Limita i risultati ai file con un'estensione specificata. 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. |
queries.nextPage[].rights |
Filtri basati sulle licenze. I valori supportati includono:
|
queries.nextPage[].searchType |
I valori consentiti sono |
queries.nextPage[].imgSize |
Limita i risultati alle immagini di dimensioni specificate. I valori supportati sono:
|
queries.nextPage[].imgType |
Limita i risultati alle immagini di un tipo specificato. I valori supportati sono:
|
queries.nextPage[].imgColorType |
Limita i risultati alle immagini di un tipo di colore specificato. I valori supportati sono:
|
queries.nextPage[].imgDominantColor |
Limita i risultati alle immagini con un colore dominante specifico. I valori supportati sono:
|
promotions[] |
L'insieme di promozioni. Presente solo se i file di configurazione del motore di ricerca personalizzato definiscono promozioni per la query specificata. |
context |
Metadati e perfezionamenti associati al motore di ricerca specificato, tra cui:
|
searchInformation |
I metadati relativi a questa ricerca, inclusi il tempo di ricerca e i risultati totali. |
searchInformation.searchTime |
Il tempo impiegato dal server per restituire i risultati di ricerca. |
searchInformation.formattedSearchTime |
Il tempo impiegato dal server per restituire i risultati di ricerca, formattati in base allo stile delle impostazioni internazionali. |
searchInformation.totalResults |
Il numero totale di risultati di ricerca restituiti dalla query. |
searchInformation.formattedTotalResults |
Il numero totale di risultati di ricerca, formattati in base allo stile delle impostazioni internazionali. |
spelling |
Incapsula una query corretta. |
spelling.correctedQuery |
La query corretta. |
spelling.htmlCorrectedQuery |
La query corretta, formattata in HTML. |
items[] |
L'insieme corrente di risultati di ricerca personalizzati. |
Promozione
Risultato della promozione.
| Rappresentazione JSON |
|---|
{ "title": string, "htmlTitle": string, "link": string, "displayLink": string, "bodyLines": [ { "title": string, "htmlTitle": string, "url": string, "link": string } ], "image": { "source": string, "width": integer, "height": integer } } |
| Campi | |
|---|---|
title |
Il titolo della promozione. |
htmlTitle |
Il titolo della promozione, in HTML. |
link |
L'URL della promozione. |
displayLink |
Una versione ridotta dell'URL dei risultati di ricerca, ad esempio www.example.com. |
bodyLines[] |
Un array di oggetti di blocco per questa promozione. |
bodyLines[].title |
Il testo dell'oggetto del blocco, se presente. |
bodyLines[].htmlTitle |
Il testo dell'oggetto di blocco in HTML, se presente. |
bodyLines[].url |
L'URL del link dell'oggetto del blocco, se presente. |
bodyLines[].link |
L'anchor text del link dell'oggetto del blocco, se ha un link. |
image |
Immagine associata a questa promozione, se presente. |
image.source |
URL dell'immagine per questo link promozionale. |
image.width |
Larghezza immagine in pixel. |
image.height |
Altezza dell'immagine in pixel. |
Risultato
Un risultato di ricerca personalizzato.
| Rappresentazione JSON |
|---|
{ "kind": string, "title": string, "htmlTitle": string, "link": string, "displayLink": string, "snippet": string, "htmlSnippet": string, "cacheId": string, "formattedUrl": string, "htmlFormattedUrl": string, "pagemap": { object }, "mime": string, "fileFormat": string, "image": { "contextLink": string, "height": integer, "width": integer, "byteSize": integer, "thumbnailLink": string, "thumbnailHeight": integer, "thumbnailWidth": integer }, "labels": [ { "name": string, "displayName": string, "label_with_op": string } ] } |
| Campi | |
|---|---|
kind |
Un identificatore univoco per il tipo di oggetto corrente. Per questa API, è |
title |
Il titolo del risultato di ricerca in testo normale. |
htmlTitle |
Il titolo del risultato di ricerca in HTML. |
link |
L'URL completo a cui rimanda il risultato di ricerca, ad esempio http://www.example.com/foo/bar. |
displayLink |
Una versione ridotta dell'URL di questo risultato di ricerca, ad esempio www.example.com. |
snippet |
Lo snippet del risultato di ricerca, in testo normale. |
htmlSnippet |
Lo snippet del risultato di ricerca in HTML. |
cacheId |
Indica l'ID della versione del risultato di ricerca memorizzata nella cache di Google. |
formattedUrl |
L'URL visualizzato dopo lo snippet per ogni risultato di ricerca. |
htmlFormattedUrl |
L'URL in formato HTML visualizzato dopo lo snippet per ogni risultato di ricerca. |
pagemap |
Contiene informazioni PageMap per questo risultato di ricerca. |
mime |
Il tipo MIME del risultato di ricerca. |
fileFormat |
Il formato file del risultato di ricerca. |
image |
Include tutte le informazioni su un'immagine restituite nei risultati di ricerca. |
image.contextLink |
Un URL che rimanda alla pagina web che ospita l'immagine. |
image.height |
L'altezza dell'immagine, in pixel. |
image.width |
La larghezza dell'immagine, in pixel. |
image.byteSize |
Le dimensioni dell'immagine, in byte. |
image.thumbnailLink |
Un URL che rimanda all'immagine in miniatura. |
image.thumbnailHeight |
L'altezza dell'immagine in miniatura, in pixel. |
image.thumbnailWidth |
La larghezza dell'immagine in miniatura, in pixel. |
labels[] |
Incapsula tutte le informazioni sulle etichette di perfezionamento. |
labels[].name |
Il nome di un'etichetta di perfezionamento, che puoi utilizzare per perfezionare le ricerche. Non visualizzare questa informazione nell'interfaccia utente. usa displayName. |
labels[].displayName |
Il nome visualizzato di un'etichetta di perfezionamento. Si tratta del nome da visualizzare nell'interfaccia utente. |
labels[].label_with_op |
Etichetta di perfezionamento e operazione di perfezionamento associata. |