Appendici di riferimento per l'API XML

Operatori booleani

Puoi utilizzare gli operatori booleani nei valori per i seguenti parametri:

Definizioni degli operatori booleani

Nota:non puoi includere spazi nei valori parametro.

Booleano AND [.]
Description (Descrizione)

L'operatore AND (.) restituisce i risultati che si trovano nell'intersezione delle raccolte su entrambi i lati dell'operatore ".".

Esempi

Questo esempio rimuove tutti i risultati in francese o in italiano:
lr=(-lang_fr).(-lang_it)


Booleano NOT [-]
Description (Descrizione)

L'operatore NOT (.) rimuove tutti i risultati che si trovano nella raccolta subito dopo l'operatore meno ("-").

Esempi

Questo esempio rimuove tutti i risultati in francese:
lr=-lang_fr

Questo esempio rimuove tutti i risultati in francese o in italiano:
lr=(-lang_fr).(-lang_it)

Nota: potresti aver notato che il secondo esempio sopra utilizza l'operatore Booleano AND per specificare che i risultati non devono essere scritti in francese o in italiano. A seconda del posizionamento di parentesi tonde nella query, puoi utilizzare l'operatore Booleano AND oppure l'operatore Boolean OR per esprimere questa query. Questo perché, se un documento è scritto in francese, significa che non è scritto in italiano. Pertanto, l'istruzione booleana deve indicare che il documento non è scritto in francese e non è scritto in italiano.


Booleano OR [|]
Description (Descrizione)

L'operatore OR (.) restituisce i risultati che si trovano nella raccolta a sinistra o nella raccolta a destra della barra verticale "|").

Esempi

Questo esempio restituisce tutti i risultati scritti in cinese semplificato o cinese tradizionale:
lr=lang_zh-TW|lang_zh-CN

Questo esempio richiede tutti i risultati che non sono scritti in francese o italiano; nota che posiziona le parentesi in una posizione diversa rispetto alla query di esempio per l'operatore Booleano AND:
lr=-(lang_fr|lang_it)


Parentesi booleane [()]
Description (Descrizione)

Questo operatore consente di garantire che tutti i termini nell'insieme più interno di parentesi vengano valutati prima dei termini fuori dalle parentesi. Puoi utilizzare le parentesi per modificare l'ordine di evacuazione dei termini.

Esempi

L'esempio per l'operatore NOT [-] mostra il seguente costrutto per i risultati della richiesta che non sono scritti in francese o in italiano:
lr=(-lang_fr).(-lang_it)

L'esempio per l'operatore OR (|) mostra anche una richiesta di risultati non scritti in francese dell'italiano. Quest'ultimo esempio utilizza l'operatore OR invece dell'operatore AND, pertanto deve cambiare la posizione delle parentesi:
lr=-(lang_fr|lang_it)


Escape URL

Per effettuare una richiesta di ricerca HTTP, devi seguire alcune convenzioni in modo che Google possa tradurre correttamente la tua richiesta HTTP e generare una risposta appropriata.

Lo schema dell'URL HTTP specifica che una richiesta URL HTTP può contenere solo determinati caratteri:

  • Caratteri alfanumerici: (a-z, A-Z, 0-9)
  • Caratteri speciali: $ - _ . | +* ' ( )
  • Caratteri riservati: ; / ? : @ = &.

Google utilizza caratteri riservati per decodificare gli URL e utilizza alcuni caratteri speciali per richiedere le funzionalità della Ricerca. Di conseguenza, devi eseguire l'escape degli URL per tutti i caratteri non alfanumerici che compaiono nei valori dei parametri di ricerca.

Per eseguire l'escape di una stringa, converti ogni sequenza di spazi vuoti in un singolo segno "+" (più) e sostituisci qualsiasi altro carattere non alfanumerico con la codifica esadecimale che rappresenta il valore di quel carattere. Le codifiche esadecimali dei caratteri speciali e riservati elencati sopra sono mostrate nella seguente tabella. Ciascuno di questi caratteri deve avere caratteri di escape nell'URL nei valori dei parametri della richiesta.

Personaggio Codifica
esadecimale
$ 22%
- %2D
_ %5F
. %2E
+ %2 Mld
! 22%
* %2A
" 22%
' 27%
( 28%
) 29%
; %3b
/ %2F
? %3F
: %3A
@ %40
= %3D
& 26%
| %7C

Esempi

Stringa originale Stringa con caratteri di escape URL
punch&judy punch%26judy
O'Reilly O%27Reilly

Puoi trovare ulteriori informazioni sull'escape degli URL sui siti web W3C e IETF.

Compressione dei risultati

Google può comprimere i risultati di ricerca utilizzando la compressione gzip HTTP. Se puoi decomprimere i contenuti compressi utilizzando l'algoritmo gzip, puoi ottenere un risparmio di larghezza di banda dal 50% al 70%, migliorando i tempi di risposta.

Per richiedere che Google restituisca risultati in formato compresso, aggiungi l'intestazione HTTP Accept-Encoding alla tua richiesta di ricerca HTTP come segue:

Accept-Encoding: gzip

Se Google restituisce i risultati di ricerca utilizzando la compressione gzip, includiamo la seguente riga nelle intestazioni HTTP restituite:

Codifica dei contenuti: gzip

Nota: se l'intestazione HTTP Content-Encoding non è presente nella risposta come mostrato sopra, Google non ha compresso i risultati.

Questo comportamento è specificato nello standard HTTP. Consulta il documento per ulteriori informazioni sull'utilizzo della compressione gzip HTTP.

Valori internazionali

Schemi di codifica dei caratteri

Nella tabella seguente sono elencati gli schemi di codifica dei caratteri supportati da Google. Puoi assegnare i valori ie e oe ai valori in una delle prime due colonne di questa tabella. I valori nella prima colonna sono nickname per gli schemi di codifica; i valori nella seconda colonna sono i nomi standard degli schemi di codifica. Google restituisce i nomi standard nei risultati XML e sono adatti a essere utilizzati nelle intestazioni HTTP Content-type del tuo documento.

Nome Google Codifica Lingue supportate corrispondenti
latin1 con codifica ISO-8859-1 Europa occidentale (catalano, danese, finlandese, francese, indonesiano, inglese, italiano, norvegese, olandese, portoghese, spagnolo, svedese, tedesco)
latino2 ISO 8859-2 Europa orientale (ceco, croato, polacco, rumeno, serbo, slovacco, sloveno, ungherese)
latino3 ISO 8859-3  
latino4 ISO 8859-4 Baltico (estone, lettone, lituano)
cirillico ISO 8859-5 Bulgaro, russo
arabo ISO 8859-6  
greco/greca ISO 8859-7 Greco
ebraico ISO 8859-8 Ebraico
latino5 ISO 8859-9  
latino6 ISO 8859-10 Islandese
uc-jp EUC-JP Giapponese
euc-kr EUC-KR Coreano
sfigato Maiusc_JIS Giapponese
grande5 Grande5 Cinese tradizionale
gb GB2312 Cinese semplificato
utf8 UTF-8 Tutti

Lingue dell'interfaccia supportate

Google supporta più di 80 lingue. La lingua predefinita dell'interfaccia è l'inglese. Il seguente elenco identifica tutte le lingue di interfaccia supportate da Google.

Lingua di visualizzazione Valore del parametro hl
Afrikaans af
Albanese sq
Amarico sm
Arabo ar
Azero az
Basco eu
Bielorusso be
Bengali bn
Bihari bh
Bosniaco bs
Bulgaro bg
Catalano ca
Cinese (semplificato) zh-CN
Cinese (tradizionale) zh-TW
Croato h
Ceco cs
Danese da
Olandese nl
Inglese inglese
Esperanto eo
Estone et
Faroese Fo
Finlandese fi
Francese fr
Frisone hey
Galiziano gl
Georgiano ka
Tedesco de
Greco el
Gujarati gu
Ebraico iw
Hindi hi
Ungherese hu
Islandese è
Indonesiano id
Interlingua Ia
Irlandese ga
Italiano it
Giapponese ja
Giavanese JW
Kannada kn
Coreano ko
Latina la
Lettone lv
Lituano lt
Macedone mk
Malese ms
Malese ml
Maltese mt
Marathi mr
Nepalese ne
Norvegese no
Norvegese (Nynorsk) nn
Occitano oc
Persiano fa
Polacco pl
Portoghese (Brasile) pt-BR
Portoghese (Portogallo) pt-PT
Punjabi pa
Rumeno ro
Russo ru
Gaelico scozzese GD
Serbo sr
Sinhalese si
Slovacco sk
Sloveno sl
Spagnolo spagnolo
Sudanese Do
Swahili sw
Svedese sv
Tagalog TL
Tamil ta
Telugu te
Thai th
Tigrinya Ti
Turco tr
Ucraino uk
Urdu ur
Uzbeco uz
Vietnamita vi
Gallese cy
Xhosa xh
Zulu zu

Valori delle raccolte di lingue

Puoi utilizzare i seguenti valori per specificare un filtro della lingua utilizzando il parametro di ricerca lr:

Lingua Valore parametro lr
Arabo Lang_ar
Bulgaro Lang_bg
Catalano Lang_ca
Cinese (semplificato) Lang_zh-CN
Cinese (tradizionale) Lang_zh-TW
Croato Lang_hr
Ceco Lang_cs
Danese Lang_da
Olandese Lang_nl
Inglese Lang_it
Estone lingua
Finlandese Lingua
Francese Lingua
Tedesco Lingua
Greco Lingua
Ebraico Lingua
Ungherese Lingua
Islandese lingua
Indonesiano ID_lingua
Italiano lingua
Giapponese Lingua
Coreano Lang_ko
Lettone Lang_lv
Lituano Lingua
Norvegese lingua_no
Polacco Lang_Pl
Portoghese Lang_pt
Rumeno Lang_Ro
Russo Lingua
Serbo Lang_sr
Slovacco Lang_sk
Sloveno Lang_Sl
Spagnolo lingue
Svedese Lang_Sv
Turco Lang_tr

Valori raccolta paese

Puoi utilizzare i seguenti valori per specificare un filtro paese utilizzando il parametro di ricerca cr:

Paese Nome raccolta paese
Afghanistan AF paese
Albania country
Algeria DZ paese
Samoa americane paeseAS
Andorra paeseAD
Angola AO paese
Anguilla AI di paese
Antartide AQ paese
Antigua e Barbuda AG paese
Argentina paeseAR
Armenia paeseAM
Aruba paeseAW
Australia paeseAU
Austria paeseAT
Azerbaigian paeseAZ
Bahamas countryBS
Bahrein BH paese
Bangladesh BD paese
Barbados countryBB
Bielorussia paese PER
Belgio paese
Belize paeseBZ
Benin paeseBJ
Bermuda countryBM
Bhutan BT paese
Bolivia BO paese
Bosnia ed Erzegovina paeseBA
Botswana BW country
Isola Bouvet VL paese
Brasile paeseBR
Territorio britannico dell'Oceano Indiano countryio
Brunei Darussalam BN paese
Bulgaria BG paese
Burkina Faso BF paese
Burundi paeseBI
Cambogia KH paese
Camerun paese CM
Canada paeseCA
Capo Verde CV
Isole Cayman paeseKY
Repubblica Centrafricana CF paese
Ciad Da inizio paese
Cile paeseCL
Cina paeseCN
Isola Christmas Cx paese
Isole Cocos (Keeling) Cc
Colombia paeseCO
Comore KM paese
Congo CG paese
Congo, Repubblica Democratica del CD paese
Isole Cook CK paese
Costa Rica RP nazionale
Costa d'Avorio CI paese
Croazia (Hrvatska) paese HR
Cuba CU paese
Cipro paeseCY
Repubblica Ceca CZ paese
Danimarca DK paese
Gibuti DJ paese
Dominica DM country
Repubblica Dominicana paeseDO
Timor Est countryTP
Ecuador paese_ec
Egitto paeseEG
El Salvador countrySV
Guinea Equatoriale GQ paese
Eritrea countryer
Estonia paese paese
Etiopia paese
Unione Europea paeseUE
Isole Falkland (Malvine) FK country
Isole Fær Øer countryFO
Figi FJ country
Finlandia paeseFI
Francia paeseFR
Francia metropolitana FX paese
Guyana francese GF paese
Polinesia francese paese di destinazione
Terre australi francesi paeseTF
Gabon paeseGA
Gambia countryGM
Georgia GE
Germania paese paese
Ghana paese di origine
Gibilterra countryGI
Grecia GR paese
Groenlandia paese
Grenada GD paese
Guadalupa GP di paese
Guam countryGU
Guatemala GT paese
Guinea paese GN
Guinea-Bissau GW country
Guyana paeseGY
Haiti HT paese
Isola Heard e isole McDonald HM paese
Santa Sede (Stato della Città del Vaticano) paeseVA
Honduras paeseHN
Hong Kong countryHK
Ungheria countryHU
Islanda country
India paeseIN
Indonesia countryID
Iran, Repubblica Islamica dell' IR country
Iraq IQ paese
Irlanda country
Israele paeseIL
Italia paeseIT
Giamaica JM paese
Giappone paeseJP
Giordania countryJO
Kazakistan paeseKZ
Kenya countryKE
Kiribati paeseKI
Corea, Repubblica Democratica Popolare di KP paese
Corea, Repubblica di countryKR
Kuwait paese
Kirghizistan KG paese
Laos, Repubblica Democratica Popolare paese paese
Lettonia paeseVL
Libano Bilanciatore del carico country
Lesotho paeseLS
Liberia da country country
Gran Giamahiria araba libica country
Liechtenstein LI
Lituania paese paese
Lussemburgo countryLU
Macao paese di destinazione
Macedonia del Nord paeseMK
Madagascar paeseMG
Malawi countryMW
Malaysia MYMY paese
Maldive VM paese
Mali machine learning
Malta countryMT
Isole Marshall MH paese
Martinica paese paese
Mauritania countryMR
Mauritius countryMU
Mayotte paese YT
Messico countryMX
Micronesia, Stati Federati di FM country
Moldavia, Repubblica di ID paese
Monaco countryMC
Mongolia NM paese
Montserrat MS paese
Marocco countryMA
Mozambico paeseMZ
Myanmar (Birmania) paeseMM
Namibia paese_NA
Nauru paeseNR
Nepal paeseNP
Paesi Bassi paeseNL
Antille Olandesi paeseAN
Nuova Caledonia paeseNC
Nuova Zelanda countryNZ
Nicaragua Nazione country
Niger paeseNE
Nigeria countryNG
Niue NU paese
Isola Norfolk NF
Isole Marianne settentrionali paese MP
Norvegia paeseNO
Oman paeseOM
Pakistan PK paese
Palau PW paese
Territori palestinesi paesePS
Panamá paese paese
Papua Nuova Guinea PG
Paraguay PY paese
Perù paese paese
Filippine paese paese
Pitcairn paese paese
Polonia paesePL
Portogallo paese paese
Portorico PR nazionale
Qatar QA paese
Riunione paeseRE
Romania countryRO
Federazione Russa countryRU
Ruanda countryRW
Sant'Elena countrySH
Saint Kitts e Nevis paeseKN
Saint Lucia countryLC
Saint-Pierre e Miquelon paesePM
Saint Vincent e Grenadine paese paese
Samoa countryWS
San Marino countrySM
São Tomé e Príncipe countryST
Arabia Saudita paeseSA
Senegal paese paese
Serbia e Montenegro countryCS
Seychelles paeseSC
Sierra Leone SL
Singapore paeseSG
Slovacchia paeseSK
Slovenia countrySI
Isole Salomone paeseSB
Somalia paeseSO
Sudafrica paeseZA
Georgia del Sud e Sandwich australi countryGS
Spagna paeseES
Sri Lanka CountryLK
Sudan paeseSD
Suriname countrySR
Svalbard e Jan Mayen paeseSJ
Swaziland paeseSZ
Svezia paeseSE
Svizzera paese
Repubblica Araba di Siria paeseSY
Provincia di Taiwan (Repubblica Popolare Cinese) paese di destinazione
Tagikistan paese_J
Tanzania, Repubblica Unita di TZ paese
Thailandia paeseTH
Togo TG paese
Tokelau TK paese
Tonga paese paese
Trinidad e Tobago TTT paese
Tunisia paese paese
Turchia ₺ paese
Turkmenistan countryTM
Isole Turks e Caicos paeseTC
Tuvalu TV country
Uganda paese paese
Ucraina paeseUA
Emirati Arabi Uniti paeseAE
Regno Unito paeseRegno Unito
Stati Uniti paeseUS
Isole minori esterne degli Stati Uniti d'America countryUM
Uruguay paese
Uzbekistan paeseUZ
Vanuatu VU paese
Venezuela paeseVE
Vietnam paese di destinazione
Isole Vergini Britanniche paese di destinazione
Isole Vergini Americane paeseVI
Wallis e Futuna WF country
Sahara occidentale paeseEH
Yemen paeseYE
Yugoslavia countryYU
Zambia ZM paese
Zimbabwe paeseZW

Codici paese

Nella seguente tabella sono elencati i codici paese di due lettere che possono essere utilizzati come valori del parametro gl:

Paese Codice paese
Afghanistan af
Albania al
Algeria dz
Samoa americane come
Andorra l'annuncio
Angola Ao
Anguilla AI
Antartide acqua
Antigua e Barbuda AG
Argentina ar
Armenia AM
Aruba aw
Australia au
Austria at
Azerbaigian az
Bahamas bs
Bahrein bh
Bangladesh bd
Barbados bb
Bielorussia by
Belgio be
Belize bz
Benin bj
Bermuda mld
Bhutan bt
Bolivia bo
Bosnia ed Erzegovina ba
Botswana bianco e nero
Isola Bouvet bv
Brasile br
Territorio britannico dell'Oceano Indiano io
Brunei Darussalam bn
Bulgaria bg
Burkina Faso st
Burundi bi
Cambogia kh
Camerun cm
Canada ca
Capo Verde CVR
Isole Cayman ky
Repubblica Centrafricana cf.
Ciad td
Cile cl
Cina cn
Isola Christmas Cx
Isole Cocos (Keeling) Cc
Colombia co
Comore km
Congo CG
Congo, Repubblica Democratica del cd
Isole Cook K
Costa Rica cr
Costa d'Avorio CI
Croazia h
Cuba cu
Cipro cy
Repubblica Ceca cz
Danimarca dk
Gibuti DJ
Dominica dm
Repubblica Dominicana do
Ecuador ec
Egitto eg
El Salvador sv
Guinea Equatoriale GQ
Eritrea rt
Estonia ee
Etiopia et
Isole Falkland (Malvine) FK
Isole Fær Øer Fo
Figi fj
Finlandia fi
Francia fr
Guyana francese GF
Polinesia francese pf
Terre australi francesi tf
Gabon ga
Gambia GM
Georgia ge
Germania de
Ghana gh
Gibilterra gi
Grecia gr
Groenlandia gl
Grenada GD
Guadalupa GPA
Guam gu
Guatemala gt
Guinea GN
Guinea-Bissau GW
Guyana gy
Haiti ht
Isola Heard e isole McDonald mh
Santa Sede (Stato della Città del Vaticano) va
Honduras hn
Hong Kong hk
Ungheria hu
Islanda è
India in
Indonesia id
Iran, Repubblica Islamica dell' ir
Iraq iq
Irlanda ie
Israele il
Italia it
Giamaica JM
Giappone jp
Giordania jo
Kazakistan kz
Kenya ke
Kiribati ki
Corea, Repubblica Democratica Popolare di Kp
Corea, Repubblica di kr
Kuwait kw
Kirghizistan kg
Laos, Repubblica Democratica Popolare la
Lettonia lv
Libano lb
Lesotho ls
Liberia l
Gran Giamahiria araba libica ly
Liechtenstein li
Lituania lt
Lussemburgo lu
Macao mese
Macedonia del Nord mk
Madagascar mg
Malawi mw
Malaysia my
Maldive mv
Mali ml
Malta mt
Isole Marshall mh
Martinica mq
Mauritania mr
Mauritius m
Mayotte YT
Messico mx
Micronesia, Stati Federati di fm
Moldavia, Repubblica di md
Monaco Mc
Mongolia mn
Montserrat ms
Marocco ma
Mozambico mz
Myanmar (Birmania) mm
Namibia N/D
Nauru n
Nepal np
Paesi Bassi nl
Antille Olandesi un’
Nuova Caledonia NC
Nuova Zelanda nz
Nicaragua ni
Niger ne
Nigeria ng
Niue nu
Isola Norfolk NF
Isole Marianne settentrionali Mb
Norvegia no
Oman om
Pakistan pk
Palau PW
Territori palestinesi occupati ps
Panamá pa
Papua Nuova Guinea Pag
Paraguay py
Perù pe
Filippine ph
Pitcairn num.
Polonia pl
Portogallo pt
Portorico pr
Qatar qa
Riunione R
Romania ro
Federazione Russa ru
Ruanda rw
Sant'Elena sh
Saint Kitts e Nevis kn
Saint Lucia lc
Saint-Pierre e Miquelon pm
Saint Vincent e Grenadine vc
Samoa ws
San Marino sm
São Tomé e Príncipe st
Arabia Saudita sa
Senegal sn
Serbia e Montenegro cs
Seychelles sc
Sierra Leone sl
Singapore sg
Slovacchia sk
Slovenia si
Isole Salomone sb
Somalia so
Sudafrica za
Georgia del Sud e Sandwich australi gs
Spagna spagnolo
Sri Lanka LK
Sudan sd
Suriname sr
Svalbard e Jan Mayen sj
Swaziland sz
Svezia se
Svizzera ch
Repubblica Araba di Siria sy
Provincia di Taiwan (Repubblica Popolare Cinese) tw
Tagikistan TJ
Tanzania, Repubblica Unita di tz
Thailandia th
Timor Est TL
Togo TG
Tokelau tk
Tonga a
Trinidad e Tobago tt
Tunisia TN
Turchia tr
Turkmenistan tm
Isole Turks e Caicos tc
Tuvalu tv
Uganda ug
Ucraina ua
Emirati Arabi Uniti ae
Regno Unito uk
Stati Uniti us
Isole minori esterne degli Stati Uniti d'America um
Uruguay uy
Uzbekistan uz
Vanuatu Vu
Venezuela v
Vietnam vn
Isole Vergini Britanniche vg
Isole Vergini Americane vi
Wallis e Futuna wf
Sahara occidentale eh
Yemen
Zambia m
Zimbabwe zw