- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
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 |
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:
|
cr |
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:
Consulta la pagina Valori dei parametri paese per un elenco dei valori validi per questo parametro. |
cx |
L'ID Motore di ricerca programmabile da utilizzare per questa richiesta. |
dateRestrict |
Limita i risultati agli URL in base alla data. I valori supportati includono:
|
exactTerms |
Identifica una frase che deve contenere tutti i documenti dei risultati di ricerca. |
excludeTerms |
Identifica una parola o una frase che non deve essere presente in nessun documento dei risultati di ricerca. |
fileType |
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 |
Controlla l'attivazione o la disattivazione del filtro per i contenuti duplicati.
I valori accettati sono:
|
gl |
Geolocalizzazione dell'utente finale.
|
googlehost |
Obsoleta. Usa il parametro Il dominio Google locale (ad esempio google.com, google.de o google.fr) da utilizzare per eseguire la ricerca. |
highRange |
Specifica il valore finale per un intervallo di ricerca.
|
hl |
Imposta la lingua dell'interfaccia utente.
|
hq |
Accoda i termini di query specificati alla query, come se fossero combinati con un operatore logico AND. |
imgColorType |
Restituisce immagini in bianco e nero, in scala di grigi, trasparenti o a colori. I valori accettati sono:
|
imgDominantColor |
Restituisce immagini di un colore dominante specifico. I valori accettati sono:
|
imgSize |
Restituisce immagini di una dimensione specificata. I valori accettati sono:
|
imgType |
Restituisce immagini di un tipo. I valori accettati sono:
|
linkSite |
Specifica che tutti i risultati di ricerca devono contenere un link a un determinato URL. |
lowRange |
Specifica il valore iniziale per un intervallo di ricerca. Utilizza |
lr |
Limita la ricerca a documenti scritti in una determinata lingua (ad es. I valori accettati sono:
|
num |
Numero di risultati di ricerca da restituire.
|
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. |
q |
Query |
relatedSite |
Deprecato. |
rights |
Filtri basati sulle licenze. I valori supportati includono: |
safe |
Livello di sicurezza della Ricerca. I valori accettati sono:
|
searchType |
Specifica il tipo di ricerca: I valori accettati sono:
|
siteSearch |
Specifica un determinato sito che deve sempre essere incluso o escluso dai risultati (vedi il parametro |
siteSearchFilter |
Consente di stabilire se includere o escludere i risultati del sito indicato nel parametro I valori accettati sono:
|
sort |
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 |
L'indice del primo risultato da restituire. Il numero predefinito di risultati per pagina è 10, quindi |
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.