- 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. Utilizza un piccolo insieme di pattern URL.
Richiesta HTTP
GET https://customsearch.googleapis.com/customsearch/v1/siterestrict
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.