Search

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 (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Campi
kind

string

Identificatore univoco del tipo di oggetto corrente. Per questa API, si tratta di trattative per la ricerca#search.

url

object

L'elemento URL OpenSearch che definisce il modello per questa API.

url.type

string

Il tipo MIME del modello di URL OpenSearch per l'API JSON Ricerca personalizzata.

url.template

string

Il modello OpenSearch effettivo per questa API.

queries

object

Contiene uno o più set di metadati di query, associati al nome del ruolo. I possibili nomi dei ruoli includono request definito dai ruoli Query OpenSearch e due ruoli personalizzati: nextPage e previousPage.

queries.previousPage[]

object

Metadati che rappresentano la pagina dei risultati precedente, se applicabile.

queries.previousPage[].title

string

Una descrizione della query.

queries.previousPage[].totalResults

string (int64 format)

Numero stimato dei risultati di ricerca totali. Potrebbe non essere preciso.

queries.previousPage[].searchTerms

string

I termini di ricerca inseriti dall'utente.

queries.previousPage[].count

integer

Numero di risultati di ricerca restituiti in questo set.

queries.previousPage[].startIndex

integer

L'indice dell'insieme corrente di risultati di ricerca nel set totale di risultati, dove l'indice del primo risultato è 1.

queries.previousPage[].startPage

integer

Il numero di pagina di questo insieme di risultati, in cui la lunghezza della pagina è impostata dalla proprietà count.

queries.previousPage[].language

string

La lingua dei risultati di ricerca.

queries.previousPage[].inputEncoding

string

La codifica dei caratteri supportata per le richieste di ricerca.

queries.previousPage[].outputEncoding

string

La codifica dei caratteri supportata per i risultati di ricerca.

queries.previousPage[].safe

string

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:

  • "off": disattiva SafeSearch

  • "active": attiva SafeSearch

queries.previousPage[].cx

string

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

string

Specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data.

queries.previousPage[].filter

string

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:

  • 0: disabilitato

  • 1: attivato (impostazione predefinita)

Nota: per impostazione predefinita, Google applica un filtro a tutti i risultati di ricerca per migliorarne la qualità.

queries.previousPage[].gl

string

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 gl nelle richieste WebSearch dovrebbe migliorare la pertinenza dei risultati. Ciò è particolarmente vero per i clienti internazionali e, più in particolare, per i clienti di paesi anglofoni diversi dagli Stati Uniti.

queries.previousPage[].cr

string

Limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro cr.

La Ricerca Google determina il paese di un documento analizzando quanto segue:

  • Il dominio di primo livello (TLD) dell'URL del documento.

  • La posizione geografica dell'indirizzo IP del server web.

Consulta Valori parametro paese (cr) per un elenco dei valori validi per questo parametro.

queries.previousPage[].googleHost

string

Specifica il dominio Google (ad esempio, google.com, google.de o google.fr) a cui deve essere limitata la ricerca.

queries.previousPage[].disableCnTwTranslation

string

Attiva o disattiva la funzionalità di ricerca in cinese semplificato e tradizionale.

I valori supportati sono:

  • 0: attivato (impostazione predefinita)

  • 1: disattivata

queries.previousPage[].hq

string

Aggiunge i termini specificati alla query, come se fossero combinati con un operatore logico AND.

queries.previousPage[].hl

string

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

string

Limita i risultati agli URL di un sito specifico.

queries.previousPage[].siteSearchFilter

string

Specifica se includere o escludere i risultati dal sito indicato nel parametro sitesearch. I valori supportati sono:

  • i: include contenuti del sito

  • e: escludi contenuti dal sito

queries.previousPage[].exactTerms

string

Identifica una frase che deve contenere tutti i documenti nei risultati di ricerca.

queries.previousPage[].excludeTerms

string

Identifica una parola o una frase che non deve comparire in nessun documento nei risultati di ricerca.

queries.previousPage[].linkSite

string

Specifica che tutti i risultati devono contenere un link a un URL specifico.

queries.previousPage[].orTerms

string

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

string

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

string

Limita i risultati agli URL in base alla data. I valori supportati includono:

  • d[number]: richiede i risultati per il numero specificato di giorni precedenti.

  • w[number]: richiede i risultati per il numero specificato di settimane passate.

  • m[number]: richiede i risultati del numero specificato di mesi precedenti.

  • y[number]: richiede i risultati del numero specificato di anni precedenti.

queries.previousPage[].lowRange

string

Specifica il valore iniziale per un intervallo di ricerca. Utilizza cse:lowRange e cse:highrange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.

queries.previousPage[].highRange

string

Specifica il valore finale di un intervallo di ricerca. Utilizza cse:lowRange e cse:highrange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.

queries.previousPage[].fileType

string

Limita i risultati ai file con un'estensione specificata. I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Scrittura Mac (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Scrittura Microsoft (wri)

  • RTF (rtf)

  • Flash Shockwave (swf)

  • Testo (ans, txt).

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

string

Filtri basati sulle licenze. I valori supportati includono:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

I valori consentiti sono web o image. Se non specificato, i risultati sono limitati alle pagine web.

queries.previousPage[].imgSize

string

Limita i risultati alle immagini di dimensioni specificate. I valori supportati sono:

  • icon (piccolo)

  • small | medium | large | xlarge (medio)

  • xxlarge (grande)

  • huge (molto grande)

queries.previousPage[].imgType

string

Limita i risultati alle immagini di un tipo specificato. I valori supportati sono:

  • clipart (Clip art)

  • face (volto)

  • lineart (disegno a linee)

  • photo (foto)

  • animated (animato)

  • stock (azione)

queries.previousPage[].imgColorType

string

Limita i risultati alle immagini di un tipo di colore specificato. I valori supportati sono:

  • mono (bianco e nero)

  • gray (scala di grigi)

  • color (colore)

queries.previousPage[].imgDominantColor

string

Limita i risultati alle immagini con un colore dominante specifico. I valori supportati sono:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Metadati che rappresentano la richiesta corrente.

queries.request[].title

string

Una descrizione della query.

queries.request[].totalResults

string (int64 format)

Numero stimato dei risultati di ricerca totali. Potrebbe non essere preciso.

queries.request[].searchTerms

string

I termini di ricerca inseriti dall'utente.

queries.request[].count

integer

Numero di risultati di ricerca restituiti in questo set.

queries.request[].startIndex

integer

L'indice dell'insieme corrente di risultati di ricerca nel set totale di risultati, dove l'indice del primo risultato è 1.

queries.request[].startPage

integer

Il numero di pagina di questo insieme di risultati, in cui la lunghezza della pagina è impostata dalla proprietà count.

queries.request[].language

string

La lingua dei risultati di ricerca.

queries.request[].inputEncoding

string

La codifica dei caratteri supportata per le richieste di ricerca.

queries.request[].outputEncoding

string

La codifica dei caratteri supportata per i risultati di ricerca.

queries.request[].safe

string

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:

  • "off": disattiva SafeSearch

  • "active": attiva SafeSearch

queries.request[].cx

string

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

string

Specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data.

queries.request[].filter

string

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:

  • 0: disabilitato

  • 1: attivato (impostazione predefinita)

Nota: per impostazione predefinita, Google applica un filtro a tutti i risultati di ricerca per migliorarne la qualità.

queries.request[].gl

string

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 gl nelle richieste WebSearch dovrebbe migliorare la pertinenza dei risultati. Ciò è particolarmente vero per i clienti internazionali e, più in particolare, per i clienti di paesi anglofoni diversi dagli Stati Uniti.

queries.request[].cr

string

Limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro cr.

La Ricerca Google determina il paese di un documento analizzando quanto segue:

  • Il dominio di primo livello (TLD) dell'URL del documento.

  • La posizione geografica dell'indirizzo IP del server web.

Consulta Valori parametro paese (cr) per un elenco dei valori validi per questo parametro.

queries.request[].googleHost

string

Specifica il dominio Google (ad esempio, google.com, google.de o google.fr) a cui deve essere limitata la ricerca.

queries.request[].disableCnTwTranslation

string

Attiva o disattiva la funzionalità di ricerca in cinese semplificato e tradizionale.

I valori supportati sono:

  • 0: attivato (impostazione predefinita)

  • 1: disattivata

queries.request[].hq

string

Aggiunge i termini specificati alla query, come se fossero combinati con un operatore logico AND.

queries.request[].hl

string

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

string

Limita i risultati agli URL di un sito specifico.

queries.request[].siteSearchFilter

string

Specifica se includere o escludere i risultati dal sito indicato nel parametro sitesearch. I valori supportati sono:

  • i: include contenuti del sito

  • e: escludi contenuti dal sito

queries.request[].exactTerms

string

Identifica una frase che deve contenere tutti i documenti nei risultati di ricerca.

queries.request[].excludeTerms

string

Identifica una parola o una frase che non deve comparire in nessun documento nei risultati di ricerca.

queries.request[].linkSite

string

Specifica che tutti i risultati devono contenere un link a un URL specifico.

queries.request[].orTerms

string

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

string

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

string

Limita i risultati agli URL in base alla data. I valori supportati includono:

  • d[number]: richiede i risultati per il numero specificato di giorni precedenti.

  • w[number]: richiede i risultati per il numero specificato di settimane passate.

  • m[number]: richiede i risultati del numero specificato di mesi precedenti.

  • y[number]: richiede i risultati del numero specificato di anni precedenti.

queries.request[].lowRange

string

Specifica il valore iniziale per un intervallo di ricerca. Utilizza cse:lowRange e cse:highrange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.

queries.request[].highRange

string

Specifica il valore finale di un intervallo di ricerca. Utilizza cse:lowRange e cse:highrange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.

queries.request[].fileType

string

Limita i risultati ai file con un'estensione specificata. I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Scrittura Mac (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Scrittura Microsoft (wri)

  • RTF (rtf)

  • Flash Shockwave (swf)

  • Testo (ans, txt).

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

string

Filtri basati sulle licenze. I valori supportati includono:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

I valori consentiti sono web o image. Se non specificato, i risultati sono limitati alle pagine web.

queries.request[].imgSize

string

Limita i risultati alle immagini di dimensioni specificate. I valori supportati sono:

  • icon (piccolo)

  • small | medium | large | xlarge (medio)

  • xxlarge (grande)

  • huge (molto grande)

queries.request[].imgType

string

Limita i risultati alle immagini di un tipo specificato. I valori supportati sono:

  • clipart (Clip art)

  • face (volto)

  • lineart (disegno a linee)

  • photo (foto)

  • animated (animato)

  • stock (azione)

queries.request[].imgColorType

string

Limita i risultati alle immagini di un tipo di colore specificato. I valori supportati sono:

  • mono (bianco e nero)

  • gray (scala di grigi)

  • color (colore)

queries.request[].imgDominantColor

string

Limita i risultati alle immagini con un colore dominante specifico. I valori supportati sono:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Metadati che rappresentano la pagina successiva dei risultati, se applicabile.

queries.nextPage[].title

string

Una descrizione della query.

queries.nextPage[].totalResults

string (int64 format)

Numero stimato dei risultati di ricerca totali. Potrebbe non essere preciso.

queries.nextPage[].searchTerms

string

I termini di ricerca inseriti dall'utente.

queries.nextPage[].count

integer

Numero di risultati di ricerca restituiti in questo set.

queries.nextPage[].startIndex

integer

L'indice dell'insieme corrente di risultati di ricerca nel set totale di risultati, dove l'indice del primo risultato è 1.

queries.nextPage[].startPage

integer

Il numero di pagina di questo insieme di risultati, in cui la lunghezza della pagina è impostata dalla proprietà count.

queries.nextPage[].language

string

La lingua dei risultati di ricerca.

queries.nextPage[].inputEncoding

string

La codifica dei caratteri supportata per le richieste di ricerca.

queries.nextPage[].outputEncoding

string

La codifica dei caratteri supportata per i risultati di ricerca.

queries.nextPage[].safe

string

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:

  • "off": disattiva SafeSearch

  • "active": attiva SafeSearch

queries.nextPage[].cx

string

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

string

Specifica che i risultati devono essere ordinati in base all'espressione specificata. Ad esempio, ordina per data.

queries.nextPage[].filter

string

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:

  • 0: disabilitato

  • 1: attivato (impostazione predefinita)

Nota: per impostazione predefinita, Google applica un filtro a tutti i risultati di ricerca per migliorarne la qualità.

queries.nextPage[].gl

string

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 gl nelle richieste WebSearch dovrebbe migliorare la pertinenza dei risultati. Ciò è particolarmente vero per i clienti internazionali e, più in particolare, per i clienti di paesi anglofoni diversi dagli Stati Uniti.

queries.nextPage[].cr

string

Limita i risultati di ricerca ai documenti provenienti da un determinato paese. Puoi utilizzare gli operatori booleani nel valore del parametro cr.

La Ricerca Google determina il paese di un documento analizzando quanto segue:

  • Il dominio di primo livello (TLD) dell'URL del documento.

  • La posizione geografica dell'indirizzo IP del server web.

Consulta Valori parametro paese (cr) per un elenco dei valori validi per questo parametro.

queries.nextPage[].googleHost

string

Specifica il dominio Google (ad esempio, google.com, google.de o google.fr) a cui deve essere limitata la ricerca.

queries.nextPage[].disableCnTwTranslation

string

Attiva o disattiva la funzionalità di ricerca in cinese semplificato e tradizionale.

I valori supportati sono:

  • 0: attivato (impostazione predefinita)

  • 1: disattivata

queries.nextPage[].hq

string

Aggiunge i termini specificati alla query, come se fossero combinati con un operatore logico AND.

queries.nextPage[].hl

string

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

string

Limita i risultati agli URL di un sito specifico.

queries.nextPage[].siteSearchFilter

string

Specifica se includere o escludere i risultati dal sito indicato nel parametro sitesearch. I valori supportati sono:

  • i: include contenuti del sito

  • e: escludi contenuti dal sito

queries.nextPage[].exactTerms

string

Identifica una frase che deve contenere tutti i documenti nei risultati di ricerca.

queries.nextPage[].excludeTerms

string

Identifica una parola o una frase che non deve comparire in nessun documento nei risultati di ricerca.

queries.nextPage[].linkSite

string

Specifica che tutti i risultati devono contenere un link a un URL specifico.

queries.nextPage[].orTerms

string

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

string

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

string

Limita i risultati agli URL in base alla data. I valori supportati includono:

  • d[number]: richiede i risultati per il numero specificato di giorni precedenti.

  • w[number]: richiede i risultati per il numero specificato di settimane passate.

  • m[number]: richiede i risultati del numero specificato di mesi precedenti.

  • y[number]: richiede i risultati del numero specificato di anni precedenti.

queries.nextPage[].lowRange

string

Specifica il valore iniziale per un intervallo di ricerca. Utilizza cse:lowRange e cse:highrange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.

queries.nextPage[].highRange

string

Specifica il valore finale di un intervallo di ricerca. Utilizza cse:lowRange e cse:highrange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.

queries.nextPage[].fileType

string

Limita i risultati ai file con un'estensione specificata. I tipi di file supportati da Google includono:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Scrittura Mac (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Scrittura Microsoft (wri)

  • RTF (rtf)

  • Flash Shockwave (swf)

  • Testo (ans, txt).

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

string

Filtri basati sulle licenze. I valori supportati includono:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

I valori consentiti sono web o image. Se non specificato, i risultati sono limitati alle pagine web.

queries.nextPage[].imgSize

string

Limita i risultati alle immagini di dimensioni specificate. I valori supportati sono:

  • icon (piccolo)

  • small | medium | large | xlarge (medio)

  • xxlarge (grande)

  • huge (molto grande)

queries.nextPage[].imgType

string

Limita i risultati alle immagini di un tipo specificato. I valori supportati sono:

  • clipart (Clip art)

  • face (volto)

  • lineart (disegno a linee)

  • photo (foto)

  • animated (animato)

  • stock (azione)

queries.nextPage[].imgColorType

string

Limita i risultati alle immagini di un tipo di colore specificato. I valori supportati sono:

  • mono (bianco e nero)

  • gray (scala di grigi)

  • color (colore)

queries.nextPage[].imgDominantColor

string

Limita i risultati alle immagini con un colore dominante specifico. I valori supportati sono:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

L'insieme di promozioni. Presente solo se i file di configurazione del motore di ricerca personalizzato definiscono promozioni per la query specificata.

context

object (Struct format)

Metadati e perfezionamenti associati al motore di ricerca specificato, tra cui:

  • Il nome del motore di ricerca utilizzato per la query.

  • Un insieme di oggetti facet (perfezionamenti) che puoi utilizzare per perfezionare una ricerca.

searchInformation

object

I metadati relativi a questa ricerca, inclusi il tempo di ricerca e i risultati totali.

searchInformation.searchTime

number

Il tempo impiegato dal server per restituire i risultati di ricerca.

searchInformation.formattedSearchTime

string

Il tempo impiegato dal server per restituire i risultati di ricerca, formattati in base allo stile delle impostazioni internazionali.

searchInformation.totalResults

string

Il numero totale di risultati di ricerca restituiti dalla query.

searchInformation.formattedTotalResults

string

Il numero totale di risultati di ricerca, formattati in base allo stile delle impostazioni internazionali.

spelling

object

Incapsula una query corretta.

spelling.correctedQuery

string

La query corretta.

spelling.htmlCorrectedQuery

string

La query corretta, formattata in HTML.

items[]

object (Result)

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

string

Il titolo della promozione.

htmlTitle

string

Il titolo della promozione, in HTML.

bodyLines[]

object

Un array di oggetti di blocco per questa promozione.

bodyLines[].title

string

Il testo dell'oggetto del blocco, se presente.

bodyLines[].htmlTitle

string

Il testo dell'oggetto di blocco in HTML, se presente.

bodyLines[].url

string

L'URL del link dell'oggetto del blocco, se presente.

bodyLines[].link

string

L'anchor text del link dell'oggetto del blocco, se ha un link.

image

object

Immagine associata a questa promozione, se presente.

image.source

string

URL dell'immagine per questo link promozionale.

image.width

integer

Larghezza immagine in pixel.

image.height

integer

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

string

Un identificatore univoco per il tipo di oggetto corrente. Per questa API, è customsearch#result.

title

string

Il titolo del risultato di ricerca in testo normale.

htmlTitle

string

Il titolo del risultato di ricerca in HTML.

snippet

string

Lo snippet del risultato di ricerca, in testo normale.

htmlSnippet

string

Lo snippet del risultato di ricerca in HTML.

cacheId

string

Indica l'ID della versione del risultato di ricerca memorizzata nella cache di Google.

formattedUrl

string

L'URL visualizzato dopo lo snippet per ogni risultato di ricerca.

htmlFormattedUrl

string

L'URL in formato HTML visualizzato dopo lo snippet per ogni risultato di ricerca.

pagemap

object (Struct format)

Contiene informazioni PageMap per questo risultato di ricerca.

mime

string

Il tipo MIME del risultato di ricerca.

fileFormat

string

Il formato file del risultato di ricerca.

image

object

Include tutte le informazioni su un'immagine restituite nei risultati di ricerca.

image.contextLink

string

Un URL che rimanda alla pagina web che ospita l'immagine.

image.height

integer

L'altezza dell'immagine, in pixel.

image.width

integer

La larghezza dell'immagine, in pixel.

image.byteSize

integer

Le dimensioni dell'immagine, in byte.

image.thumbnailLink

string

Un URL che rimanda all'immagine in miniatura.

image.thumbnailHeight

integer

L'altezza dell'immagine in miniatura, in pixel.

image.thumbnailWidth

integer

La larghezza dell'immagine in miniatura, in pixel.

labels[]

object

Incapsula tutte le informazioni sulle etichette di perfezionamento.

labels[].name

string

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

string

Il nome visualizzato di un'etichetta di perfezionamento. Si tratta del nome da visualizzare nell'interfaccia utente.

labels[].label_with_op

string

Etichetta di perfezionamento e operazione di perfezionamento associata.