Method: cse.list

Restituisce metadati sulla ricerca eseguita, metadati sul motore utilizzato per la ricerca e risultati di ricerca.

Richiesta HTTP

GET https://customsearch.googleapis.com/customsearch/v1

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
c2coff

string

Attiva o disattiva la ricerca in cinese semplificato e tradizionale.

Il valore predefinito di questo parametro è 0 (zero), a indicare che la funzionalità è abilitata. I valori supportati sono:

  • 1: disabilitato

  • 0: abilitata (impostazione predefinita)

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:

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

  • la posizione geografica dell'indirizzo IP del server web

Consulta la pagina Valori dei parametri paese per un elenco dei valori validi per questo parametro.

cx

string

L'ID Motore di ricerca programmabile da utilizzare per questa richiesta.

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.

exactTerms

string

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

excludeTerms

string

Identifica una parola o una frase che non deve essere presente in nessun documento dei risultati di ricerca.

fileType

string

Limita i risultati ai file con un'estensione specificata. Puoi trovare un elenco dei tipi di file indicizzabili da Google nel Centro assistenza Search Console.

filter

string

Controlla l'attivazione o la disattivazione del filtro per i contenuti duplicati.

  • Per ulteriori informazioni sui filtri dei risultati di ricerca di Google, consulta la sezione Filtro automatico. Tieni presente che i filtri per il crowding degli host si applicano solo alle ricerche su più siti.

  • Per impostazione predefinita, Google applica il filtro a tutti i risultati di ricerca per migliorarne la qualità.

I valori accettati sono:

  • 0: disattiva il filtro per contenuti duplicati.

  • 1: attiva il filtro per i contenuti duplicati.

gl

string

Geolocalizzazione dell'utente finale.

  • Il valore del parametro gl è un codice paese di due lettere. Il parametro gl incrementa i risultati di ricerca il cui paese di origine corrisponde al valore del parametro. Consulta la pagina Codici paese per un elenco dei valori validi.

  • Se specifichi un valore parametro gl, dovresti ottenere risultati più pertinenti. Ciò è particolarmente vero per i clienti internazionali e, più nello specifico, per i clienti in paesi anglofoni diversi dagli Stati Uniti.

googlehost

string

Obsoleta. Usa il parametro gl per ottenere un effetto simile.

Il dominio Google locale (ad esempio google.com, google.de o google.fr) da utilizzare per eseguire la ricerca.

highRange

string

Specifica il valore finale per un intervallo di ricerca.

  • Utilizza lowRange e highRange per aggiungere alla query un intervallo di ricerca inclusivo di lowRange...highRange.
hl

string

Imposta la lingua dell'interfaccia utente.

hq

string

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

imgColorType

enum (ImgColorType)

Restituisce immagini in bianco e nero, in scala di grigi, trasparenti o a colori. I valori accettati sono:

  • "color"

  • "gray"

  • "mono": bianco e nero

  • "trans": sfondo trasparente

imgDominantColor

enum (ImgDominantColor)

Restituisce immagini di un colore dominante specifico. I valori accettati sono:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

Restituisce immagini di una dimensione specificata. I valori accettati sono:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

Restituisce immagini di un tipo. I valori accettati sono:

  • "clipart"

  • "face"

  • "lineart"

  • "stock"

  • "photo"

  • "animated"

lowRange

string

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

lr

string

Limita la ricerca a documenti scritti in una determinata lingua (ad es. lr=lang_ja).

I valori accettati sono:

  • "lang_ar": arabo

  • "lang_bg": Bulgaro

  • "lang_ca": catalano

  • "lang_cs": ceco

  • "lang_da": danese

  • "lang_de": tedesco

  • "lang_el": greco

  • "lang_en": inglese

  • "lang_es": spagnolo

  • "lang_et": estone

  • "lang_fi": finlandese

  • "lang_fr": francese

  • "lang_hr": croato

  • "lang_hu": ungherese

  • "lang_id": indonesiano

  • "lang_is": islandese

  • "lang_it": italiano

  • "lang_iw": ebraico

  • "lang_ja": giapponese

  • "lang_ko": coreano

  • "lang_lt": lituano

  • "lang_lv": lettone

  • "lang_nl": olandese

  • "lang_no": norvegese

  • "lang_pl": polacco

  • "lang_pt": portoghese

  • "lang_ro": rumeno

  • "lang_ru": russo

  • "lang_sk": slovacco

  • "lang_sl": sloveno

  • "lang_sr": serbo

  • "lang_sv": svedese

  • "lang_tr": turco

  • "lang_zh-CN": cinese (semplificato)

  • "lang_zh-TW": cinese (tradizionale)

num

integer

Numero di risultati di ricerca da restituire.

  • I valori validi sono numeri interi compresi tra 1 e 10 inclusi.
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.

q

string

Query

relatedSite
(deprecated)

string

Deprecato.

rights

string

Filtri basati sulle licenze. I valori supportati includono: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived e una combinazione di questi. Vedi le combinazioni tipiche.

safe

enum (Safe)

Livello di sicurezza della Ricerca. I valori accettati sono:

  • "active": attiva il filtro SafeSearch.

  • "off": disattiva il filtro SafeSearch. (valore predefinito)

searchType

enum (SearchType)

Specifica il tipo di ricerca: image. Se il valore non è specificato, i risultati sono limitati alle pagine web.

I valori accettati sono:

  • "image": ricerca immagini personalizzata.
siteSearchFilter

enum (SiteSearchFilter)

Consente di stabilire se includere o escludere i risultati del sito indicato nel parametro siteSearch.

I valori accettati sono:

  • "e": escludi

  • "i": includi

sort

string

L'espressione di ordinamento da applicare ai risultati. Il parametro sort consente di specificare che i risultati devono essere ordinati in base all'espressione specificata, ovvero in base alla data. Esempio: sort=date.

start

integer (uint32 format)

L'indice del primo risultato da restituire. Il numero predefinito di risultati per pagina è 10, quindi &start=11 inizia nella parte superiore della seconda pagina dei risultati. Nota: l'API JSON non restituirà mai più di 100 risultati, anche se più di 100 documenti corrispondono alla query, quindi impostare la somma di start + num su un numero maggiore di 100 genererà un errore. Tieni inoltre presente che il valore massimo per num è 10.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Search.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cse

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.