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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Логические операторы

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

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

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

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

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

Примеры

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


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

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

Примеры

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

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

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


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

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

Примеры

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

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


Булевы скобки [()]
Описание

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

Примеры

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

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


Экранирование URL

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

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

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

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

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

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

Примеры

Исходная строка Экранированная строка URL
панч и джуди пунш% 26judy
О'Рейли 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 Content-type вашего документа.

Имя 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-кр ЭУК-КР Корейский
сжи Shift_JIS Японский
большая пятерка Большая5 Традиционный китайский
ГБ ГБ2312 Упрощенный китайский
utf8 UTF-8 Все

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

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

Язык дисплея hl Значение параметра
африкаанс аф
албанский кв
амхарский см
арабский ар
Азербайджанский аз
баскский Европа
белорусский быть
бенгальский млрд
Бихари чч
боснийский бс
болгарский бг
Каталонский ок
Китайский упрощенный) ж-CN
Китайский традиционный) ж-ТВ
хорватский час
чешский язык cs
датский да
Голландский нл
Английский en
эсперанто Эо
эстонский эт
Фарерский для
финский фи
Французский фр
фризский фу
галисийский гл
грузинский ка
Немецкий де
греческий Эль
Гуджарати гу
иврит я
хинди Здравствуй
венгерский язык Ху
исландский является
индонезийский я бы
Интерлингва я
ирландский Га
итальянский Это
Японский да
яванский джв
каннада знать
Корейский ко
латинский ля
Латышский lv
Литовский л
македонский тк
малайский РС
малаям мл
Мальтийский метр
маратхи г-н
непальский пе
Норвежский нет
Норвежский (нюнорск) нн
окситанский ос
персидский фа
польский пл
Португальский (Бразилия) пт-BR
Португальский (Португалия) пт-пт
панджаби па
румынский Ро
Русский RU
шотландский гэльский гд
сербский старший
сингальский си
словацкий ск
словенский сл
испанский эс
суданский су
суахили 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
Ангола странаАО
Ангилья страна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
Коморы странаКМ
Конго странаCG
Конго, Демократическая Республика странаCD
Острова Кука странаCK
Коста-Рика странаCR
Берег Слоновой Кости странаCI
Хорватия (Хрватска) странаHR
Куба странаCU
Кипр странаCY
Чешская Республика странаCZ
Дания странаDK
Джибути странаDJ
Доминика странаDM
Доминиканская Респблика странаDO
Восточный Тимор странаTP
Эквадор странаEC
Египет странаEG
Эль Сальвадор странаSV
Экваториальная Гвинея странаGQ
Эритрея странаER
Эстония странаEE
Эфиопия странаET
Европейский Союз странаEU
Фолклендские (Мальвинские) острова странаFK
Фарерские острова странаFO
Фиджи странаFJ
Финляндия странаFI
Франция странаFR
Франция, митрополит странаFX
Французская Гвиана страна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
Индонезия идентификатор страны
Иран, Исламская Республика странаIR
Ирак странаIQ
Ирландия странаIE
Израиль странаIL
Италия странаIT
Ямайка странаJM
Япония странаJP
Иордания странаJO
Казахстан странаKZ
Кения странаKE
Кирибати странаKI
Корея, Народно-Демократическая Республика странаKP
Корея, Республика странаKR
Кувейт странаKW
Кыргызстан странаKG
Лаосская Народно-Демократическая Республика странаLA
Латвия странаLV
Ливан странаLB
Лесото странаLS
Либерия странаLR
Ливийская арабская джамахирия страна
Лихтенштейн странаLI
Литва странаLT
Люксембург странаLU
Макао странаMO
Македония, бывшая югославская республика странаMK
Мадагаскар странаMG
Малави странаМВт
Малайзия странаMY
Мальдивы странаMV
Мали странаML
Мальта странаMT
Маршалловы острова странаMH
Мартиника странаMQ
Мавритания странаMR
Маврикий странаMU
Майотта странаYT
Мексика странаMX
Микронезия, Федеративные Штаты странаFM
Молдова, Республика странаMD
Монако странаMC
Монголия странаMN
Монтсеррат странаMS
Марокко странаMA
Мозамбик странаМЗ
Мьянма странаММ
Намибия странаNA
Науру странаNR
Непал странаНП
Нидерланды странаNL
Нидерландские Антильские острова странаAN
Новая Каледония странаNC
Новая Зеландия странаNZ
Никарагуа странаNI
Нигер странаNE
Нигерия странаNG
Ниуэ странаNU
Остров Норфолк странаNF
Северные Марианские острова странадепутат
Норвегия странаНЕТ
Оман страна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
Идти странаTG
Токелау странаТК
Тонга странаTO
Тринидад и Тобаго странаTT
Тунис странаTN
Турция странаTR
Туркменистан странаТМ
острова Теркс и Кайкос странаTC
Тувалу странаТВ
Уганда странаUG
Украина странаUA
Объединенные Арабские Эмираты странаAE
Соединенное Королевство странаВеликобритания
Соединенные Штаты странаСША
Малые отдаленные острова США странаUM
Уругвай странаUY
Узбекистан странаUZ
Вануату странаVU
Венесуэла странаVE
Вьетнам странаVN
Виргинские острова, Британские странаVG
Виргинские острова, США страна VI
Уоллис и Футуна странаWF
Западная Сахара странаEH
Йемен странаYE
Югославия странаYU
Замбия странаZM
Зимбабве странаZW

Коды стран

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

Страна Код страны
Афганистан аф
Албания все
Алжир дз
американское Самоа в качестве
Андорра объявление
Ангола АО
Ангилья ай
Антарктида вода
Антигуа и Барбуда аг
Аргентина ар
Армения являюсь
Аруба оу
Австралия ау
Австрия в
Азербайджан аз
Багамы бс
Бахрейн чч
Бангладеш бд
Барбадос бб
Беларусь по
Бельгия быть
Белиз бз
Бенин минет
Бермуды бм
Бутан бт
Боливия бо
Босния и Герцеговина ба
Ботсвана чб
Остров Буве бв
Бразилия бр
Британская территория Индийского океана ио
Бруней-Даруссалам млрд
Болгария бг
Буркина-Фасо бойфренд
Бурунди би
Камбоджа кх
Камерун см
Канада ок
Кабо-Верде резюме
Каймановы острова ку
Центрально-Африканская Республика ср
Чад тд
Чили кл
Китай Сп
Остров Рождества сх
Кокосовые (Килинг) острова копия
Колумбия со
Коморы км
Конго сг
Конго, Демократическая Республика CD
Острова Кука ск
Коста-Рика кр
Берег Слоновой Кости си
Хорватия час
Куба у.е.
Кипр су
Чешская Республика cz
Дания дк
Джибути диджей
Доминика дм
Доминиканская Респблика делать
Эквадор эк
Египет например
Эль Сальвадор св
Экваториальная Гвинея gq
Эритрея э
Эстония эээ
Эфиопия эт
Фолклендские (Мальвинские) острова фк
Фарерские острова для
Фиджи фдж
Финляндия фи
Франция фр
Французская Гвиана девушка
Французская Полинезия пф
Южные Французские Территории тф
Габон Га
Гамбия гм
Грузия гэ
Германия де
Гана гх
Гибралтар ги
Греция гр
Гренландия гл
Гренада гд
Гваделупа gp
Гуам гу
Гватемала гт
Гвинея gn
Гвинея-Бисау гв
Гайана гы
Гаити хт
Остров Херд и острова Макдональдс хм
Святой Престол (город-государство Ватикан) ва
Гондурас хн
Гонконг хк
Венгрия Ху
Исландия является
Индия в
Индонезия я бы
Иран, Исламская Республика ир
Ирак iq
Ирландия то есть
Израиль иль
Италия Это
Ямайка джм
Япония джп
Иордания Джо
Казахстан кз
Кения ке
Кирибати ки
Корея, Народно-Демократическая Республика кп
Корея, Республика кр
Кувейт кВт
Кыргызстан кг
Лаосская Народно-Демократическая Республика ля
Латвия lv
Ливан фунт
Лесото лс
Либерия Лр
Ливийская арабская джамахирия лы
Лихтенштейн ли
Литва л
Люксембург Лу
Макао мо
Македония, бывшая югославская республика тк
Мадагаскар мг
Малави мв
Малайзия мой
Мальдивы мв
Мали мл
Мальта метр
Маршалловы острова мч
Мартиника кв.м.
Мавритания г-н
Маврикий мю
Майотта йт
Мексика МХ
Микронезия, Федеративные Штаты фм
Молдова, Республика Мэриленд
Монако МС
Монголия мн
Монтсеррат РС
Марокко мама
Мозамбик мз
Мьянма мм
Намибия нет
Науру номер
Непал нп
Нидерланды нл
Нидерландские Антильские острова ан
Новая Каледония нк
Новая Зеландия новозеландский
Никарагуа ни
Нигер пе
Нигерия нг
Ниуэ ню
Остров Норфолк нф
Северные Марианские острова член парламента
Норвегия нет
Оман ом
Пакистан ПК
Палау pw
Палестинская территория, оккупированная PS
Панама па
Папуа - Новая Гвинея пг
Парагвай пи
Перу ре
Филиппины ф
Питкэрн пн
Польша пл
Португалия пт
Пуэрто-Рико пр
Катар ка
Воссоединение ре
Румыния Ро
Российская Федерация RU
Руанда RW
Святая Елена ш
Сент-Китс и Невис знать
Сент-Люсия ЖК
Сен-Пьер и Микелон вечера
Святой Винсент и Гренадины вк
Самоа ws
Сан-Марино см
Сан-Томе и Принсипи ул.
Саудовская Аравия са
Сенегал sn
Сербия и Черногория cs
Сейшелы СК
Сьерра-Леоне сл
Сингапур сг
Словакия ск
Словения си
Соломоновы острова сб
Сомали так
Южная Африка за
Южная Георгия и Южные Сандвичевы острова гс
Испания эс
Шри-Ланка лк
Судан сд
Суринам старший
Шпицберген и Ян-Майен СЖ
Свазиленд сз
Швеция се
Швейцария ч
Сирийская Арабская Республика си
Тайвань, провинция Китая тв
Таджикистан тж
Танзания, Объединенная Республика тз
Таиланд й
Тимор-Лешти тл
Идти тг
Токелау тк
Тонга к
Тринидад и Тобаго тт
Тунис тн
Турция тр
Туркменистан тм
острова Теркс и Кайкос тк
Тувалу Телевизор
Уганда уг
Украина уа
Объединенные Арабские Эмираты э
Соединенное Королевство Великобритания
Соединенные Штаты нас
Малые отдаленные острова США гм
Уругвай уй
Узбекистан уз
Вануату ву
Венесуэла ве
Вьетнам вн
Виргинские острова, Британские вг
Виргинские острова, США ви
Уоллис и Футуна вф
Западная Сахара э
Йемен вы
Замбия зм
Зимбабве zw