Apêndices de referência da API XML

Operadores booleanos

Você pode usar operadores booleanos em valores para os seguintes parâmetros:

Definições de operadores booleanos

Observação: não é possível incluir espaços nos valores de parâmetro.

Booleano AND [.]
Descrição

O operador AND (.) retorna resultados que estão na interseção das coleções em ambos os lados do operador ".".

Exemplos

Este exemplo remove todos os resultados que estão em francês ou italiano:
lr=(-lang_fr).(-lang_it)


Booleano NOT [-]
Descrição

O operador NOT (.) remove todos os resultados que estão na coleção imediatamente após o operador de menos ("-").

Exemplos

Este exemplo remove todos os resultados em francês:
lr=-lang_fr

Este exemplo remove todos os resultados que estão em francês ou italiano:
lr=(-lang_fr).(-lang_it)

Observação: você pode ter notado que o segundo exemplo acima usa o operador Booleano AND para especificar que os resultados não devem ser escritos em francês ou italiano. Dependendo do posicionamento dos parênteses na consulta, é possível usar o operador Booleano AND ou o operador Booleano OR para expressar a consulta. Isso ocorre porque, se um documento for escrito em francês, ele não será escrito em italiano. Portanto, sua declaração booleana precisa expressar que o documento não está escrito em francês e que o documento não está em italiano.


OR booleano [|]
Descrição

O operador OR (.) retorna resultados que estão na coleção à esquerda ou na coleção à direita do operador de barra vertical ("|").

Exemplos

Este exemplo retorna todos os resultados escritos em chinês simplificado ou tradicional:
lr=lang_zh-TW|lang_zh-CN

Este exemplo solicita todos os resultados que não estão escritos em francês ou italiano. Observe que ele coloca parênteses em um local diferente do exemplo de consulta para o operador Booleano AND:
lr=-(lang_fr|lang_it)


Parênteses booleanos [()]
Descrição

Com esse operador, você garante que todos os termos no conjunto mais interno de parênteses sejam avaliados antes que os termos fora dos parênteses sejam avaliados. Use parênteses para ajustar a ordem em que os termos são avaliados.

Exemplos

O exemplo do operador NOT [-] mostra a seguinte construção para resultados de solicitação que não estão escritos em francês ou italiano:
lr=(-lang_fr).(-lang_it)

O exemplo do operador OR (|) também mostra uma solicitação de resultados não escritos em francês do italiano. Como o último exemplo usa o operador OR em vez do operador AND, ele também precisa alterar a localização dos parênteses:
lr=-(lang_fr|lang_it)


Códigos de escape no URL

Para fazer uma solicitação de pesquisa HTTP, você precisa seguir determinadas convenções para que o Google possa traduzir sua solicitação HTTP e gerar uma resposta apropriada.

O esquema de URL HTTP especifica que uma solicitação desse tipo só pode conter determinados caracteres:

  • Caracteres alfanuméricos: (a-z, A-Z, 0-9)
  • Caracteres especiais: $ - _ . | + ! * ' ( )
  • Caracteres reservados: ; / ? : @ = &

O Google usa caracteres reservados para decodificar URLs e usa alguns caracteres especiais para solicitar recursos de pesquisa. Consequentemente, faça o escape de URL de todos os caracteres não alfanuméricos que ocorrem em valores de parâmetros de pesquisa.

Para fazer o escape de um URL, converta cada sequência de caracteres de espaço em branco em um único "+" (sinal de adição) e substitua todos os caracteres não alfanuméricos pela codificação hexadecimal que representa o valor desse caractere. As codificações hexadecimais dos caracteres especiais e reservados listados acima são mostradas na tabela a seguir. Cada um desses caracteres deve ter escape de URL nos valores de parâmetros da solicitação.

com caracteres Codificação
hexadecimal
$ %24
- %2D
_ %5F
. %2E
+ %2 bilhões
! %21
* %2A
" %22
. %27
( %28
) %29
; %3B
/ %2F
? %3F
: %3A
@ %40
= %3D
& %26
| %7C

Exemplos

String original Código de escape da string inserido no URL
punch&judy punch%26judy
O'Reilly O%27Reilly

É possível encontrar informações adicionais sobre escape de URL nos sites do W3C e do IETF.

Compactar resultados

O Google pode compactar os resultados da pesquisa usando a compactação HTTP gzip. Se você descompactar o conteúdo que foi compactado usando o algoritmo gzip, vai conseguir uma economia de largura de banda de 50% a 70%, o que pode melhorar os tempos de resposta.

Para solicitar que o Google retorne resultados em formato compactado, adicione o cabeçalho HTTP Accept-Encoding à solicitação de pesquisa HTTP da seguinte maneira:

Accept-Encoding: gzip

Se o Google retornar os resultados da pesquisa usando a compactação gzip, incluiremos a seguinte linha nos cabeçalhos HTTP retornados:

Content-Encoding: gzip

Observação: se o cabeçalho HTTP Content-Encoding não estiver presente na resposta, conforme mostrado acima, significa que o Google não compactou os resultados.

Esse comportamento é especificado no padrão HTTP. Consulte esse documento para mais informações sobre o uso da compactação HTTP gzip.

Valores internacionais

Esquemas de codificação de caracteres

A tabela a seguir lista os esquemas de codificação de caracteres compatíveis com o Google. Você pode atribuir aos parâmetros ie e oe os valores em qualquer uma das duas primeiras colunas dessa tabela. Os valores na primeira coluna são apelidos para os esquemas de codificação. Os valores na segunda coluna são os nomes padrão desses esquemas. O Google retorna os nomes padrão nos resultados XML, e os nomes padrão são adequados para uso nos cabeçalhos Content-type HTTP do seu documento.

Nome do Google Codificação Idiomas associados suportados
latin1 ISO-8859-1 Europa Ocidental (catalão, dinamarquês, holandês, inglês, finlandês, francês, alemão, indonésio, italiano, norueguês, português, espanhol e sueco)
latin2 ISO-8859-2 Europa Oriental (croata, tcheco, húngaro, polonês, romeno, sérvio, eslovaco, esloveno)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Mar Báltico (estoniano, letão e lituano)
cirílico ISO-8859-5 Búlgaro e russo
arabic ISO-8859-6  
grega ISO-8859-7 Grego
hebrew ISO-8859-8 Hebraico
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandês
euc-jp EUC-JP Japonês
euc-kr EUC-KR Coreano
sjis Shift_JIS Japonês
big5 Big5 Chinês tradicional
gb GB2312 Chinês simplificado
utf8 UTF-8 All

Idiomas de interface compatíveis

O Google oferece suporte a 74 idiomas. O idioma padrão da interface é o inglês. A lista a seguir identifica todos os idiomas de interface compatíveis com o Google.

Idioma de exibição Valor do parâmetro hl
Africâner af
Albanês sq
Amárico am
Árabe ar
Armênio hy
Azerbaijano az
Bengali bn
Búlgaro bg
Birmanês my
Catalão ca
Chinês (simplificado) zh-CN
Chinês (tradicional) zh-TW
Croata h
Tcheco cs
Dinamarquês da
Holandês nl
Inglês (Reino Unido) en-GB
Inglês en
Estoniano et
Filipino fil
Finlandês fi
Francês (Canadá) fr-CA
Francês fr
Georgiano ka
Alemão de
Grego el
Guzerate gu
Hebraico iw
Hindi hi
Húngaro hu
Islandês is
Indonésio id
Italiano it
Japonês ja
Canará kn
Cazaque kk
Khmer km
Coreano ko
Quirguiz ky
Laosiano lo
Letão lv
Lituano lt
Macedônio mk
Malaio ms
Malaio ml
Marati mr
Mongol mn
Nepalês ne
Norueguês (Bokmal) não
Persa fa
Polonês pl
Português (Brasil) pt-BR
Português (Portugal) pt-PT
Punjabi pa
Romeno ro
Russo ru
Sérvio (Latim) sr-Latn
Sérvio sr
Cingalês si
Eslovaco sk
Esloveno sl
Espanhol (América Latina) es-419
Espanhol es
Suaíli sw
Sueco sv
Tâmil ta
Télugo te
Tailandês th
Turco tr
Ucraniano uk
Urdu ur
Usbeque uz
Vietnamita vi
Galês cy

Valores do conjunto de idiomas

É possível usar os seguintes valores para especificar um filtro de idioma utilizando o parâmetro de consulta lr:

Idioma Valor do parâmetro lr
Árabe lang_ar
Búlgaro lang_bg
Catalão lang_ca
Chinês (simplificado) lang_zh-CN
Chinês (tradicional) lang_zh-TW
Croata lang_hr
Tcheco lang_cs
Dinamarquês lang_da
Holandês lang_nl
Inglês lang_en
Estoniano lang_et
Finlandês lang_fi
Francês lang_fr
Alemão lang_de
Grego lang_el
Hebraico lang_iw
Húngaro lang_hu
Islandês lang_is
Indonésio lang_id
Italiano lang_it
Japonês lang_ja
Coreano lang_ko
Letão lang_lv
Lituano lang_lt
Norueguês lang_no
Polonês lang_pl
Português lang_pt
Romeno lang_ro
Russo lang_ru
Sérvio lang_sr
Eslovaco lang_sk
Esloveno lang_sl
Espanhol lang_es
Sueco lang_sv
Turco lang_tr

Valores de conjuntos de países

É possível usar os seguintes valores para especificar um filtro de país usando o parâmetro de consulta cr:

País Nome da coleção de país
Afeganistão countryAF
Albânia countryAL
Argélia countryDZ
Samoa Americana countryAS
Andorra countryAD
Angola countryAO
Anguila countryAI
Antártida countryAQ
Antígua e Barbuda countryAG
Argentina countryAR
Armênia countryAM
Aruba countryAW
Austrália countryAU
Áustria countryAT
Azerbaijão countryAZ
Bahamas countryBS
Bahrein countryBH
Bangladesh countryBD
Barbados countryBB
Belarus countryBY
Bélgica countryBE
Belize countryBZ
Benin countryBJ
Bermudas countryBM
Butão countryBT
Bolívia countryBO
Bósnia e Herzegovina countryBA
Botsuana countryBW
Ilha Bouvet countryBV
Brasil countryBR
Território Britânico do Oceano Índico countryIO
Brunei Darussalam countryBN
Bulgária countryBG
Burkina Faso countryBF
Burundi countryBI
Camboja countryKH
Camarões countryCM
Canadá countryCA
Cabo Verde countryCV
Ilhas Cayman countryKY
República Centro-Africana countryCF
Chade countryTD
Chile countryCL
China countryCN
Ilha Christmas countryCX
Ilhas Cocos (Keeling) countryCC
Colômbia countryCO
Comores countryKM
Congo countryCG
Congo, República Democrática do countryCD
Ilhas Cook countryCK
Costa Rica countryCR
Costa do Marfim countryCI
Croácia (Hrvatska) countryHR
Cuba countryCU
Chipre countryCY
República Tcheca countryCZ
Dinamarca countryDK
Djibouti countryDJ
Dominica countryDM
República Dominicana countryDO
Timor Leste countryTP
Equador countryEC
Egito countryEG
El Salvador countrySV
Guiné Equatorial countryGQ
Eritreia countryER
Estônia countryEE
Etiópia countryET
União Europeia countryEU
Ilhas Falkland (Malvinas) countryFK
Ilhas Faroé countryFO
Fiji countryFJ
Finlândia countryFI
França countryFR
França (Área metropolitana) countryFX
Guiana Francesa countryGF
Polinésia Francesa countryPF
Territórios Franceses do Sul countryTF
Gabão countryGA
Gâmbia countryGM
Geórgia countryGE
Alemanha countryDE
Gana countryGH
Gibraltar countryGI
Grécia countryGR
Groenlândia countryGL
Granada countryGD
Guadalupe countryGP
Guam countryGU
Guatemala countryGT
Guiné countryGN
Guiné-Bissau countryGW
Guiana countryGY
Haiti countryHT
Ilhas Heard e McDonald countryHM
Santa Sé (Cidade do Vaticano) countryVA
Honduras countryHN
Hong Kong countryHK
Hungria countryHU
Islândia countryIS
Índia countryIN
Indonésia countryID
Irã, República Islâmica do countryIR
Iraque countryIQ
Irlanda countryIE
Israel countryIL
Itália countryIT
Jamaica countryJM
Japão countryJP
Jordânia countryJO
Cazaquistão countryKZ
Quênia countryKE
Quiribati countryKI
Coreia, República Democrática Popular da countryKP
Coreia, República da countryKR
Kuwait countryKW
Quirguistão countryKG
República Popular Democrática do Laos countryLA
Letônia countryLV
Líbano countryLB
Lesoto countryLS
Libéria countryLR
Líbia countryLY
Liechtenstein countryLI
Lituânia countryLT
Luxemburgo countryLU
Macau countryMO
Macedônia countryMK
Madagascar countryMG
Malawi countryMW
Malásia countryMY
Maldivas countryMV
Mali countryML
Malta countryMT
Ilhas Marshall countryMH
Martinica countryMQ
Mauritânia countryMR
Maurício countryMU
Ilha Mayotte countryYT
México countryMX
Micronésia, Estados Federados da countryFM
Moldávia, República da countryMD
Mônaco countryMC
Mongólia countryMN
Montserrat countryMS
Marrocos countryMA
Moçambique countryMZ
Mianmar countryMM
Namíbia countryNA
Nauru countryNR
Nepal countryNP
Países Baixos countryNL
Antilhas Holandesas countryAN
Nova Caledônia countryNC
Nova Zelândia countryNZ
Nicarágua countryNI
Níger countryNE
Nigéria countryNG
Niue countryNU
Ilha Norfolk countryNF
Ilhas Marianas do Norte countryMP
Noruega countryNO
Omã countryOM
Paquistão countryPK
Palau countryPW
Território Palestino countryPS
Panamá countryPA
Papua Nova Guiné countryPG
Paraguai countryPY
Peru countryPE
Filipinas countryPH
Pitcairn countryPN
Polônia countryPL
Portugal countryPT
Porto Rico countryPR
Catar countryQA
Reunião countryRE
Romênia countryRO
Federação Russa countryRU
Ruanda countryRW
Santa Helena countrySH
São Cristóvão e Névis countryKN
Santa Lúcia countryLC
São Pedro e Miquelon countryPM
São Vicente e Granadinas countryVC
Samoa countryWS
San Marino countrySM
São Tomé e Príncipe countryST
Arábia Saudita countrySA
Senegal countrySN
Sérvia e Montenegro countryCS
Seichelles countrySC
Serra Leoa countrySL
Singapura countrySG
Eslováquia countrySK
Eslovênia countrySI
Ilhas Salomão countrySB
Somália countrySO
África do Sul countryZA
Ilhas Geórgia do Sul e Sandwich do Sul countryGS
Espanha countryES
Sri Lanka countryLK
Sudão countrySD
Suriname countrySR
Svalbard e Jan Mayen countrySJ
Suazilândia countrySZ
Suécia countrySE
Suíça countryCH
República Árabe da Síria countrySY
Taiwan, Província da China countryTW
Tadjiquistão countryTJ
Tanzânia, República Unida da countryTZ
Tailândia countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trinidad e Tobago countryTT
Tunísia countryTN
Turquia countryTR
Turcomenistão countryTM
Ilhas Turcas e Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ucrânia countryUA
Emirados Árabes Unidos countryAE
Reino Unido countryUK
Estados Unidos countryUS
Territórios Insulares dos Estados Unidos countryUM
Uruguai countryUY
Uzbequistão countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnã countryVN
Ilhas Virgens Britânicas countryVG
Ilhas Virgens (EUA) countryVI
Wallis e Futuna countryWF
Saara Ocidental countryEH
Iêmen countryYE
Iugoslávia countryYU
Zâmbia countryZM
Zimbábue countryZW

Códigos de países

A tabela a seguir lista os códigos de país de duas letras que podem ser usados como valores do parâmetro gl:

País Country Code
Afeganistão af
Albânia Al
Argélia dz
Samoa Americana como
Andorra anúncio
Angola ao
Anguila ai
Antártida aq
Antígua e Barbuda ag
Argentina ar
Armênia sou
Aruba aw
Austrália au
Áustria às
Azerbaijão az
Bahamas bs
Bahrein bh
Bangladesh bd
Barbados bb
Belarus por
Bélgica ser
Belize bz
Benin bj
Bermudas bm
Butão bt
Bolívia bo
Bósnia e Herzegovina ba
Botsuana bw
Ilha Bouvet bv
Brasil br
Território Britânico do Oceano Índico io
Brunei Darussalam bn
Bulgária bg
Burkina Faso bf
Burundi bi
Camboja kh
Camarões cm
Canadá ca
Cabo Verde cv
Ilhas Cayman ky
República Centro-Africana cf
Chade td
Chile cl
China cn
Ilha Christmas cx
Ilhas Cocos (Keeling) cc
Colômbia co
Comores km
Congo g
Congo, República Democrática do cd
Ilhas Cook ck
Costa Rica cr
Costa do Marfim ci
Croácia h
Cuba cu
Chipre cy
República Tcheca cz
Dinamarca dk
Djibouti dj
Dominica dm
República Dominicana fazer
Equador ec
Egito eg
El Salvador sv
Guiné Equatorial gq
Eritreia er
Estônia ee
Etiópia et
Ilhas Falkland (Malvinas) fk
Ilhas Faroé fo
Fiji fj
Finlândia fi
França fr
Guiana Francesa gf
Polinésia Francesa pf
Territórios Franceses do Sul tf
Gabão ga
Gâmbia gm
Geórgia ge
Alemanha de
Gana gh
Gibraltar gi
Grécia gr
Groenlândia gl
Granada gd
Guadalupe gp
Guam gu
Guatemala gt
Guiné gn
Guiné-Bissau gw
Guiana Gym
Haiti ht
Ilhas Heard e McDonald hum
Santa Sé (Cidade do Vaticano) va
Honduras hn
Hong Kong hk
Hungria hu
Islândia é
Índia em
Indonésia id
Irã, República Islâmica do ir
Iraque iq
Irlanda ie
Israel il
Itália para recebê-los.
Jamaica jm
Japão jp
Jordânia jo
Cazaquistão kz
Quênia ke
Quiribati ki
Coreia, República Democrática Popular da kp
Coreia, República da kr
Kuwait kw
Quirguistão kg
República Popular Democrática do Laos la
Letônia lv
Líbano lb
Lesoto ls
Libéria lr
Líbia ly
Liechtenstein li
Lituânia lt
Luxemburgo lu
Macau mês
Macedônia mk
Madagascar mg
Malawi mw
Malásia my
Maldivas mv
Mali ml
Malta mt
Ilhas Marshall mh
Martinica mq
Mauritânia mr
Maurício mu
Ilha Mayotte yt
México mx
Micronésia, Estados Federados da fm
Moldávia, República da md
Mônaco Mc
Mongólia mn
Montserrat ms
Marrocos ma
Moçambique mz
Mianmar mm
Namíbia América do Norte
Nauru nr
Nepal np
Países Baixos nl
Antilhas Holandesas uma
Nova Caledônia nc
Nova Zelândia nz
Nicarágua ni
Níger ne
Nigéria ng
Niue nu
Ilha Norfolk NF
Ilhas Marianas do Norte mp
Noruega não
Omã om
Paquistão pk
Palau pw
Território Palestino Ocupado ps
Panamá pa
Papua Nova Guiné p.
Paraguai py
Peru pe
Filipinas ph
Pitcairn PLN
Polônia pl
Portugal pt
Porto Rico pr
Catar qa
Reunião Re
Romênia ro
Federação Russa ru
Ruanda rw
Santa Helena sh
São Cristóvão e Névis kn
Santa Lúcia lc
São Pedro e Miquelon pm
São Vicente e Granadinas vc
Samoa ws
San Marino sm
São Tomé e Príncipe st
Arábia Saudita sa
Senegal sn
Sérvia e Montenegro cs
Seichelles sc
Serra Leoa sl
Singapura sg
Eslováquia sk
Eslovênia si
Ilhas Salomão sb
Somália so
África do Sul za
Ilhas Geórgia do Sul e Sandwich do Sul gs
Espanha es
Sri Lanka Kk
Sudão sd
Suriname sr
Svalbard e Jan Mayen sj
Suazilândia sz
Suécia se
Suíça ch
República Árabe da Síria sy
Taiwan, Província da China tw
Tadjiquistão Tj
Tanzânia, República Unida da tz
Tailândia th
Timor Leste tl
Togo tg
Tokelau tk
Tonga a
Trinidad e Tobago tt
Tunísia tn
Turquia tr
Turcomenistão tm
Ilhas Turcas e Caicos tc
Tuvalu tv
Uganda ug
Ucrânia ua
Emirados Árabes Unidos ae
Reino Unido uk
Estados Unidos us
Territórios Insulares dos Estados Unidos hum
Uruguai uy
Uzbequistão uz
Vanuatu Vu
Venezuela ve
Vietnã vn
Ilhas Virgens Britânicas vg
Ilhas Virgens (EUA) vi
Wallis e Futuna wf
Saara Ocidental ah
Iêmen
Zâmbia ZM
Zimbábue Zw