Referência da API JSON

Booleano OR Pesquisa [ OU ]
Descrição

O termo de consulta OR recupera documentos que incluem um de uma série de (dois ou mais) termos de consulta. Para usar a consulta OR você inseriria o termo de pesquisa OR, em letras maiúsculas letras, entre cada termo da série.

Você também pode usar "as_oq" solicitação (como "as_oq=Londres+Paris") para enviar uma pesquisa por qualquer termo em um conjunto de em alguns termos cruciais.

Observação:se uma solicitação de pesquisa especificar a consulta "Londres+OR+Paris", os resultados da pesquisa incluirão documentos que contenham pelo menos uma dessas duas palavras. Em alguns casos, documentos nos resultados da pesquisa podem conter ambas as palavras.
Exemplos

Pesquisar Londres ou Paris:

Entrada do usuário:london OR paris Termo de consulta:q=london+OR+paris

Pesquisar férias e Londres ou Paris:

Termo de consulta:q=vacation+london+OR+paris

Pesquisar férias e uma em Londres, Paris ou chocolates:

Termo de consulta:  q=vacation+london+OR+paris+OR+chocolates

Pesquise "férias", chocolates e Londres ou Paris, com menor peso para chocolates:

Termo de consulta:  q=vacation+london+OR+paris+chocolates

Pesquise férias, chocolates e flores em documentos que também contêm Londres ou Paris:

Termo de consulta:  q=vacation+london+OR+paris+chocolates+flowers

Pesquise "Férias" e "Londres ou Paris" e também pesquise de chocolates ou flores:

Termo de consulta:  q=vacation+london+OR+paris+chocolates+OR+flowers

Operadores booleanos

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

  • cr
  • lr

Definições dos 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 são na interseção das coleções aos dois lados do "." usando um operador lógico.
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 estiverem na coleção imediatamente após o operador de subtração ("-").
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: talvez você tenha notado que o segundo exemplo acima usa a função Booleana Operador AND para especificar que os resultados não devem ser gravados em francês ou italiano. Dependendo do posicionamento dos parênteses na sua consulta, é possível use o operador Booleano AND ou o operador Booleano OR para expressar essa consulta. Isso acontece porque, se um documento é escrito em francês, ele não está escrito em italiano. Assim, sua declaração Booleana deve expressar que o documento não está escrito em francês e o documento não está em italiano.

Booleano OR [|]
Descrição

O operador OR (|) retorna resultados que estão em a coleção à esquerda ou à direita da operador pipe ("|").
Exemplos

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

Este exemplo solicita todos os resultados que não estão gravados na Francês ou italiano ele coloca parênteses em um local diferente do que a consulta de amostra pelo operador Booleano AND:
lr=-(lang_fr|lang_it)


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

Com esse operador, você garante que todos os termos o conjunto de parênteses é avaliado antes dos termos fora deles são avaliadas. Você pode usar parênteses para ajustar a ordem em que e os termos são avaliados.
Exemplos

O exemplo do operador NOT [-] mostra a construção a seguir para resultados de solicitação que não sã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 de Italiano. Como o último exemplo usa o operador OR em vez do operador AND, ele também precisa mudar o local do parênteses:
lr=-(lang_fr|lang_it)

Internacionalização de consultas e apresentação de resultados

O serviço Google WebSearch permite pesquisar documentos no vários idiomas. Você pode especificar a codificação de caracteres que deve ser usada para interpretar sua solicitação HTTP e codificar sua resposta. Também é possível filtrar os resultados para incluir apenas documentos escritos em determinadas linguagens.

As seções a seguir discutem questões relacionadas à pesquisa em vários idiomas:

Idiomas da interface

Você pode usar o "hl" o parâmetro de solicitação identificar o idioma de sua interface gráfica. O "hl" pode afetar os resultados de pesquisa, especialmente em consultas internacionais quando a restrição de idioma (usando o parâmetro "lr") não é explicitamente especificada. Dessa forma, os casos, o "hl" pode promover resultados de pesquisa no mesmo idioma de entrada do usuário.

Sugerimos que você defina explicitamente o "hl" parâmetro nos resultados da pesquisa para que o Google selecione resultados de pesquisa para cada consulta.

Consulte a interface compatível Idiomas para uma lista completa de valores válidos para o campo "hl" .

Chinês simplificado e chinês tradicional são duas variantes de escrita do idioma chinês. O mesmo conceito pode ser escrito de forma diferente para cada variante. Dada uma consulta em uma das variantes, o serviço O serviço WebSearch pode retornar resultados que incluam páginas tanto variantes.

Para usar esse recurso:

  1. Defina o "c2coff" parâmetro de solicitação para 0
    e
  2. Realize uma das seguintes ações:
    • Não defina o "lr" parâmetro de solicitação
      ou
    • Definir a "lr" parâmetro de solicitação para lr=lang_zh-TW|lang_zh-CN

O exemplo a seguir mostra os parâmetros de consulta que você incluiria em uma solicitação de resultados em chinês simplificado e tradicional. Informações adicionais obrigatórias, como como o "cliente", não está incluído no exemplo.)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Como filtrar resultados

O Google WebSearch oferece várias maneiras de filtrar sua pesquisa resultados:

Filtragem automática de resultados da pesquisa

Em um esforço para fornecer os melhores resultados de pesquisa possíveis, o Google usa duas técnicas para filtrar automaticamente os resultados da pesquisa que não geralmente considerados indesejáveis:

  • Conteúdo duplicado: se vários documentos contiverem o mesmas informações, apenas o documento mais relevante desse conjunto incluídos nos resultados da pesquisa.

  • Agrupamento de hosts: se houver muitos resultados de pesquisa do mesmo site, o Google pode não mostrar todos os resultados desse site ou mostrar os resultados mais baixos em
    a classificação do que de outra forma.

Recomendamos deixar esses filtros ativados para solicitações de pesquisa comuns porque os filtros melhoram significativamente a qualidade da maioria resultados. No entanto, você pode ignorar esses filtros automáticos definindo o "filtro" o parâmetro de consulta como 0 na solicitação de pesquisa.

Filtrar conteúdo adulto com o SafeSearch

Muitos clientes do Google não querem exibir os resultados da pesquisa para locais com conteúdo adulto. Com o filtro SafeSearch, você pode filtrar para resultados de pesquisa com conteúdo adulto e eliminá-los. Os filtros do Google utilizam tecnologia reservada para verificar palavras-chave, frases e URLs. Embora nenhum filtro seja 100% preciso, o SafeSearch remova a esmagadora maioria de conteúdo adulto da sua pesquisa resultados.

O Google se esforça para manter o SafeSearch tão atual e abrangente quanto sempre que possível rastreando continuamente a Web e incorporando atualizações com base nas sugestões dos usuários.

Você pode ajustar o grau em que o Google filtra seus resultados conteúdo adulto usando a classificação parâmetro de consulta. A tabela a seguir explica as configurações do SafeSearch do Google e como elas de pesquisa afetam os resultados da pesquisa:

Nível do SafeSearch Descrição
high Ativa uma versão mais rigorosa da pesquisa segura.
medium Bloqueia páginas da Web que contenham pornografia e outros tipos de conteúdo sexual explícito.
off Não filtra conteúdo adulto conteúdo dos resultados da pesquisa.

* A configuração padrão do SafeSearch está desativada.

Valores internacionais

Idiomas de interface compatíveis

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

Idioma de exibição Valor do parâmetro hl
Africâner af
Albanês sq
Amárico sm
Árabe ar
Azerbaijano az
Basco eu
Bielorrusso be
Bengali bn
Biari bh
Bósnio bs
Búlgaro bg
Catalão ca
Chinês (simplificado) zh-CN
Chinês (tradicional) zh-TW
Croata hr
Tcheco cs
Dinamarquês da
Holandês nl
Inglês en
Esperanto eo
Estoniano et
Faroês fo
Finlandês fi
Francês fr
Frísio fy
Galego gl
Georgiano ka
Alemão de
Grego el
Guzerate gu
Hebraico iw
Híndi hi
Húngaro hu
Islandês is
Indonésio id
Interlíngua ia
Irlandês ga
Italiano it
Japonês ja
Javanês jw
Canarês kn
Coreano ko
Latim la
Letão lv
Lituano lt
Macedônio mk
Malaio ms
Malaio ml
Maltês mt
Marati mr
Nepalês ne
Norueguês no
Norueguês (Nynorsk) nn
Occitânico oc
Persa fa
polonês pl
Português (Brasil) pt-BR
Português (Portugal) pt-PT
Panjabi pa
Romeno ro
Russo ru
Gaélico escocês gd
Sérvio sr
Cingalês si
Eslovaco sk
Esloveno sl
Espanhol es
Sudanês su
Suaíli sw
Sueco sv
Tagalo tl
Tâmil ta
Télugo te
Tailandês th
Tigrinya ti
Turco tr
Ucraniano uk
Urdu ur
Usbeque uz
Vietnamita vi
Galês cy
Xhosa xh
Zulu zu

Valores de coleta de país

Você pode usar os seguintes valores para especificar um filtro de país usando o "cr" parâmetro de consulta:

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
Barein countryBH
Bangladesh countryBD
Barbados countryBB
Bielorrússia 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 Fasso 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
Ilhas 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
Djibuti 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ã 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 Popular Democrática da countryKP
Coreia, República da countryKR
Kuwait countryKW
Quirguistão countryKG
República Democrática Popular 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 (antiga República Iugosalva da Macedônia) countryMK
Madagascar countryMG
Malauí countryMW
Malásia countryMY
Maldivas countryMV
Mali countryML
Malta countryMT
Ilhas Marshall countryMH
Martinica countryMQ
Mauritânia countryMR
Ilhas Maurício countryMU
Ilha Mayotte countryYT
México countryMX
Micronésia countryFM
Moldávia 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
Ilha 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
Saint Pierre 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
Seychelles 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
Ilhas Svalbard e Jan Mayen countrySJ
Suazilândia countrySZ
Suécia countrySE
Suíça countryCH
Síria countrySY
Taiwan, Província da China countryTW
Tadjiquistão countryTJ
Tanzânia, República Unida da countryTZ
Tailândia countryTH
Togo countryTG
Toquelau countryTK
Tonga countryTO
Trinidad e Tobago countryTT
Tunísia countryTN
Turquia countryTR
Turcomenistão countryTM
Ilhas Turks e Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ucrânia countryUA
Emirados Árabes Unidos countryAE
Reino Unido countryUK
Estados Unidos countryUS
Ilhas Menores Distantes dos Estados Unidos countryUM
Uruguai countryUY
Uzbequistão countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnã countryVN
Ilhas Virgens Britânicas countryVG
Ilhas Virgens (EUA) countryVI
Ilhas 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 usada como valores do "gl" :

País Código do país
Afeganistão af
Albânia al
Argélia dz
Samoa Americana as
Andorra ad
Angola ao
Anguila ai
Antártida aq
Antígua e Barbuda ag
Argentina ar
Armênia am
Aruba aw
Austrália au
Áustria at
Azerbaijão az
Bahamas bs
Barein bh
Bangladesh bd
Barbados bb
Bielorrússia by
Bélgica be
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 Fasso 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
Ilhas Comores km
Congo cg
Congo, República Democrática do cd
Ilhas Cook ck
Costa Rica cr
Costa do Marfim ci
Croácia hr
Cuba cu
Chipre cy
República Tcheca cz
Dinamarca dk
Djibuti dj
Dominica dm
República Dominicana do
Equador ec
Egito eg
El Salvador sv
Guiné Equatorial gq
Eritreia er
Estônia ee
Etiópia et
Ilhas Malvinas (Falkland) 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 gy
Haiti ht
Ilhas Heard e McDonald hm
Santa Sé (Cidade do Vaticano) va
Honduras hn
Hong Kong hk
Hungria hu
Islândia is
Índia in
Indonésia id
Irã ir
Iraque iq
Irlanda ie
Israel il
Itália it
Jamaica jm
Japão jp
Jordânia jo
Cazaquistão kz
Quênia ke
Quiribati ki
Coreia, República Popular Democrática da kp
Coreia, República da kr
Kuwait kw
Quirguistão kg
República Democrática Popular 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 mo
Macedônia (antiga República Iugosalva da Macedônia) mk
Madagascar mg
Malauí mw
Malásia my
Maldivas mv
Mali ml
Malta mt
Ilhas Marshall mh
Martinica mq
Mauritânia mr
Ilhas Maurício mu
Ilha Mayotte yt
México mx
Micronésia fm
Moldávia md
Mônaco mc
Mongólia mn
Montserrat ms
Marrocos ma
Moçambique mz
Mianmar mm
Namíbia na
Nauru nr
Nepal np
Países Baixos nl
Antilhas Holandesas an
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 no
Omã om
Paquistão pk
Palau pw
Território Palestino Ocupado ps
Panamá pa
Papua-Nova Guiné pg
Paraguai py
Peru pe
Filipinas ph
Pitcairn pn
Polônia pl
Portugal pt
Porto Rico pr
Catar qa
Ilha 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
Saint Pierre 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
Seychelles 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 lk
Sudão sd
Suriname sr
Ilhas Svalbard e Jan Mayen sj
Suazilândia sz
Suécia se
Suíça ch
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
Toquelau tk
Tonga to
Trinidad e Tobago tt
Tunísia tn
Turquia tr
Turcomenistão tm
Ilhas Turks e Caicos tc
Tuvalu tv
Uganda ug
Ucrânia ua
Emirados Árabes Unidos ae
Reino Unido uk
Estados Unidos us
Ilhas Menores Distantes dos Estados Unidos um
Uruguai uy
Uzbequistão uz
Vanuatu vu
Venezuela ve
Vietnã vn
Ilhas Virgens Britânicas vg
Ilhas Virgens (EUA) vi
Ilhas Wallis e Futuna wf
Saara Ocidental eh
Iêmen ye
Zâmbia zm
Zimbábue zw