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 per il tipo di oggetto corrente. Per questa API, è KEYWORD#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 Custom Search.

url.template

string

Il modello OpenSearch effettivo per questa API.

queries

object

Contiene uno o più insiemi di metadati delle query, digitati in base al nome del ruolo. I nomi di ruolo possibili includono request definito dai ruoli query OpenSearch e due ruoli personalizzati: nextPage e previousPage.

queries.previousPage[]

object

I metadati che rappresentano la pagina precedente dei risultati, se applicabile.

queries.previousPage[].title

string

Una descrizione della query.

queries.previousPage[].totalResults

string (int64 format)

Numero stimato dei risultati di ricerca totali. Potrebbero non essere precise.

queries.previousPage[].searchTerms

string

I termini di ricerca inseriti dall'utente.

queries.previousPage[].count

integer

Numero di risultati di ricerca restituiti in questo insieme.

queries.previousPage[].startIndex

integer

L'indice dell'insieme corrente di risultati di ricerca nell'insieme totale dei 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 nella specifica OpenSearch. I valori dei parametri 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 nella specifica 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 la sezione Filtro automatico. I valori validi per questo parametro sono:

  • 0: disabilitato

  • 1: abilitata (impostazione predefinita)

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

queries.previousPage[].gl

string

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

queries.previousPage[].cr

string

Limita i risultati di ricerca a 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 i seguenti aspetti:

  • 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 limitare la ricerca.

queries.previousPage[].disableCnTwTranslation

string

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

I valori supportati sono:

  • 0: attivato (impostazione predefinita)

  • 1: disattivato

queries.previousPage[].hq

string

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

queries.previousPage[].hl

string

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

string

Limita i risultati agli URL di un sito specificato.

queries.previousPage[].siteSearchFilter

string

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

  • i: includi contenuti del sito

  • e: escludi contenuti dal sito

queries.previousPage[].exactTerms

string

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

queries.previousPage[].excludeTerms

string

Identifica una parola o una frase che non deve essere presente in nessun documento dei 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 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

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 relativi al numero specificato di giorni precedenti.

  • w[number]: richiede i risultati relativi al numero specificato di ultime settimane.

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

  • y[number]: richiede i risultati relativi al 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 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[].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)

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

  • WordPro Lotus (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Scrittura Microsoft (wri)

  • RTF (rtf)

  • Shockwave Flash (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 il valore non è specificato, i risultati sono limitati alle pagine web.

queries.previousPage[].imgSize

string

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

  • icon (piccola)

  • small | medium | large | xlarge (media)

  • 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)

  • photo (foto)

  • animated (animazione)

  • 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

I 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. Potrebbero non essere precise.

queries.request[].searchTerms

string

I termini di ricerca inseriti dall'utente.

queries.request[].count

integer

Numero di risultati di ricerca restituiti in questo insieme.

queries.request[].startIndex

integer

L'indice dell'insieme corrente di risultati di ricerca nell'insieme totale dei 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 nella specifica OpenSearch. I valori dei parametri 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 nella specifica 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 la sezione Filtro automatico. I valori validi per questo parametro sono:

  • 0: disabilitato

  • 1: abilitata (impostazione predefinita)

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

queries.request[].gl

string

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

queries.request[].cr

string

Limita i risultati di ricerca a 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 i seguenti aspetti:

  • 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 limitare la ricerca.

queries.request[].disableCnTwTranslation

string

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

I valori supportati sono:

  • 0: attivato (impostazione predefinita)

  • 1: disattivato

queries.request[].hq

string

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

queries.request[].hl

string

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

string

Limita i risultati agli URL di un sito specificato.

queries.request[].siteSearchFilter

string

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

  • i: includi contenuti del sito

  • e: escludi contenuti dal sito

queries.request[].exactTerms

string

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

queries.request[].excludeTerms

string

Identifica una parola o una frase che non deve essere presente in nessun documento dei 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 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

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 relativi al numero specificato di giorni precedenti.

  • w[number]: richiede i risultati relativi al numero specificato di ultime settimane.

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

  • y[number]: richiede i risultati relativi al 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 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[].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)

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

  • WordPro Lotus (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Scrittura Microsoft (wri)

  • RTF (rtf)

  • Shockwave Flash (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 il valore non è specificato, i risultati sono limitati alle pagine web.

queries.request[].imgSize

string

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

  • icon (piccola)

  • small | medium | large | xlarge (media)

  • 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)

  • photo (foto)

  • animated (animazione)

  • 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

I 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. Potrebbero non essere precise.

queries.nextPage[].searchTerms

string

I termini di ricerca inseriti dall'utente.

queries.nextPage[].count

integer

Numero di risultati di ricerca restituiti in questo insieme.

queries.nextPage[].startIndex

integer

L'indice dell'insieme corrente di risultati di ricerca nell'insieme totale dei 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 nella specifica OpenSearch. I valori dei parametri 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 nella specifica 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 la sezione Filtro automatico. I valori validi per questo parametro sono:

  • 0: disabilitato

  • 1: abilitata (impostazione predefinita)

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

queries.nextPage[].gl

string

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

queries.nextPage[].cr

string

Limita i risultati di ricerca a 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 i seguenti aspetti:

  • 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 limitare la ricerca.

queries.nextPage[].disableCnTwTranslation

string

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

I valori supportati sono:

  • 0: attivato (impostazione predefinita)

  • 1: disattivato

queries.nextPage[].hq

string

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

queries.nextPage[].hl

string

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

string

Limita i risultati agli URL di un sito specificato.

queries.nextPage[].siteSearchFilter

string

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

  • i: includi contenuti del sito

  • e: escludi contenuti dal sito

queries.nextPage[].exactTerms

string

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

queries.nextPage[].excludeTerms

string

Identifica una parola o una frase che non deve essere presente in nessun documento dei 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 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

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 relativi al numero specificato di giorni precedenti.

  • w[number]: richiede i risultati relativi al numero specificato di ultime settimane.

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

  • y[number]: richiede i risultati relativi al 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 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[].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)

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

  • WordPro Lotus (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Scrittura Microsoft (wri)

  • RTF (rtf)

  • Shockwave Flash (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 il valore non è specificato, i risultati sono limitati alle pagine web.

queries.nextPage[].imgSize

string

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

  • icon (piccola)

  • small | medium | large | xlarge (media)

  • 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)

  • photo (foto)

  • animated (animazione)

  • 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

Metadati relativi a questa ricerca, tra cui data e ora della ricerca e 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, formattato 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 a blocchi per questa promozione.

bodyLines[].title

string

Il testo dell'oggetto blocco, se contiene testo.

bodyLines[].htmlTitle

string

Il testo dell'oggetto blocco in HTML, se contiene testo.

bodyLines[].url

string

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

bodyLines[].link

string

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

image

object

Immagine associata a questa promozione, se presente.

image.source

string

URL dell'immagine del link alla promozione.

image.width

integer

Larghezza dell'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 del 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 restituita 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

Racchiude 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 mostrarlo nell'interfaccia utente; utilizza invece displayName.

labels[].displayName

string

Il nome visualizzato di un'etichetta di perfezionamento. Questo è il nome che dovresti visualizzare nell'interfaccia utente.

labels[].label_with_op

string

Etichetta di perfezionamento e operazione di perfezionamento associata.