Справочник по API JSON

Логическое ИЛИ Поиск [ ИЛИ ]
Описание

Термин запроса OR извлекает документы, которые включают один из нескольких (двух или более) терминов запроса. Чтобы использовать термин запроса OR , необходимо вставить поисковый термин OR заглавными буквами между каждым термином в серии.

Вы также можете использовать параметр запроса «as_oq» (например, «as_oq=London+Paris»), чтобы отправить поиск по любому термину в наборе терминов.

Примечание. Если в поисковом запросе указан запрос «Лондон+ИЛИ+Париж», результаты поиска будут включать документы, содержащие хотя бы одно из этих двух слов. В некоторых случаях документы в результатах поиска могут содержать оба слова.

Примеры

Искать Лондон или Париж:

Пользовательский ввод: london OR paris Термин запроса: q=london+OR+paris

Поиск отпуска и Лондона или Парижа:

Термин запроса: q=vacation+london+OR+paris

Поиск отпуска и одного из Лондона, Парижа или шоколада:

Термин запроса: q=vacation+london+OR+paris+OR+chocolates

Найдите отпуск и шоколад, а также Лондон или Париж, при этом шоколаду будет придан наименьший вес:

Термин запроса: q=vacation+london+OR+paris+chocolates

Поиск отпуска, шоколада и цветов в документах, которые также содержат Лондон или Париж:

Термин запроса: q=vacation+london+OR+paris+chocolates+flowers

Найдите отпуск и один из Лондона или Парижа, а также найдите шоколад или цветы:

Термин запроса: q=vacation+london+OR+paris+chocolates+OR+flowers

Булевы операторы

Вы можете использовать логические операторы в значениях следующих параметров:

  • cr
  • lr

Определения логических операторов

Примечание. В значения параметров нельзя включать пробелы.

Логическое AND [.]
Описание

Оператор AND ( . ) возвращает результаты, находящиеся на пересечении коллекций по обе стороны от оператора « . ».

Примеры

В этом примере удаляются все результаты на французском или итальянском языке:
lr=(-lang_fr).(-lang_it)


Логическое NOT [-]
Описание

Оператор NOT ( - ) удаляет все результаты, находящиеся в коллекции сразу после оператора минус (« - »).

Примеры

В этом примере удаляются все результаты на французском языке:
lr=-lang_fr

В этом примере удаляются все результаты на французском или итальянском языке:
lr=(-lang_fr).(-lang_it)

Примечание. Возможно, вы заметили, что во втором примере выше используется логический оператор AND, чтобы указать, что результаты не должны быть записаны на французском или итальянском языке. В зависимости от расположения круглых скобок в вашем запросе вы можете использовать либо логический оператор AND , либо логический оператор OR для выражения этого запроса. Это связано с тем, что если документ написан на французском языке, то он не написан на итальянском языке. Таким образом, ваше логическое утверждение должно выражать то, что документ написан не на французском языке и документ не написан на итальянском языке.


Логическое OR [|]
Описание

Оператор OR ( | ) возвращает результаты, которые находятся либо в коллекции слева, либо в коллекции справа от оператора канала (" | ").

Примеры

В этом примере возвращаются все результаты, написанные на упрощенном или традиционном китайском языке:
lr=lang_zh-TW|lang_zh-CN

В этом примере запрашиваются все результаты, которые не написаны на французском или итальянском языке; обратите внимание, что круглые скобки помещаются в другом месте, чем в примере запроса для логического оператора AND :
lr=-(lang_fr|lang_it)


Логические круглые скобки [()]
Описание

Этот оператор позволяет гарантировать, что все термины в самых внутренних скобках будут оценены до того, как будут оценены термины за пределами круглых скобок. Вы можете использовать круглые скобки, чтобы настроить порядок оценки терминов.

Примеры

В примере оператора NOT [-] показана следующая конструкция для результатов запроса, которые не написаны ни на французском, ни на итальянском языке:
lr=(-lang_fr).(-lang_it)

В примере оператора OR (|) также показан запрос результатов, написанных не на французском или итальянском языках. Поскольку в последнем примере используется оператор OR , а не оператор AND , в нем также необходимо изменить расположение круглых скобок:
lr=-(lang_fr|lang_it)

Интернационализация запросов и представление результатов

Служба Google WebSearch позволяет искать документы на нескольких языках. Вы можете указать кодировку символов, которая должна использоваться для интерпретации вашего HTTP-запроса и кодирования вашего ответа. Вы также можете отфильтровать результаты, чтобы включать только документы, написанные на определенных языках.

В следующих разделах обсуждаются вопросы, связанные с поиском на нескольких языках:

Языки интерфейса

Вы можете использовать параметр запроса «hl», чтобы определить язык вашего графического интерфейса. Значение параметра «hl» может повлиять на результаты поиска, особенно по международным запросам, когда языковое ограничение (с использованием параметра «lr») не указано явно. В таких случаях параметр «hl» может отображать результаты поиска на том же языке, что и язык ввода пользователя.

Мы предлагаем вам явно установить параметр «hl» в результатах поиска, чтобы гарантировать, что Google выбирает результаты поиска самого высокого качества для каждого запроса.

Полный список допустимых значений параметра «hl» см. в разделе «Поддерживаемые языки интерфейса» .

Упрощенный китайский и традиционный китайский — это два варианта письма китайского языка. В каждом варианте одно и то же понятие может быть записано по-разному. При запросе в одном из вариантов служба Google WebSearch может возвращать результаты, включающие страницы в обоих вариантах.

Чтобы использовать эту функцию:

  1. Установите для параметра запроса «c2coff» значение 0
    и
  2. Выполните одно из следующих действий:
    • Не устанавливайте параметр запроса «lr»
      или
    • Установите для параметра запроса «lr» значение lr=lang_zh-TW|lang_zh-CN

В следующем примере показаны параметры запроса, которые вы бы включили в запрос результатов как на упрощенном, так и на традиционном китайском языке. (Обратите внимание, что дополнительная необходимая информация, такая как «клиент», не включена в пример.)

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

Фильтрация результатов

Google WebSearch предоставляет несколько способов фильтрации результатов поиска:

Автоматическая фильтрация результатов поиска

Стремясь обеспечить наилучшие результаты поиска, Google использует два метода автоматической фильтрации результатов поиска, которые обычно считаются нежелательными:

  • Дублирующийся контент . Если несколько документов содержат одну и ту же информацию, в результаты поиска включается только наиболее релевантный документ из этого набора.

  • Переполнение хостов . Если на одном сайте много результатов поиска, Google может не отображать все результаты с этого сайта или показывать результаты ниже.
    рейтинг, чем они были бы в противном случае.

Мы рекомендуем вам оставить эти фильтры включенными для типичных поисковых запросов, поскольку они значительно повышают качество большинства результатов поиска. Однако вы можете обойти эти автоматические фильтры, установив для параметра запроса «filter» значение 0 в своем поисковом запросе.

Фильтрация контента для взрослых с помощью Безопасного поиска

Многие клиенты Google не хотят отображать результаты поиска для сайтов, содержащих контент для взрослых. Используя наш фильтр безопасного поиска, вы можете проверять результаты поиска, содержащие контент для взрослых, и удалять их. Фильтры Google используют запатентованную технологию для проверки ключевых слов, фраз и URL-адресов. Хотя ни один фильтр не обеспечивает 100-процентную точность, SafeSearch удалит подавляющее большинство контента для взрослых из результатов поиска.

Google стремится поддерживать Безопасный поиск как можно более актуальным и всеобъемлющим, постоянно сканируя Интернет и добавляя обновления на основе предложений пользователей.

Вы можете настроить степень, в которой Google фильтрует ваши результаты для контента для взрослых, используя параметр «безопасный» запрос. В следующей таблице описаны настройки безопасного поиска Google и то, как эти настройки повлияют на результаты поиска:

Уровень безопасного поиска Описание
high Включает более строгую версию безопасного поиска.
medium Блокирует веб-страницы, содержащие порнографию и другой контент откровенно сексуального характера.
off Не фильтрует контент для взрослых из результатов поиска.

* Настройка Безопасного поиска по умолчанию отключена .

Международные ценности

Поддерживаемые языки интерфейса

Google поддерживает более 80 языков. Язык интерфейса по умолчанию — английский. В следующем списке указаны все языки интерфейса, которые поддерживает Google.

Язык дисплея Значение параметра hl
африкаанс af
албанский sq
амхарский sm
арабский ar
азербайджанский az
Баскский eu
белорусский be
Бенгальский bn
Бихари bh
Боснийский bs
болгарский bg
каталонский ca
Китайский (упрощенный) zh-CN
Китайский (традиционный) zh-TW
хорватский hr
чешский cs
датский da
Голландский nl
Английский en
эсперанто eo
эстонский et
фарерский fo
финский fi
Французский fr
фризский fy
галисийский gl
грузинский ka
немецкий de
Греческий el
Гуджарати gu
иврит iw
хинди hi
венгерский hu
исландский is
индонезийский id
Интерлингва ia
ирландский ga
итальянский it
японский ja
яванский jw
Каннада kn
корейский ko
латинский la
латышский lv
литовский lt
македонский mk
малайский ms
малаям ml
мальтийский mt
маратхи mr
непальский ne
норвежский no
Норвежский (Нюнорск) nn
окситанский oc
персидский fa
Польский pl
Португальский (Бразилия) pt-BR
Португальский (Португалия) pt-PT
панджаби pa
румынский ro
Русский ru
Шотландский гэльский gd
сербский sr
сингальский si
словацкий sk
словенский sl
испанский es
Суданский su
суахили sw
Шведский sv
Тагальский tl
тамильский ta
телугу te
тайский th
Тигринья ti
турецкий tr
Украинский uk
урду ur
Узбекский uz
вьетнамский vi
валлийский cy
коса xh
Зулу zu

Значения коллекции стран

Вы можете использовать следующие значения, чтобы указать фильтр страны с помощью параметра запроса «cr»:

Страна Название коллекции стран
Афганистан countryAF
Албания countryAL
Алжир countryDZ
Американское Самоа countryAS
Андорра countryAD
Ангола countryAO
Ангилья countryAI
Антарктида countryAQ
Антигуа и Барбуда countryAG
Аргентина countryAR
Армения countryAM
Аруба countryAW
Австралия countryAU
Австрия countryAT
Азербайджан countryAZ
Багамы countryBS
Бахрейн countryBH
Бангладеш countryBD
Барбадос countryBB
Беларусь countryBY
Бельгия countryBE
Белиз countryBZ
Бенин countryBJ
Бермуды countryBM
Бутан countryBT
Боливия countryBO
Босния и Герцеговина countryBA
Ботсвана countryBW
Остров Буве countryBV
Бразилия countryBR
Британская территория в Индийском океане countryIO
Бруней-Даруссалам countryBN
Болгария countryBG
Буркина-Фасо countryBF
Бурунди countryBI
Камбоджа countryKH
Камерун countryCM
Канада countryCA
Кабо-Верде countryCV
Каймановы острова countryKY
Центральноафриканская Республика countryCF
Чад countryTD
Чили countryCL
Китай countryCN
Остров Рождества countryCX
Кокосовые острова (Килинг) countryCC
Колумбия countryCO
Коморские Острова countryKM
Конго countryCG
Конго, Демократическая Республика countryCD
Острова Кука countryCK
Коста-Рика countryCR
Берег Слоновой Кости countryCI
Хорватия (Хрватска) countryHR
Куба countryCU
Кипр countryCY
Чешская Республика countryCZ
Дания countryDK
Джибути countryDJ
Доминика countryDM
Доминиканская Республика countryDO
Восточный Тимор countryTP
Эквадор countryEC
Египет countryEG
Сальвадор countrySV
Экваториальная Гвинея countryGQ
Эритрея countryER
Эстония countryEE
Эфиопия countryET
Евросоюз countryEU
Фолклендские острова (Мальвинские острова) countryFK
Фарерские острова countryFO
Фиджи countryFJ
Финляндия countryFI
Франция countryFR
Франция, Метрополитен countryFX
Французская Гвиана countryGF
Французская Полинезия countryPF
Южные территории Франции countryTF
Габон countryGA
Гамбия countryGM
Грузия countryGE
Германия countryDE
Гана countryGH
Гибралтар countryGI
Греция countryGR
Гренландия countryGL
Гренада countryGD
Гваделупа countryGP
Гуам countryGU
Гватемала countryGT
Гвинея countryGN
Гвинея-Бисау countryGW
Гайана countryGY
Гаити countryHT
Остров Херд и острова Макдональда countryHM
Святой Престол (государство-город Ватикан) countryVA
Гондурас countryHN
Гонконг countryHK
Венгрия countryHU
Исландия countryIS
Индия countryIN
Индонезия countryID
Иран, Исламская Республика countryIR
Ирак countryIQ
Ирландия countryIE
Израиль countryIL
Италия countryIT
Ямайка countryJM
Япония countryJP
Иордания countryJO
Казахстан countryKZ
Кения countryKE
Кирибати countryKI
Корея, Народно-Демократическая Республика countryKP
Корея, Республика countryKR
Кувейт countryKW
Кыргызстан countryKG
Лаосская Народно-Демократическая Республика countryLA
Латвия countryLV
Ливан countryLB
Лесото countryLS
Либерия countryLR
Ливийская Арабская Джамахирия countryLY
Лихтенштейн countryLI
Литва countryLT
Люксембург countryLU
Макао countryMO
Македония, бывшая Югославская Республика countryMK
Мадагаскар countryMG
Малави countryMW
Малайзия countryMY
Мальдивы countryMV
Мали countryML
Мальта countryMT
Маршалловы острова countryMH
Мартиника countryMQ
Мавритания countryMR
Маврикий countryMU
Майотта countryYT
Мексика countryMX
Микронезия, Федеративные Штаты countryFM
Молдова, Республика countryMD
Монако countryMC
Монголия countryMN
Монтсеррат countryMS
Марокко countryMA
Мозамбик countryMZ
Мьянма countryMM
Намибия countryNA
Науру countryNR
Непал countryNP
Нидерланды countryNL
Нидерландские Антильские острова countryAN
Новая Каледония countryNC
Новая Зеландия countryNZ
Никарагуа countryNI
Нигер countryNE
Нигерия countryNG
Ниуэ countryNU
Остров Норфолк countryNF
Северные Марианские острова countryMP
Норвегия countryNO
Оман countryOM
Пакистан countryPK
Палау countryPW
Палестинская территория countryPS
Панама countryPA
Папуа-Новая Гвинея countryPG
Парагвай countryPY
Перу countryPE
Филиппины countryPH
Питкэрн countryPN
Польша countryPL
Португалия countryPT
Пуэрто-Рико countryPR
Катар countryQA
Воссоединение countryRE
Румыния countryRO
Российская Федерация countryRU
Руанда countryRW
Остров Святой Елены countrySH
Сент-Китс и Невис countryKN
Сент-Люсия countryLC
Сен-Пьер и Микелон countryPM
Сент-Винсент и Гренадины countryVC
Самоа countryWS
Сан-Марино countrySM
Сан-Томе и Принсипи countryST
Саудовская Аравия countrySA
Сенегал countrySN
Сербия и Черногория countryCS
Сейшельские острова countrySC
Сьерра-Леоне countrySL
Сингапур countrySG
Словакия countrySK
Словения countrySI
Соломоновы Острова countrySB
Сомали countrySO
ЮАР countryZA
Южная Георгия и Южные Сандвичевы острова countryGS
Испания countryES
Шри-Ланка countryLK
Судан countrySD
Суринам countrySR
Шпицберген и Ян-Майен countrySJ
Свазиленд countrySZ
Швеция countrySE
Швейцария countryCH
Сирийская Арабская Республика countrySY
Тайвань, провинция Китая countryTW
Таджикистан countryTJ
Танзания, Объединенная Республика countryTZ
Таиланд countryTH
Того countryTG
Токелау countryTK
Тонга countryTO
Тринидад и Тобаго countryTT
Тунис countryTN
Турция countryTR
Туркменистан countryTM
Острова Тёркс и Кайкос countryTC
Тувалу countryTV
Уганда countryUG
Украина countryUA
Объединенные Арабские Эмираты countryAE
Великобритания countryUK
Соединенные Штаты countryUS
Малые отдаленные острова США countryUM
Уругвай countryUY
Узбекистан countryUZ
Вануату countryVU
Венесуэла countryVE
Вьетнам countryVN
Виргинские острова, Британская countryVG
Виргинские острова, США countryVI
Уоллис и Футуна countryWF
Западная Сахара countryEH
Йемен countryYE
Югославия countryYU
Замбия countryZM
Зимбабве countryZW

Коды стран

В следующей таблице перечислены двухбуквенные коды стран, которые можно использовать в качестве значений параметра «gl»:

Страна Код страны
Афганистан af
Албания al
Алжир dz
Американское Самоа as
Андорра ad
Ангола ao
Ангилья ai
Антарктида aq
Антигуа и Барбуда ag
Аргентина ar
Армения am
Аруба aw
Австралия au
Австрия at
Азербайджан az
Багамы bs
Бахрейн bh
Бангладеш bd
Барбадос bb
Беларусь by
Бельгия be
Белиз bz
Бенин bj
Бермуды bm
Бутан bt
Боливия bo
Босния и Герцеговина ba
Ботсвана bw
Остров Буве bv
Бразилия br
Британская территория в Индийском океане io
Бруней-Даруссалам bn
Болгария bg
Буркина-Фасо bf
Бурунди bi
Камбоджа kh
Камерун cm
Канада ca
Кабо-Верде cv
Каймановы острова ky
Центральноафриканская Республика cf
Чад td
Чили cl
Китай cn
Остров Рождества cx
Кокосовые острова (Килинг) cc
Колумбия co
Коморские Острова km
Конго cg
Конго, Демократическая Республика cd
Острова Кука ck
Коста-Рика cr
Берег Слоновой Кости ci
Хорватия hr
Куба cu
Кипр cy
Чешская Республика cz
Дания dk
Джибути dj
Доминика dm
Доминиканская Республика do
Эквадор ec
Египет eg
Сальвадор sv
Экваториальная Гвинея gq
Эритрея er
Эстония ee
Эфиопия et
Фолклендские острова (Мальвинские острова) fk
Фарерские острова fo
Фиджи fj
Финляндия fi
Франция fr
Французская Гвиана gf
Французская Полинезия pf
Южные территории Франции tf
Габон ga
Гамбия gm
Грузия ge
Германия de
Гана gh
Гибралтар gi
Греция gr
Гренландия gl
Гренада gd
Гваделупа gp
Гуам gu
Гватемала gt
Гвинея gn
Гвинея-Бисау gw
Гайана gy
Гаити ht
Остров Херд и острова Макдональда hm
Святой Престол (государство-город Ватикан) va
Гондурас hn
Гонконг hk
Венгрия hu
Исландия is
Индия in
Индонезия id
Иран, Исламская Республика ir
Ирак iq
Ирландия ie
Израиль il
Италия it
Ямайка jm
Япония jp
Иордания jo
Казахстан kz
Кения ke
Кирибати ki
Корея, Народно-Демократическая Республика kp
Корея, Республика kr
Кувейт kw
Кыргызстан kg
Лаосская Народно-Демократическая Республика la
Латвия lv
Ливан lb
Лесото ls
Либерия lr
Ливийская Арабская Джамахирия ly
Лихтенштейн li
Литва lt
Люксембург lu
Макао mo
Македония, бывшая Югославская Республика mk
Мадагаскар mg
Малави mw
Малайзия my
Мальдивы mv
Мали ml
Мальта mt
Маршалловы острова mh
Мартиника mq
Мавритания mr
Маврикий mu
Майотта yt
Мексика mx
Микронезия, Федеративные Штаты fm
Молдова, Республика md
Монако mc
Монголия mn
Монтсеррат ms
Марокко ma
Мозамбик mz
Мьянма mm
Намибия na
Науру nr
Непал np
Нидерланды nl
Нидерландские Антильские острова an
Новая Каледония nc
Новая Зеландия nz
Никарагуа ni
Нигер ne
Нигерия ng
Ниуэ nu
Остров Норфолк nf
Северные Марианские острова mp
Норвегия no
Оман om
Пакистан pk
Палау pw
Палестинская территория, оккупированная ps
Панама pa
Папуа-Новая Гвинея pg
Парагвай py
Перу pe
Филиппины ph
Питкэрн pn
Польша pl
Португалия pt
Пуэрто-Рико pr
Катар qa
Воссоединение re
Румыния ro
Российская Федерация ru
Руанда rw
Остров Святой Елены sh
Сент-Китс и Невис kn
Сент-Люсия lc
Сен-Пьер и Микелон pm
Сент-Винсент и Гренадины vc
Самоа ws
Сан-Марино sm
Сан-Томе и Принсипи st
Саудовская Аравия sa
Сенегал sn
Сербия и Черногория cs
Сейшельские острова sc
Сьерра-Леоне sl
Сингапур sg
Словакия sk
Словения si
Соломоновы Острова sb
Сомали so
ЮАР za
Южная Георгия и Южные Сандвичевы острова gs
Испания es
Шри-Ланка lk
Судан sd
Суринам sr
Шпицберген и Ян-Майен sj
Свазиленд sz
Швеция se
Швейцария ch
Сирийская Арабская Республика sy
Тайвань, провинция Китая tw
Таджикистан tj
Танзания, Объединенная Республика tz
Таиланд th
Тимор-Лешти tl
Того tg
Токелау tk
Тонга to
Тринидад и Тобаго tt
Тунис tn
Турция tr
Туркменистан tm
Острова Тёркс и Кайкос tc
Тувалу tv
Уганда ug
Украина ua
Объединенные Арабские Эмираты ae
Великобритания uk
Соединенные Штаты us
Малые отдаленные острова США um
Уругвай uy
Узбекистан uz
Вануату vu
Венесуэла ve
Вьетнам vn
Виргинские острова, Британская vg
Виргинские острова, США vi
Уоллис и Футуна wf
Западная Сахара eh
Йемен ye
Замбия zm
Зимбабве zw