Справочные приложения по XML API

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

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

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

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

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

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

Примеры

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


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

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

Примеры

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

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

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


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

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

Примеры

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

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


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

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

Примеры

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

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


Экранирование URL-адреса

Чтобы выполнить поисковый HTTP-запрос, вы должны следовать определенным соглашениям, чтобы Google мог правильно перевести ваш HTTP-запрос и сгенерировать соответствующий ответ.

Схема URL-адреса HTTP указывает, что запрос URL-адреса HTTP может содержать только определенные символы:

  • Буквенно-цифровые символы: (az, AZ, 0–9)
  • Специальные символы: $ - _ . | + ! * ' ( )
  • Зарезервированные символы: ; / ? "="

Google использует зарезервированные символы для декодирования URL-адресов и некоторые специальные символы для запроса функций поиска. Следовательно, вам следует экранировать URL-адресом все небуквенно-цифровые символы, которые встречаются в значениях параметров поиска.

Чтобы URL-адрес экранировал строку, преобразуйте каждую последовательность символов пробелов в один «+» (знак плюс) и замените любые другие небуквенно-цифровые символы шестнадцатеричной кодировкой, которая представляет значение этого символа. Шестнадцатеричные кодировки специальных и зарезервированных символов, перечисленных выше, показаны в следующей таблице. Каждый из этих символов должен быть экранирован URL-адресом в значениях параметров запроса.

Характер Шестнадцатеричный
Кодирование
$ %24
- %2D
_ %5F
. %2E
+ %2Б
! %21
* %2А
" %22
' %27
( %28
) %29
; %3B
/ %2F
? %3F
: %3А
@ %40
"=" %3D
& %26
| %7C

Примеры

Исходная строка URL-адрес с экранированной строкой
Панч и Джуди удар%26Джуди
О'Рейли O%27Рейли

Дополнительную информацию об экранировании URL-адресов можно найти на веб-сайтах W3C и IETF .

Сжатие результатов

Google может сжимать результаты поиска с помощью сжатия HTTP gzip. Если вы сможете распаковать контент, сжатый с помощью алгоритма gzip, вы сможете сэкономить от 50 до 70 процентов пропускной способности, что может улучшить время отклика.

Чтобы запросить Google возвращать результаты в сжатом формате, добавьте заголовок HTTP Accept-Encoding в свой поисковый запрос HTTP следующим образом:

Принимающая кодировка: gzip

Если Google возвращает результаты поиска с использованием сжатия gzip, мы включаем следующую строку в возвращаемые заголовки HTTP:

Кодирование контента: gzip

Примечание. Если HTTP-заголовок Content-Encoding отсутствует в ответе, как показано выше, Google не сжимал результаты.

Такое поведение указано в стандарте HTTP . Пожалуйста, обратитесь к этому документу для получения дополнительной информации об использовании сжатия HTTP gzip.

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

Схемы кодирования символов

В следующей таблице перечислены схемы кодировки символов, поддерживаемые Google. Параметрам ie и oe можно присвоить значения в любом из первых двух столбцов этой таблицы. Значения в первом столбце — это псевдонимы схем кодирования; значения во втором столбце — это стандартные имена схем кодирования. Google возвращает стандартные имена в результатах XML, и эти стандартные имена подходят для использования в заголовках типа контента HTTP вашего документа.

Имя Google Кодирование Связанные поддерживаемые языки
латынь1 ИСО-8859-1 Западноевропейский (каталанский, датский, голландский, английский, финский, французский, немецкий, индонезийский, итальянский, норвежский, португальский, испанский, шведский)
латынь2 ИСО-8859-2 Восточноевропейский (хорватский, чешский, венгерский, польский, румынский, сербский, словацкий, словенский)
латынь3 ИСО-8859-3
латынь4 ИСО-8859-4 Балтийский (эстонский, латышский, литовский)
кириллица ИСО-8859-5 болгарский, русский
арабский ИСО-8859-6
греческий ИСО-8859-7 Греческий
иврит ИСО-8859-8 иврит
латынь5 ИСО-8859-9
латынь6 ИСО-8859-10 исландский
euc-jp EUC-JP Японский
euc-kr EUC-КР Корейский
Сжис Shift_JIS Японский
большой5 Большой5 Традиционный китайский
ГБ ГБ2312 Упрощенный китайский
utf8 UTF-8 Все

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

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

Язык дисплея Значение параметра hl
африкаанс аф
албанский кв.
амхарский являюсь
арабский ар
Армянский хи
азербайджанский аз
Бенгальский млрд
болгарский бг
бирманский мой
каталанский Калифорния
Китайский упрощенный) ж-CN
Китайский традиционный) ж-TW
хорватский час
Чешский CS
датский да
Голландский Нидерланды
английский (Великобритания) ru-GB
Английский ru
эстонский и др.
Филиппинский фил
финский фи
Французский канадец) фр-Калифорния
Французский фр.
грузинский ка
Немецкий де
Греческий эль
Гуджарати гу
иврит я
хинди привет
Венгерский ху
исландский является
индонезийский идентификатор
итальянский это
Японский да
Каннада знать
казахский ок
кхмерский км
Корейский ко
киргизский окей
лаосский вот
Латышский лв
Литовский лт
македонский мк
малайский РС
малаям мл
Маратхи Мистер
Монгольский минута
непальский пе
Норвежский (букмаль) нет
персидский фа
Польский пожалуйста
Португальский (Бразилия) пт-БР
Португальский (Португалия) пт-ПТ
панджаби год
румынский ро
Русский RU
Сербский (латиница) ср-Латн
сербский сэр
сингальский си
словацкий ск
словенский сл
Испанский (Латинская Америка) эс-419
испанский эс
суахили SW
Шведский св
тамильский та
телугу тэ
тайский й
турецкий тр
украинец Великобритания
Урду ты
Узбекский уз
вьетнамский ви
валлийский сай

Значения языковой коллекции

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

Язык lr Значение параметра
арабский lang_ar
болгарский lang_bg
каталанский lang_ca
Китайский упрощенный) lang_zh-CN
Китайский традиционный) lang_zh-TW
хорватский lang_hr
Чешский lang_cs
датский lang_da
Голландский lang_nl
Английский lang_en
эстонский lang_et
финский lang_fi
Французский lang_fr
Немецкий lang_de
Греческий lang_el
иврит lang_iw
Венгерский lang_hu
исландский lang_is
индонезийский lang_id
итальянский lang_it
Японский lang_ja
Корейский lang_ko
Латышский lang_lv
Литовский lang_lt
Норвежский lang_no
Польский lang_pl
португальский lang_pt
румынский lang_ro
Русский lang_ru
сербский lang_sr
словацкий lang_sk
словенский lang_sl
испанский lang_es
Шведский lang_sv
турецкий lang_tr

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

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

Страна Название коллекции стран
Афганистан странаAF
Албания странаAL
Алжир странаDZ
американское Самоа странаAS
Андорра странаAD
Ангола странаAO
Ангилья странаAI
Антарктида странаAQ
Антигуа и Барбуда странаAG
Аргентина странаAR
Армения странаAM
Аруба странаAW
Австралия странаAU
Австрия странаAT
Азербайджан странаAZ
Багамы странаBS
Бахрейн странаBH
Бангладеш странаBD
Барбадос странаBB
Беларусь странаBY
Бельгия странаBE
Белиз странаBZ
Бенин странаБЖ
Бермуды странаBM
Бутан странаBT
Боливия странаBO
Босния и Герцеговина странаBA
Ботсвана странаBW
Остров Буве странаBV
Бразилия странаBR
Британская территория Индийского океана странаIO
Бруней-Даруссалам странаBN
Болгария странаBG
Буркина-Фасо странаBF
Бурунди странаBI
Камбоджа странаKH
Камерун странаCM
Канада странаCA
Кабо-Верде странарезюме
Каймановы острова странаКентукки
Центрально-Африканская Республика странаCF
Чад странаTD
Чили странаCL
Китай странаCN
Остров Рождества странаCX
Кокосовые острова (Килинг) странаCC
Колумбия странаCO
Коморские Острова странаКМ
Конго странаCG
Конго, Демократическая Республика странаCD
Острова Кука странаCK
Коста-Рика странаCR
Берег Слоновой Кости странаCI
Хорватия (Хрватска) странаHR
Куба странаCU
Кипр странаCY
Чешская Республика странаCZ
Дания странаDK
Джибути кантридиджей
Доминика странаDM
Доминиканская Республика странаDO
Восточный Тимор странаTP
Эквадор странаEC
Египет странаEG
Сальвадор странаSV
Экваториальная Гвинея странаGQ
Эритрея странаER
Эстония странаEE
Эфиопия странаET
Евросоюз странаЕС
Фолклендские острова (Мальвинские острова) странаFK
Фарерские острова странаFO
Фиджи странаFJ
Финляндия странаFI
Франция странаFR
Франция, Метрополитен странаFX
Французская Гвиана странаGF
Французская Полинезия странаPF
Южные Французские Территории странаTF
Габон странаGA
Гамбия странаGM
Грузия странаGE
Германия странаDE
Гана странаGH
Гибралтар странаGI
Греция странаGR
Гренландия странаGL
Гренада странаGD
Гваделупа странаGP
Гуам странаГУ
Гватемала странаGT
Гвинея странаGN
Гвинея-Бисау странаGW
Гайана странаGY
Гаити странаHT
Остров Херд и острова Макдональда странаHM
Святой Престол (государство-город Ватикан) странаVA
Гондурас странаHN
Гонконг странаHK
Венгрия странаHU
Исландия странаIS
Индия странаВ
Индонезия идентификатор страны
Иран, Исламская Республика странаIR
Ирак странаIQ
Ирландия странаIE
Израиль странаIL
Италия странаИТ
Ямайка странаJM
Япония странаJP
Иордания странаJO
Казахстан странаKZ
Кения странаKE
Кирибати странаКИ
Корея, Народно-Демократическая Республика странаКП
Корея, Республика странаKR
Кувейт странаKW
Кыргызстан странаКГ
Лаосская Народно-Демократическая Республика странаLA
Латвия странаLV
Ливан странаLB
Лесото странаLS
Либерия странаLR
Ливийская арабская джамахирия странаЛИ
Лихтенштейн странаLI
Литва странаLT
Люксембург странаLU
Макао странаМО
Македония, бывшая Югославская Республика странаМК
Мадагаскар странаMG
Малави странаMW
Малайзия странаМОЯ
Мальдивы странаМВ
Мали странаML
Мальта странаMT
Маршалловы острова странаMH
Мартиника странаMQ
Мавритания странаMR
Маврикий странаMU
Майотта странаYT
Мексика странаMX
Микронезия, Федеративные Штаты странаFM
Молдова, Республика странаMD
Монако странаMC
Монголия странаMN
Монтсеррат странаMS
Марокко странаMA
Мозамбик странаМЗ
Мьянма странаММ
Намибия странаNA
Науру странаNR
Непал странаNP
Нидерланды странаNL
Нидерландские Антильские острова странаAN
Новая Каледония странаNC
Новая Зеландия странаНовая Зеландия
Никарагуа странаNI
Нигер странаNE
Нигерия странаNG
Ниуэ странаНУ
Остров Норфолк странаNF
Северные Марианские острова странадепутат
Норвегия странаНЕТ
Оман странаOM
Пакистан странаПК
Палау странаPW
Палестинская территория странаPS
Панама страна Пенсильвания
Папуа - Новая Гвинея странаPG
Парагвай странаPY
Перу странаPE
Филиппины странаPH
Питкэрн странаPN
Польша странаPL
Португалия странаPT
Пуэрто-Рико странаPR
Катар странаQA
Воссоединение странаRE
Румыния странаРО
Российская Федерация странаRU
Руанда странаRW
Остров Святой Елены странаSH
Сент-Китс и Невис странаKN
Санкт-Люсия странаLC
Сен-Пьер и Микелон странаPM
Святой Винсент и Гренадины странаVC
Самоа странаWS
Сан-Марино странаSM
Сан-Томе и Принсипи странаST
Саудовская Аравия странаSA
Сенегал странаSN
Сербия и Черногория странаCS
Сейшельские острова странаSC
Сьерра-Леоне странаSL
Сингапур странаSG
Словакия странаСК
Словения странаSI
Соломоновы острова странаSB
Сомали странаSO
Южная Африка странаZA
Южная Георгия и Южные Сандвичевы острова странаGS
Испания странаES
Шри-Ланка странаLK
Судан странаSD
Суринам странаSR
Шпицберген и Ян-Майен странаSJ
Свазиленд странаSZ
Швеция странаSE
Швейцария странаCH
Сирийская Арабская Республика странаSY
Тайвань, провинция Китая странаTW
Таджикистан странаTJ
Танзания, Объединенная Республика странаTZ
Таиланд странаTH
Идти странаTG
Токелау странаТК
Тонга странаТО
Тринидад и Тобаго странаTT
Тунис странаTN
Турция странаTR
Туркменистан странаТМ
Острова Тёркс и Кайкос странаTC
Тувалу странаТВ
Уганда странаUG
Украина странаUA
Объединенные Арабские Эмираты странаAE
Великобритания странаВеликобритания
Соединенные Штаты странаСША
Малые отдаленные острова США странаUM
Уругвай странаUY
Узбекистан странаУЗ
Вануату странаVU
Венесуэла странаVE
Вьетнам странаVN
Виргинские острова, Британская странаVG
Виргинские острова, США странаVI
Уоллис и Футуна странаWF
Западная Сахара странаEH
Йемен странаYE
Югославия странаYU
Замбия странаZM
Зимбабве странаZW

Коды стран

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

Страна Код страны
Афганистан аф
Албания аль
Алжир дз
американское Самоа как
Андорра объявление
Ангола ао
Ангилья ай
Антарктида ак
Антигуа и Барбуда аг
Аргентина ар
Армения являюсь
Аруба оу
Австралия ау
Австрия в
Азербайджан аз
Багамы бс
Бахрейн чб
Бангладеш др.
Барбадос бб
Беларусь к
Бельгия быть
Белиз бз
Бенин минет
Бермуды бм
Бутан БТ
Боливия бо
Босния и Герцеговина ба
Ботсвана чб
Остров Буве бв
Бразилия бр
Британская территория Индийского океана ио
Бруней-Даруссалам млрд
Болгария бг
Буркина-Фасо парень
Бурунди би
Камбоджа х
Камерун см
Канада Калифорния
Кабо-Верде резюме
Каймановы острова окей
Центрально-Африканская Республика см.
Чад ТД
Чили кл
Китай CN
Остров Рождества сх
Кокосовые острова (Килинг) копия
Колумбия со
Коморские Острова км
Конго cg
Конго, Демократическая Республика CD
Острова Кука ск
Коста-Рика кр
Берег Слоновой Кости ци
Хорватия час
Куба у.е.
Кипр сай
Чешская Республика чешский
Дания дк
Джибути диджей
Доминика дм
Доминиканская Республика делать
Эквадор ЕС
Египет например
Сальвадор св
Экваториальная Гвинея gq
Эритрея эээ
Эстония эээ
Эфиопия и др.
Фолклендские острова (Мальвинские острова) хз
Фарерские острова фо
Фиджи фджей
Финляндия фи
Франция фр.
Французская Гвиана подруга
Французская Полинезия пф
Южные Французские Территории ТС
Габон га
Гамбия гм
Грузия ге
Германия де
Гана хх
Гибралтар ги
Греция гр
Гренландия гл
Гренада Боже
Гваделупа врач
Гуам гу
Гватемала гт
Гвинея гн
Гвинея-Бисау гв
Гайана гы
Гаити хт
Остров Херд и острова Макдональда хм
Святой Престол (государство-город Ватикан) ва
Гондурас хн
Гонконг хк
Венгрия ху
Исландия является
Индия в
Индонезия идентификатор
Иран, Исламская Республика ИК
Ирак iq
Ирландия т.е.
Израиль иль
Италия это
Ямайка Джейм
Япония Япония
Иордания Джо
Казахстан КЗ
Кения ке
Кирибати ки
Корея, Народно-Демократическая Республика КП
Корея, Республика кр
Кувейт кВт
Кыргызстан кг
Лаосская Народно-Демократическая Республика ла
Латвия лв
Ливан фунт
Лесото лс
Либерия лр
Ливийская арабская джамахирия ли
Лихтенштейн ли
Литва лт
Люксембург Лу
Макао мес.
Македония, бывшая Югославская Республика мк
Мадагаскар мг
Малави МВт
Малайзия мой
Мальдивы МВ
Мали мл
Мальта тонна
Маршалловы острова мх
Мартиника кв.м.
Мавритания Мистер
Маврикий му
Майотта да
Мексика мх
Микронезия, Федеративные Штаты фм
Молдова, Республика Мэриленд
Монако MC
Монголия минута
Монтсеррат РС
Марокко ма
Мозамбик мз
Мьянма мм
Намибия нет
Науру номер
Непал НП
Нидерланды Нидерланды
Нидерландские Антильские острова а
Новая Каледония NC
Новая Зеландия Новая Зеландия
Никарагуа нет
Нигер пе
Нигерия нг
Ниуэ ну
Остров Норфолк нф
Северные Марианские острова депутат
Норвегия нет
Оман ом
Пакистан ПК
Палау пш
Палестинская территория, оккупированная пс
Панама год
Папуа - Новая Гвинея стр.
Парагвай пи
Перу пе
Филиппины тел.
Питкэрн пн
Польша пожалуйста
Португалия пт
Пуэрто-Рико пиар
Катар ка
Воссоединение ре
Румыния ро
Российская Федерация RU
Руанда RW
Остров Святой Елены ш
Сент-Китс и Невис знать
Санкт-Люсия ЖК
Сен-Пьер и Микелон вечера
Святой Винсент и Гренадины ВК
Самоа WS
Сан-Марино см
Сан-Томе и Принсипи ул.
Саудовская Аравия са
Сенегал зп
Сербия и Черногория CS
Сейшельские острова СК
Сьерра-Леоне сл
Сингапур сг
Словакия ск
Словения си
Соломоновы острова сб
Сомали так
Южная Африка за
Южная Георгия и Южные Сандвичевы острова гс
Испания эс
Шри-Ланка лк
Судан SD
Суринам сэр
Шпицберген и Ян-Майен сж
Свазиленд сз
Швеция видишь
Швейцария ч
Сирийская Арабская Республика си
Тайвань, провинция Китая дважды
Таджикистан тиджей
Танзания, Объединенная Республика тс
Таиланд й
Тимор-Лешти ТЛ
Идти тг
Токелау ТС
Тонга к
Тринидад и Тобаго тт
Тунис ТН
Турция тр
Туркменистан тм
Острова Тёркс и Кайкос ТК
Тувалу ТВ
Уганда тьфу
Украина ua
Объединенные Арабские Эмираты ае
Великобритания Великобритания
Соединенные Штаты нас
Малые отдаленные острова США хм
Уругвай ууу
Узбекистан уз
Вануату вю
Венесуэла ве
Вьетнам вн
Виргинские острова, Британская вг
Виргинские острова, США ви
Уоллис и Футуна ВФ
Западная Сахара ага
Йемен вы
Замбия зм
Зимбабве zw