Allegati di riferimento dell'API XML

Operatori booleani

Puoi utilizzare gli operatori booleani nei valori dei seguenti parametri:

Definizioni degli operatori booleani

Nota: non puoi includere spazi nei valori parametro.

Booleano AND [.]
Descrizione

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

Esempi

In questo esempio vengono rimossi tutti i risultati in francese o in italiano:
lr=(-lang_fr).(-lang_it)


NOT booleano [-]
Descrizione

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

Esempi

In questo esempio vengono rimossi tutti i risultati in francese:
lr=-lang_fr

In questo esempio vengono rimossi 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 della posizione delle parentesi nella query, puoi utilizzare l'operatore booleano AND o l'operatore booleano OR per esprimere la query. Questo perché se un documento è scritto in francese, non è scritto in italiano. Pertanto, la tua affermazione booleana deve indicare che il documento non è scritto in francese e non è scritto in italiano.


Valore booleano O [|]
Descrizione

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

Esempi

In questo esempio vengono restituiti tutti i risultati scritti in cinese semplificato o cinese tradizionale:
lr=lang_zh-TW|lang_zh-CN

In questo esempio vengono richiesti tutti i risultati non scritti in francese o in 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 [()]
Descrizione

Questo operatore consente di garantire che tutti i termini nella serie più interna di parentesi vengano valutati prima che vengano valutati quelli che non rientrano tra le parentesi. Puoi utilizzare le parentesi per modificare l'ordine in cui vengono evasi i termini.

Esempi

L'esempio per l'operatore NOT [-] mostra il seguente costrutto per i risultati delle richieste 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 o italiano. Poiché quest'ultimo esempio utilizza l'operatore OR anziché l'operatore AND, è necessario modificare anche la posizione delle parentesi:
lr=-(lang_fr|lang_it)


Escaping di URL

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

Lo schema 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à di ricerca. Di conseguenza, devi applicare l'escape dell'URL a tutti i caratteri non alfanumerici che si trovano nei valori dei parametri di ricerca.

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

Basato su caratteri Codifica
esadecimale
$ %24
- %2 g
_ %5F
. %2E
+ %2 MLD
! %21
* %2A
" %22
' %27
( %28
) %29
; %3 MLD
/ %2F
? %3F
: %3A
@ %40
= %3 g
& %26
| %7C

Esempi

Stringa originale Stringa con caratteri di escape dell'URL
pugno e judy pugno%26judy
O'Reilly O%27Reilly

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

Compressione dei risultati

Google è in grado di comprimere i risultati di ricerca utilizzando la compressione gzip HTTP. Se riesci a decomprimere i contenuti compressi utilizzando l'algoritmo gzip, puoi ottenere un risparmio della larghezza di banda compreso tra il 50% e il 70%, il che potrebbe migliorare i tempi di risposta.

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

Accetta-Codifica: 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, significa che Google non ha compresso i risultati.

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

Valori internazionali

Schemi di codifica dei caratteri

Nella tabella seguente sono elencati gli schemi di codifica dei caratteri supportati da Google. Puoi assegnare i parametri ie e oe i 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 per gli schemi di codifica. Google restituisce i nomi standard nei risultati XML e questi sono adatti a essere utilizzati nelle intestazioni Content-type HTTP del documento.

Nome Google Codifica Lingue supportate associate
latin1 ISO-8859-1 Europa occidentale (catalano, danese, olandese, inglese, finlandese, francese, tedesco, indonesiano, italiano, norvegese, portoghese, spagnolo, svedese)
latin2 ISO-8859-2 Europa orientale (croato, ceco, polacco, rumeno, serbo, slovacco, sloveno, ungherese)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltico (estone, lettone, lituano)
cirillico ISO-8859-5 Bulgaro, russo
arabic ISO-8859-6  
greco/greca ISO-8859-7 Greco
hebrew ISO-8859-8 Ebraico
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandese
euc-jp EUC-JP Giapponese
euc-kr EUC-KR Coreano
sji Shift_JIS Giapponese
big5 Big5 Cinese tradizionale
gb GB2312 Cinese semplificato
utf8 UTF-8 Tutte

Lingue di interfaccia supportate

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

Lingua di visualizzazione Valore del parametro hl
Afrikaans af
Albanese sq
Amarico AM
Arabo ar
Armeno hy
Azero az
Bengali bn
Bulgaro bg
Birmano my
Catalano ca
Cinese (semplificato) zh-CN
Cinese (tradizionale) zh-TW
Croato h
Ceco cs
Danese da
Olandese nl
Inglese (UK) en-GB
Inglese it
Estone et
Filippino fil
Finlandese fi
Francese (Canada) fr-CA
Francese fr
Georgiano ka
Tedesco de
Greco el
Gujarati gu
Ebraico iw
Hindi hi
Ungherese hu
Islandese è
Indonesiano id
Italiano it
Giapponese ja
Kannada kn
Kazako kk
Khmer km
Coreano ko
Kirgizo ky
Laotiano lo
Lettone lv
Lituano lt
Macedone mk
Malese ms
Malese ml
Marathi mr
Mongolo mn
Nepalese ne
Norvegese (Bokmal) no
Persiano fa
Polacco pl
Portoghese (Brasile) pt-BR
Portoghese (Portogallo) pt-PT
Punjabi pa
Rumeno ro
Russo ru
Serbo (latino) sr-Latn
Serbo sr
Sinhalese si
Slovacco sk
Sloveno sl
Spagnolo (America Latina) es-419
Spagnolo es
Swahili sw
Svedese sv
Tamil ta
Telugu te
Thailandese th
Turco tr
Ucraino uk
Urdu ur
Uzbeco uz
Vietnamita vi
Gallese cy

Valori di raccolta per lingua

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

linguaggio 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_en
Estone lang_et
Finlandese lang_fi
Francese lang_fr
Tedesco lang_de
Greco lang_el
Ebraico lang_iw
Ungherese lang_hu
Islandese lang_is
Indonesiano lang_id
Italiano lang_it
Giapponese lang_ja
Coreano lang_ko
Lettone lang_lv
Lituano lang_lt
Norvegese lang_no
Polacco lang_pl
Portoghese lang_pt
Rumeno lang_ro
Russo lang_ru
Serbo lang_sr
Slovacco lang_sk
Sloveno lang_sl
Spagnolo lang_es
Svedese lang_sv
Turco lang_tr

Valori delle raccolte per paese

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

Paese Nome raccolta paese
Afghanistan countryAF
Albania countryAL
Algeria countryDZ
Samoa americane countryAS
Andorra countryAD
Angola countryAO
Anguilla countryAI
Antartide countryAQ
Antigua e Barbuda countryAG
Argentina countryAR
Armenia countryAM
Aruba countryAW
Australia countryAU
Austria countryAT
Azerbaigian countryAZ
Bahamas countryBS
Bahrein countryBH
Bangladesh countryBD
Barbados countryBB
Bielorussia countryBY
Belgio countryBE
Belize countryBZ
Benin countryBJ
Bermuda countryBM
Bhutan countryBT
Bolivia countryBO
Bosnia ed Erzegovina countryBA
Botswana countryBW
Isola Bouvet countryBV
Brasile countryBR
Territorio britannico dell'Oceano Indiano countryIO
Brunei Darussalam countryBN
Bulgaria countryBG
Burkina Faso countryBF
Burundi countryBI
Cambogia countryKH
Camerun countryCM
Canada countryCA
Capo Verde countryCV
Isole Cayman countryKY
Repubblica Centrafricana countryCF
Ciad countryTD
Cile countryCL
Cina countryCN
Isola Christmas countryCX
Isole Cocos (Keeling) countryCC
Colombia countryCO
Comore countryKM
Congo countryCG
Congo, Repubblica Democratica del countryCD
Isole Cook countryCK
Costa Rica countryCR
Costa d'Avorio countryCI
Croazia (Hrvatska) countryHR
Cuba countryCU
Cipro countryCY
Repubblica Ceca countryCZ
Danimarca countryDK
Gibuti countryDJ
Dominica countryDM
Repubblica Dominicana countryDO
Timor Est countryTP
Ecuador countryEC
Egitto countryEG
El Salvador countrySV
Guinea Equatoriale countryGQ
Eritrea countryER
Estonia countryEE
Etiopia countryET
Unione Europea countryEU
Isole Falkland (Malvine) countryFK
Isole Fær Øer countryFO
Figi countryFJ
Finlandia countryFI
Francia countryFR
Francia metropolitana countryFX
Guyana francese countryGF
Polinesia francese countryPF
Terre australi francesi countryTF
Gabon countryGA
Gambia countryGM
Georgia countryGE
Germania countryDE
Ghana countryGH
Gibilterra countryGI
Grecia countryGR
Groenlandia countryGL
Grenada countryGD
Guadalupa countryGP
Guam countryGU
Guatemala countryGT
Guinea countryGN
Guinea-Bissau countryGW
Guyana countryGY
Haiti countryHT
Isola Heard e isole McDonald countryHM
Santa Sede (Città del Vaticano) countryVA
Honduras countryHN
Hong Kong countryHK
Ungheria countryHU
Islanda countryIS
India countryIN
Indonesia countryID
Iran, Repubblica Islamica dell' countryIR
Iraq countryIQ
Irlanda countryIE
Israele countryIL
Italia countryIT
Giamaica countryJM
Giappone countryJP
Giordania countryJO
Kazakistan countryKZ
Kenya countryKE
Kiribati countryKI
Corea, Repubblica Democratica Popolare di countryKP
Corea, Repubblica di countryKR
Kuwait countryKW
Kirghizistan countryKG
Laos, Repubblica Democratica Popolare countryLA
Lettonia countryLV
Libano countryLB
Lesotho countryLS
Liberia countryLR
Stato della Libia countryLY
Liechtenstein countryLI
Lituania countryLT
Lussemburgo countryLU
Macao countryMO
Macedonia del Nord countryMK
Madagascar countryMG
Malawi countryMW
Malaysia countryMY
Maldive countryMV
Mali countryML
Malta countryMT
Isole Marshall countryMH
Martinica countryMQ
Mauritania countryMR
Mauritius countryMU
Mayotte countryYT
Messico countryMX
Micronesia, Stati Federati di countryFM
Moldavia, Repubblica di countryMD
Monaco countryMC
Mongolia countryMN
Montserrat countryMS
Marocco countryMA
Mozambico countryMZ
Myanmar (Birmania) countryMM
Namibia countryNA
Nauru countryNR
Nepal countryNP
Paesi Bassi countryNL
Caraibi Olandesi countryAN
Nuova Caledonia countryNC
Nuova Zelanda countryNZ
Nicaragua countryNI
Niger countryNE
Nigeria countryNG
Niue countryNU
Isola Norfolk countryNF
Isole Marianne settentrionali countryMP
Norvegia countryNO
Oman countryOM
Pakistan countryPK
Palau countryPW
Territori palestinesi countryPS
Panama countryPA
Papua Nuova Guinea countryPG
Paraguay countryPY
Perù countryPE
Filippine countryPH
Pitcairn countryPN
Polonia countryPL
Portogallo countryPT
Portorico countryPR
Qatar countryQA
Riunione countryRE
Romania countryRO
Federazione Russa countryRU
Ruanda countryRW
Sant'Elena countrySH
Saint Kitts e Nevis countryKN
Santa Lucia countryLC
Saint-Pierre e Miquelon countryPM
Saint Vincent e Grenadine countryVC
Samoa countryWS
San Marino countrySM
São Tomé e Príncipe countryST
Arabia Saudita countrySA
Senegal countrySN
Serbia e Montenegro countryCS
Seychelles countrySC
Sierra Leone countrySL
Singapore countrySG
Slovacchia countrySK
Slovenia countrySI
Isole Salomone countrySB
Somalia countrySO
Sudafrica countryZA
Georgia del Sud e Sandwich Australi countryGS
Spagna countryES
Sri Lanka countryLK
Sudan countrySD
Suriname countrySR
Svalbard e Jan Mayen countrySJ
Swaziland countrySZ
Svezia countrySE
Svizzera countryCH
Repubblica Araba di Siria countrySY
Provincia di Taiwan (Repubblica Popolare Cinese) countryTW
Tagikistan countryTJ
Tanzania, Repubblica Unita di countryTZ
Thailandia countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trinidad e Tobago countryTT
Tunisia countryTN
Turchia countryTR
Turkmenistan countryTM
Isole Turks e Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ucraina countryUA
Emirati Arabi Uniti countryAE
Regno Unito countryUK
Stati Uniti countryUS
Isole Minori Esterne degli Stati Uniti d'America countryUM
Uruguay countryUY
Uzbekistan countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnam countryVN
Isole Vergini britanniche countryVG
Isole Vergini Americane countryVI
Wallis e Futuna countryWF
Sahara occidentale countryEH
Yemen countryYE
Yugoslavia countryYU
Zambia countryZM
Zimbabwe countryZW

Codici paese

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

Paese Country Code
Afghanistan af
Albania al
Algeria dz
Samoa americane come
Andorra annunci
Angola ao
Anguilla ai
Antartide aq
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 per
Belgio be
Belize bz
Benin bj
Bermuda bm
Bhutan bt
Bolivia bo
Bosnia ed Erzegovina ba
Botswana bw
Isola Bouvet v
Brasile br
Territorio britannico dell'Oceano Indiano io
Brunei Darussalam bn
Bulgaria bg
Burkina Faso bf
Burundi bi
Cambogia kh
Camerun cm
Canada ca
Capo Verde cv
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 ck
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 gp
Guam gu
Guatemala gt
Guinea gn
Guinea-Bissau gw
Guyana gy
Haiti ht
Isola Heard e isole McDonald hm
Santa Sede (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 che li ricevano.
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 lr
Stato della Libia 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 mu
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 nr
Nepal np
Paesi Bassi nl
Caraibi Olandesi uno
Nuova Caledonia nc
Nuova Zelanda nz
Nicaragua ni
Niger ne
Nigeria ng
Niue nu
Isola Norfolk NP
Isole Marianne settentrionali mp
Norvegia no
Oman om
Pakistan pk
Palau pw
Territori palestinesi occupati ps
Panama pa
Papua Nuova Guinea pag.
Paraguay py
Perù pe
Filippine ph
Pitcairn n
Polonia pl
Portogallo pt
Portorico pr
Qatar qa
Riunione rif
Romania ro
Federazione Russa ru
Ruanda rw
Sant'Elena sh
Saint Kitts e Nevis kn
Santa 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 es
Sri Lanka L
Sudan sd
Suriname sr
Svalbard e Jan Mayen SJ
Swaziland sz
Svezia se
Svizzera ch
Repubblica Araba di Siria si
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 una
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 ehm
Uruguay uy
Uzbekistan uz
Vanuatu vu
Venezuela ve
Vietnam vn
Isole Vergini britanniche vg
Isole Vergini Americane vi
Wallis e Futuna wf
Sahara occidentale eh
Yemen
Zambia zm
Zimbabwe zw