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 per il tipo di oggetto corrente. Per questa API, è KEYWORD#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 Custom Search. |
url.template |
Il modello OpenSearch effettivo per questa API. |
queries |
Contiene uno o più insiemi di metadati delle query, digitati in base al nome del ruolo. I nomi di ruolo possibili includono |
queries.previousPage[] |
I metadati che rappresentano la pagina precedente dei risultati, se applicabile. |
queries.previousPage[].title |
Una descrizione della query. |
queries.previousPage[].totalResults |
Numero stimato dei risultati di ricerca totali. Potrebbero non essere precise. |
queries.previousPage[].searchTerms |
I termini di ricerca inseriti dall'utente. |
queries.previousPage[].count |
Numero di risultati di ricerca restituiti in questo insieme. |
queries.previousPage[].startIndex |
L'indice dell'insieme corrente di risultati di ricerca nell'insieme totale dei 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 nella specifica OpenSearch. I valori dei parametri 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 nella specifica 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 la sezione Filtro automatico. I valori validi per questo parametro sono:
Nota: per impostazione predefinita, Google applica i filtri a tutti i risultati di ricerca per migliorarne la qualità. |
queries.previousPage[].gl |
Aumenta i risultati di ricerca il cui paese di origine corrisponde al valore parametro. Consulta la sezione Codici paese per un elenco dei valori validi. La specifica di un valore parametro |
queries.previousPage[].cr |
Limita i risultati di ricerca a 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 i seguenti aspetti:
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 limitare la ricerca. |
queries.previousPage[].disableCnTwTranslation |
Attiva o disattiva la funzionalità Ricerca in cinese semplificato e tradizionale. I valori supportati sono:
|
queries.previousPage[].hq |
Accoda i termini di query specificati alla query, come se fossero stati combinati con un operatore |
queries.previousPage[].hl |
Specifica la lingua dell'interfaccia utente (lingua host). L'impostazione esplicita di questo parametro migliora il rendimento e la qualità dei risultati di ricerca. 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. |
queries.previousPage[].siteSearch |
Limita i risultati agli URL di un sito specificato. |
queries.previousPage[].siteSearchFilter |
Specifica se includere o escludere i risultati del sito indicato nel parametro
|
queries.previousPage[].exactTerms |
Identifica una frase che deve contenere tutti i documenti dei risultati di ricerca. |
queries.previousPage[].excludeTerms |
Identifica una parola o una frase che non deve essere presente in nessun documento dei risultati di ricerca. |
queries.previousPage[].linkSite |
Specifica che tutti i risultati devono contenere un link a un URL specifico. |
queries.previousPage[].orTerms |
Fornisce ulteriori termini di ricerca da verificare in un documento; ciascun 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 booleano OR. |
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 per 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 a 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[] |
I metadati che rappresentano la richiesta corrente. |
queries.request[].title |
Una descrizione della query. |
queries.request[].totalResults |
Numero stimato dei risultati di ricerca totali. Potrebbero non essere precise. |
queries.request[].searchTerms |
I termini di ricerca inseriti dall'utente. |
queries.request[].count |
Numero di risultati di ricerca restituiti in questo insieme. |
queries.request[].startIndex |
L'indice dell'insieme corrente di risultati di ricerca nell'insieme totale dei 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 nella specifica OpenSearch. I valori dei parametri 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 nella specifica 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 la sezione Filtro automatico. I valori validi per questo parametro sono:
Nota: per impostazione predefinita, Google applica i filtri a tutti i risultati di ricerca per migliorarne la qualità. |
queries.request[].gl |
Aumenta i risultati di ricerca il cui paese di origine corrisponde al valore parametro. Consulta la sezione Codici paese per un elenco dei valori validi. La specifica di un valore parametro |
queries.request[].cr |
Limita i risultati di ricerca a 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 i seguenti aspetti:
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 limitare la ricerca. |
queries.request[].disableCnTwTranslation |
Attiva o disattiva la funzionalità Ricerca in cinese semplificato e tradizionale. I valori supportati sono:
|
queries.request[].hq |
Accoda i termini di query specificati alla query, come se fossero stati combinati con un operatore |
queries.request[].hl |
Specifica la lingua dell'interfaccia utente (lingua host). L'impostazione esplicita di questo parametro migliora il rendimento e la qualità dei risultati di ricerca. 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. |
queries.request[].siteSearch |
Limita i risultati agli URL di un sito specificato. |
queries.request[].siteSearchFilter |
Specifica se includere o escludere i risultati del sito indicato nel parametro
|
queries.request[].exactTerms |
Identifica una frase che deve contenere tutti i documenti dei risultati di ricerca. |
queries.request[].excludeTerms |
Identifica una parola o una frase che non deve essere presente in nessun documento dei risultati di ricerca. |
queries.request[].linkSite |
Specifica che tutti i risultati devono contenere un link a un URL specifico. |
queries.request[].orTerms |
Fornisce ulteriori termini di ricerca da verificare in un documento; ciascun 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 booleano OR. |
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 per 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 a 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[] |
I 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. Potrebbero non essere precise. |
queries.nextPage[].searchTerms |
I termini di ricerca inseriti dall'utente. |
queries.nextPage[].count |
Numero di risultati di ricerca restituiti in questo insieme. |
queries.nextPage[].startIndex |
L'indice dell'insieme corrente di risultati di ricerca nell'insieme totale dei 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 nella specifica OpenSearch. I valori dei parametri 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 nella specifica 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 la sezione Filtro automatico. I valori validi per questo parametro sono:
Nota: per impostazione predefinita, Google applica i filtri a tutti i risultati di ricerca per migliorarne la qualità. |
queries.nextPage[].gl |
Aumenta i risultati di ricerca il cui paese di origine corrisponde al valore parametro. Consulta la sezione Codici paese per un elenco dei valori validi. La specifica di un valore parametro |
queries.nextPage[].cr |
Limita i risultati di ricerca a 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 i seguenti aspetti:
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 limitare la ricerca. |
queries.nextPage[].disableCnTwTranslation |
Attiva o disattiva la funzionalità Ricerca in cinese semplificato e tradizionale. I valori supportati sono:
|
queries.nextPage[].hq |
Accoda i termini di query specificati alla query, come se fossero stati combinati con un operatore |
queries.nextPage[].hl |
Specifica la lingua dell'interfaccia utente (lingua host). L'impostazione esplicita di questo parametro migliora il rendimento e la qualità dei risultati di ricerca. 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. |
queries.nextPage[].siteSearch |
Limita i risultati agli URL di un sito specificato. |
queries.nextPage[].siteSearchFilter |
Specifica se includere o escludere i risultati del sito indicato nel parametro
|
queries.nextPage[].exactTerms |
Identifica una frase che deve contenere tutti i documenti dei risultati di ricerca. |
queries.nextPage[].excludeTerms |
Identifica una parola o una frase che non deve essere presente in nessun documento dei risultati di ricerca. |
queries.nextPage[].linkSite |
Specifica che tutti i risultati devono contenere un link a un URL specifico. |
queries.nextPage[].orTerms |
Fornisce ulteriori termini di ricerca da verificare in un documento; ciascun 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 booleano OR. |
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 per 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 a 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 |
Metadati relativi a questa ricerca, tra cui data e ora della ricerca e 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, formattato 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 del risultato di questa ricerca, ad esempio www.example.com. |
bodyLines[] |
Un array di oggetti a blocchi per questa promozione. |
bodyLines[].title |
Il testo dell'oggetto blocco, se contiene testo. |
bodyLines[].htmlTitle |
Il testo dell'oggetto blocco in HTML, se contiene testo. |
bodyLines[].url |
L'URL del link dell'oggetto di blocco, se presente. |
bodyLines[].link |
L'anchor text del link dell'oggetto del blocco, se presenta un link. |
image |
Immagine associata a questa promozione, se presente. |
image.source |
URL dell'immagine del link alla promozione. |
image.width |
Larghezza dell'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 del 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 restituita 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[] |
Racchiude tutte le informazioni sulle etichette di perfezionamento. |
labels[].name |
Il nome di un'etichetta di perfezionamento, che puoi utilizzare per perfezionare le ricerche. Non mostrarlo nell'interfaccia utente; utilizza invece displayName. |
labels[].displayName |
Il nome visualizzato di un'etichetta di perfezionamento. Questo è il nome che dovresti visualizzare nell'interfaccia utente. |
labels[].label_with_op |
Etichetta di perfezionamento e operazione di perfezionamento associata. |