Справочник XML-API

Эта страница относится к XML-версии API JSON пользовательского поиска, которая доступна только клиентам Google Site Search .

1. Обзор
2. Формат запроса программируемой поисковой системы
   1. Обзор запроса
   2. Условия запроса
   3. Параметры запроса
      1. Примеры запросов веб-поиска
      2. Определения параметров запроса WebSearch
      3. Расширенный поиск
      4. Параметры расширенного поискового запроса
      5. Специальные условия запроса
      6. Примеры запросов изображений
      7. Параметры запроса поиска изображений
      8. Ограничения запросов
   4. Интернационализация запросов и представление результатов
      1. Кодировка символов
      2. Языки интерфейса
      3. Упрощенный и традиционный китайский поиск
   5. Фильтрация результатов
      1. Автоматическая фильтрация результатов поиска
      2. Фильтрация по языку и стране
      3. Фильтрация контента для взрослых с помощью Безопасного поиска
3. Результаты XML
   1. DTD результатов Google XML
   2. Об ответе XML
   3. Результаты XML для обычных, графических и расширенных поисковых запросов
      1. Обычный/расширенный поиск: пример запроса и результат XML
      2. Обычный/расширенный поиск: XML-теги
      3. XML-результаты для поисковых запросов изображений
      4. Поиск изображений: пример запроса и результат XML
      5. Поиск изображений: XML-теги

Обзор

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

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

Формат запроса веб-поиска

• Обзор запроса
• Условия запроса
• Параметры запроса
• Примеры запросов веб-поиска
• Определения параметров запроса WebSearch
• Примеры запросов изображений
• Определения параметров запроса поиска изображений
• Расширенный поиск
  
• Параметры расширенного поискового запроса
• Специальные условия запроса
• Ограничения запросов

Обзор запроса

Поисковый запрос Google представляет собой стандартную команду HTTP GET . Он включает в себя набор параметров, соответствующих вашим запросам. Эти параметры включаются в URL-адрес запроса в виде пар имя=значение, разделенных символами амперсанда (&). Параметры включают в себя такие данные, как поисковый запрос и уникальный идентификатор механизма ( cx ), который идентифицирует механизм, отправляющий HTTP-запрос. Служба веб-поиска или поиска изображений возвращает результаты XML в ответ на ваши HTTP-запросы.

Условия запроса

Большинство поисковых запросов включают одно или несколько условий запроса. Термин запроса отображается как значение параметра в поисковом запросе.

Условия запроса могут указывать несколько типов информации для фильтрации и систематизации результатов поиска, возвращаемых Google. В запросах можно указать:

• Слова или фразы, которые нужно включить или исключить
  • Все слова в поисковом запросе (по умолчанию)
  • Точная фраза в поисковом запросе
  • Любое слово или фраза в поисковом запросе
• Где в документе искать условия поиска
  • В любом месте документа (по умолчанию)
  • Только в теле документа
  • Только в заголовке документа
  • Только в URL документа
  • Только в ссылках в документе
• Ограничения на сами документы
  • Включение или исключение документов определенных типов файлов (например, файлов PDF или документов Word).
• Специальные URL-запросы , которые возвращают информацию о данном URL-адресе, а не выполняют поиск.
  • Запросы, возвращающие общую информацию об URL-адресе, например его категорию Open Directory, фрагмент или язык.
  • Запросы, возвращающие набор веб-страниц, ссылающихся на URL-адрес.
  • Запросы, возвращающие набор веб-страниц, похожих на заданный URL-адрес.

Поиск по умолчанию

Значения параметров поискового запроса должны быть экранированы URL-адресом. Обратите внимание, что вы должны заменить знак плюса («+») на любые последовательности пробелов в поисковом запросе. Это обсуждается далее в разделе «Эскейпирование URL-адресов» этого документа.

Термин поискового запроса передается в службу WebSearch с использованием параметра q . Пример условия поискового запроса:

q=horses+cows+pigs

По умолчанию служба Google WebSearch возвращает только те документы, которые включают все термины поискового запроса.

Параметры запроса

В этом разделе перечислены параметры, которые вы можете использовать при создании поискового запроса. Параметры разделены на два списка. Первый список содержит параметры, релевантные всем поисковым запросам. Второй список содержит параметры, относящиеся только к запросам расширенного поиска.

Требуются три параметра запроса:

• Параметр клиента должен иметь значение google-csbe
• Выходной параметр определяет формат возвращаемых результатов XML; результаты могут быть возвращены с (xml) или без ( xml_no_dtd ) ссылки на Google DTD. Мы рекомендуем установить для этого значения xml_no_dtd . Примечание. Если вы не укажете этот параметр, результаты будут возвращены в формате HTML вместо XML.
  
• Параметр cx , представляющий уникальный идентификатор механизма.
  

Наиболее часто используемые параметры запроса, кроме упомянутых выше:

• num — запрошенное количество результатов поиска
• q — поисковый запрос(ы)
• start — начальный индекс результатов

Примеры запросов веб-поиска

В примерах ниже показано несколько HTTP-запросов WebSearch, чтобы проиллюстрировать, как используются различные параметры запроса. Определения различных параметров запроса представлены в разделах «Определения параметров запроса WebSearch» и «Параметры запроса расширенного поиска» этого документа.

Этот запрос запрашивает первые 10 результатов ( start=0&num=10 ) для термина запроса «red sox» ( q=red+sox ). Запрос также указывает, что результаты должны поступать с канадских веб-сайтов ( cr=countryCA ) и быть написаны на французском языке ( lr=lang_fr ). Наконец, в запросе указываются значения параметров client , output и cx , все три из которых являются обязательными.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

В этом примере используются некоторые параметры расширенного поискового запроса для дальнейшей настройки поискового запроса. Этот запрос использует параметр as_q ( as_q=red+sox ) вместо параметра q . Он также использует параметр as_eq для исключения любых документов, содержащих слово «Янкиз», из результатов поиска ( as_eq=yankees ).

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i  

Определения параметров запроса WebSearch

    <!DOCTYPE GSP SYSTEM "google.dtd">

Расширенный поиск

Дополнительные параметры запроса, перечисленные под изображением, относятся к расширенным поисковым запросам. Когда вы отправляете расширенный поиск, значения нескольких параметров (например, as_eq , as_epq , as_oq и т. д.) учитываются в терминах запроса для этого поиска. На изображении показана страница расширенного поиска Google. На изображении имя каждого параметра расширенного поиска написано красным текстом внутри или рядом с полем на странице, которому соответствует этот параметр.

Параметры расширенного поискового запроса

Специальные условия запроса

Google WebSearch позволяет использовать несколько специальных условий запроса, которые получают доступ к дополнительным возможностям поисковой системы Google. Эти специальные термины запроса должны быть включены в значение параметра запроса q . Как и другие условия запроса, специальные условия запроса должны быть экранированы URL-адресом . Некоторые специальные термины запроса содержат двоеточие (:). Этот символ также должен быть экранирован URL-адресом; его значение с экранированием URL-адреса — %3A .

Примеры запросов изображений

В примерах ниже показано несколько HTTP-запросов изображений, чтобы проиллюстрировать, как используются различные параметры запроса. Определения различных параметров запроса представлены в разделах «Определения параметров запроса изображения» этого документа.

Этот запрос запрашивает первые 5 результатов ( start=0&num=5 ) для термина запроса «monkey» ( q=monkey ) с типом файла .png. Наконец, в запросе указываются значения параметров client , output и cx , все три из которых являются обязательными.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Параметры запроса поиска изображений

Ограничения запросов

В таблице ниже перечислены ограничения на поисковые запросы, которые вы отправляете в Google:

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

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

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

• Кодировка символов
• Языки интерфейса
• Упрощенный и традиционный китайский поиск

Кодировка символов

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

Вы можете использовать параметр запроса ie , чтобы указать механизм кодирования символов в вашем HTTP-запросе. Вы также можете использовать параметр oe , чтобы указать схему кодирования, которую Google должен использовать для кодирования вашего ответа XML. Если вы используете схему кодирования, отличную от ISO-8859-1 (или latin1 ), убедитесь, что вы указали правильные значения для параметров ie и oe .

Примечание. Если вы предоставляете функцию поиска для нескольких языков, мы рекомендуем использовать значение кодировки utf8 (UTF-8) как для параметров ie , так и для oe .

Полный список значений, которые можно использовать для параметров ie и oe , см. в приложении «Схемы кодировки символов» .

Более общую информацию о кодировке символов см. на странице http://www.w3.org/TR/REC-html40/charset.html .

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

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

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

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

Поиск документов, написанных на определенных языках

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

Параметр LR поддерживает логические операторы , чтобы позволить вам указать несколько языков, которые должны быть включены (или исключены) из результатов поиска.

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

Для документов, написанных на японском:

lr=lang_jp

Для документов, написанных на итальянском или немецком языке:

lr=lang_it|lang_de

Для документов, не написанных в венгерском или чешском:

lr=(-lang_hu).(-lang_cs)

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

Упрощенный и традиционный китайский поиск

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

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

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 предоставляет ряд способов фильтрации результатов вашего поиска:

• Автоматическая фильтрация результатов поиска
• Фильтрация языка и страны
• Фильтрация контента для взрослых с помощью Safesearch

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

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

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

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

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

Фильтрация языка и страны

Служба Google Websearch возвращает результаты из главного индекса всех веб -документов. Мастер -индекс содержит подколлекции документов, которые сгруппированы по конкретным атрибутам, включая язык и страну происхождения.

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

Google Websearch определяет язык документа, анализируя:

• Домен верхнего уровня (TLD) URL-адреса документа
• Языковые метатеги в документе
• Основной язык, используемый в тексте тела документа

Пожалуйста, также см. Определение параметра LR , раздел о поиске документов, написанных на определенных языках , и значения сбора языка , которые можно использовать в качестве значений для параметра LR для получения дополнительной информации об ограничении результатов на основе языка.

Google Websearch определяет страну документа, анализируя:

• Домен верхнего уровня (TLD) URL-адреса документа
• Географическое местоположение IP -адреса веб -сервера

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

Примечание. Вы можете объединить языковые ценности и ценности страны, чтобы настроить результаты поиска. Например, вы можете запросить документы, написанные на французском языке и приехать из Франции или Канады, или вы можете запросить документы, которые поступают из Голландии и не написаны на английском языке. Параметры LR и CR поддерживают логические операторы .

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

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

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

SafeSearch доступен на следующих языках:

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

Если у вас активирован SafeSearch и вы найдете сайты, которые содержат оскорбительный контент в ваших результатах, пожалуйста, напишите URL -адрес сайта по адресу safesearch@google.com , и мы расследуем сайт.

Результаты XML

• Google XML -результаты DTD
• О ответе XML
• Результаты XML для регулярных и расширенных поисковых запросов
• Регулярный/расширенный поиск: примеры запроса и XML -результат
• Обычный/расширенный поиск: теги XML

Google XML -результаты DTD

Google использует один и тот же DTD для описания формата XML для всех типов результатов поиска. Многие из тегов и атрибутов применимы для всех типов поиска. Некоторые теги, однако, применимы только для определенных типов поиска. Следовательно, определения в DTD могут быть менее ограничительными, чем определения, приведенные в этом документе.

В этом документе описываются те аспекты DTD, которые имеют отношение к веб -исследованиям. Когда вы смотрите на DTD, если вы работаете над веб -исследователь, вы можете безопасно игнорировать теги и атрибуты, которые здесь не задокументированы. Если определение отличается между DTD и документацией, этот факт отмечается в этом документе.

Google может вернуть результаты XML с или без ссылки на самый последний DTD. DTD - это руководство, которое поможет поисковым администраторам и анализаторам XML понять результаты XML Google. Поскольку грамматика XML от Google может время от времени меняться, вы не должны настраивать свой анализатор для использования DTD для проверки каждого результата XML.

Кроме того, вы не должны настраивать свой анализатор XML, чтобы приносить DTD каждый раз, когда вы отправляете запрос на поиск. Google обновляет DTD нечасто, и эти запросы создают ненужные требования задержки и пропускной способности.

Google рекомендует использовать выходной формат xml_no_dtd, чтобы получить результаты XML. Если вы указали формат вывода XML в своем запросе поиска, единственная отличие - включение следующей строки в результаты XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Вы можете получить доступ к последнему DTD по адресу http://www.google.com/google.dtd .

Обратите внимание, что не все функции в DTD могут быть доступны или поддерживаются в настоящее время.

О ответе XML

• Все значения элементов действительны HTML, подходящие для отображения, если не указано иное в определениях тегов XML.
• Некоторые значения элементов-это URL-адреса, которые должны быть кодированы HTML, прежде чем они будут отображаться.
• Ваш анализатор XML должен игнорировать недокументированные атрибуты и теги. Это позволяет вашему приложению продолжать работать без модификации, если Google добавляет больше функций к выводу XML.
• Определенные символы должны быть сбежаны при включении в качестве значений в теги XML. Ваш процессор XML должен преобразовать эти сущности обратно в соответствующие символы. Если вы не преобразуете объекты должным образом, браузер может, например, сделать и характер как «& amp;». Стандартный XML документирует эти символы; Эти символы воспроизведены в таблице ниже:

  Характер	Сбежали формы	Сущность	Код символа
  Амперсанд	&	&	&
  Единственная цитата	'	& apos;	'
  Двойная цитата	"	"	"
  Больше, чем	>	>	>
  Меньше, чем	<	& lt;	&#60;

Результаты XML для регулярных и расширенных поисковых запросов

Регулярный/расширенный поиск: примеры запроса и XML -результат

В этом примере запроса на веб -исследователь требуется 10 результатов ( num=10 ) о поисковом термине «Socer» ( q=socer ), которое является словом «футбол», намеренно написано неправильно для этого примера.)

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i 

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

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

Обычный/расширенный поиск: теги XML

Ответы XML для регулярных запросов поиска и расширенных запросов поиска используют один и тот же набор тегов XML. Эти теги XML показаны в примере XML выше и объяснены в таблицах ниже.

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

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

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

Результаты XML для запросов поиска изображения

Этот образец запроса изображения запрашивает 5 результатов (num = 5) о термине поиска «Обезьяна» (Q = обезьяна).

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Этот запрос дает результат XML ниже.

G<SP VER="3.2"
>  T<M0>.395037/<TM
>  Q<m>onkeys/<Q
>
  P<ARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_e<scaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/
>  P<ARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/
>  P<ARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/
>  P<ARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/
>  P<ARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/
>  P<ARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/
>  P<ARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/
>  P<ARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/
>  P<ARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/
>  P<ARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/
>
  C<ontext
>    t<itled>omestigeek/<title
>  /<Context
>
  A<RES/
>  R<ES SN="1" EN="2"
>    M<2>500000/<M
>    N<B
>      N<U/>images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      /<NU
>    /<NB
>    R<G START="1" SIZE="2"/
>      R< N="1" MIME="image/jpeg"
>        R<Uh>ttp://www.flickr.com/photos/fncll/135465558//<RU
>        U<
>          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        /<U
>        U<E
>          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        /<UE
>        T<C>omputer b<M>onkeys/<b >| Flickr - Photo Sharing!/<T
>        R<K0>/<RK
>        B<YLINEDATE1>146034800/<BYLINEDATE
>        S<C>omputer b<M>onkeys/<b >| Flickr/<S
>        L<ANGe>n/<LANG
>        I<MG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"
>          S<Z8>8386/<SZ
>          I<N/
>        /<IMG
>        T<BN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/
>      /<R
>      R< N="2" MIME="image/jpeg"
>        R<U
>          http://www.flickr.com/photos/flickerbulb/187044366/
        /<RU
>        U<
>          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        /<U
>        U<E
>          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        /<UE
>        T<
>          one. ugly. b<m>onkey/<b.> | Flickr - Photo Sharing!
        /<T
>        R<K0>/<RK
>        B<YLINEDATE1>152514800/<BYLINEDATE
>        S<o>ne. ugly. b<m>onkey/<b.>/<S
>        L<ANGe>n/<LANG
>        I<MG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"S><Z5>8339/<SZ
>          I<N/
>        /<IMG
>        T<BN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/
>      /<R
>  /<RES
>/<GSP
>

Поиск изображения: теги XML

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

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

Эта страница относится к XML -версии пользовательского поиска JSON API, которая доступна только для клиентов Google Search .

1. Обзор
2. Программируемый формат запроса поисковой системы
   1. Обзор запроса
   2. Условия запроса
   3. Запросить параметры
      1. Образец веб -исследовательских запросов
      2. Определения параметров запроса веб -исследования
      3. Расширенный поиск
      4. Параметры расширенного поиска
      5. Специальные условия запроса
      6. Пример запросов изображения
      7. Параметры запроса поиска изображения
      8. Запросить ограничения
   4. Интернационализация запросов и результатов презентации
      1. Кодирование персонажа
      2. Языки интерфейса
      3. Упрощенный и традиционный китайский поиск
   5. Фильтрация результатов
      1. Автоматическая фильтрация результатов поиска
      2. Фильтрация языка и страны
      3. Фильтрация контента для взрослых с помощью Safesearch
3. Результаты XML
   1. Google XML -результаты DTD
   2. О ответе XML
   3. Результаты XML для регулярных, изображений и расширенных запросов поиска
      1. Регулярный/расширенный поиск: примеры запроса и XML -результат
      2. Обычный/расширенный поиск: теги XML
      3. Результаты XML для запросов поиска изображения
      4. Поиск изображения: пример запроса и результат XML
      5. Поиск изображения: теги XML

Обзор

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

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

Формат запроса веб -исследования

• Обзор запроса
• Условия запроса
• Запросить параметры
• Образец веб -исследовательских запросов
• Определения параметров запроса веб -исследования
• Пример запросов изображения
• Определения параметров поиска изображения
• Расширенный поиск
  
• Параметры расширенного поиска
• Специальные условия запроса
• Запросить ограничения

Обзор запроса

Запрос поиска Google - это стандартная команда http GET . Он включает в себя набор параметров, относящихся к вашим запросам. Эти параметры включены в URL -адрес запроса в виде имени = значение значений, разделенных символами Ampersand (&). Параметры включают данные, такие как поисковый запрос, и уникальный идентификатор двигателя ( cx ), который идентифицирует двигатель, который делает HTTP -запрос. Служба поиска WebSearch или поиска изображений возвращает результаты XML в ответ на ваши HTTP -запросы.

Условия запроса

Большинство поисковых запросов включают один или несколько условий запроса. Термин запроса появляется как значение параметра в запросе поиска.

Условия запроса могут указать несколько типов информации для фильтрации и организованы результаты поиска, которые возвращает Google. Запросы могут указать:

• Слова или фразы , чтобы включить или исключить
  • Все слова в поисковом запросе (по умолчанию)
  • Точная фраза в поисковом запросе
  • Любое слово или фраза в поисковом запросе
• Где в документе, чтобы найти поисковые термины
  • Где угодно в документе (по умолчанию)
  • Только в теле документа
  • Только в заголовке документа
  • Только в URL документа
  • Только в ссылках в документе
• Ограничения на сами документы
  • Включая или исключая документы конкретных типов файлов (например, файлы PDF или документы Word)
• Специальные запросы URL -адреса , которые возвращают информацию о данном URL -адресе, вместо того, чтобы выполнять поиск
  • Запросы, которые возвращают общую информацию о URL, например, его категория открытых каталогов, фрагмент или язык
  • Запросы, которые возвращают набор веб -страниц, которые ссылаются на URL
  • Запросы, которые возвращают набор веб -страниц, аналогичные данному URL

Поиск по умолчанию

Значения параметров поиска должны быть сведены в URL. Обратите внимание, что вы замените знак плюс ("+") на любые пробелы в поисковом запросе. Это обсуждается далее в разделе URL -ухода этого документа.

Поисковый запрос отправляется в службу WebSearch с использованием параметра Q. Образец поискового запроса:

q=horses+cows+pigs

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

Запросить параметры

В этом разделе перечислены параметры, которые вы можете использовать при выполнении запроса поиска. Параметры разделены на два списка. Первый список содержит параметры, которые имеют отношение к всем запросам поиска. Второй список содержит параметры, которые имеют отношение только к расширенным запросам поиска.

Требуются три параметра запроса:

• Параметр клиента должен быть установлен в google-csbe
• Выходной параметр указывает формат возвращаемых результатов XML; Результаты могут быть возвращены (xml) или без ( xml_no_dtd ) ссылка на DTD Google. Мы рекомендуем установить это значение на xml_no_dtd . Примечание. Если вы не указали этот параметр, то результаты будут возвращены в HTML вместо XML.
  
• Параметр CX , который представляет уникальный идентификатор двигателя.
  

Наиболее часто используемые параметры запроса, отличные от упомянутых выше, являются:

• num - запрошенное количество результатов поиска
• Q - Термины поиска (ы)
• Начало - начальный индекс для результатов

Образец веб -исследовательских запросов

Приведенные ниже примеры показывают пару HTTP -запросов WebSearch, чтобы проиллюстрировать, как используются различные параметры запроса. Определения для различных параметров запроса приведены в определениях параметров запроса WebSearch и разделах параметров расширенного поискового запроса этого документа.

Этот запрос запрашивает первые 10 результатов ( start=0&num=10 ) для термина запроса «Red Sox» ( q=red+sox ). В запросе также указывается, что результаты должны поступать с канадских веб -сайтов ( cr=countryCA ) и должны быть написаны на французском языке ( lr=lang_fr ). Наконец, запрос определяет значения для параметров клиента , вывода и CX , все три из которых требуются.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

В этом примере используются некоторые из расширенных параметров запроса поиска для дальнейшей настройки поискового запроса. Этот запрос использует параметр AS_Q ( as_q=red+sox ) вместо параметра Q. Он также использует параметр as_eq , чтобы исключить любые документы, содержащие слово «янки» из результатов поиска ( as_eq=yankees ).

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i  

Определения параметров запроса веб -исследования

    <!DOCTYPE GSP SYSTEM "google.dtd">

Расширенный поиск

The additional query parameters listed below the image are relevant to advanced search queries. When you submit an advanced search, the values of several parameters (eg as_eq , as_epq , as_oq , etc.) are all factored into the query terms for that search. The image shows Google's Advanced Search page. On the image, the name of each advanced search parameter is written in red text inside of or next to the field on the page to which that parameter corresponds.

Advanced Search Query Parameters

Special Query Terms

Google WebSearch allows the use of several special query terms that access additional capabilities of the Google search engine. These special query terms should be included in the value of the q request parameter. Like other query terms, the special query terms must be URL-escaped . A number of the special query terms contain a colon (:). This character must also be URL-escaped; its URL-escaped value is %3A .

Sample Image Queries

The examples below show a couple of Image HTTP requests to illustrate how different query parameters are used. Definitions for the different query parameters are provided in the Image Query Parameter Definitions sections of this document.

This request asks for the first 5 results ( start=0&num=5 ) for the query term "monkey" ( q=monkey ), of filetype .png. Finally, the query specifies values for the client , output , and cx parameters, all three of which are required.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Image Search Query Parameters

Request Limits

The chart below lists limitations on the search requests that you send to Google:

Internationalizing Queries and Results Presentation

The Google WebSearch service enables you to search for documents in multiple languages. You can specify the character encoding that should be used to interpret your HTTP request and to encode your XML response (using the ie and oe search parameters). You can also filter results to only include documents written in certain languages.

The following sections discuss issues related to searching in multiple languages:

• Character Encoding
• Interface Languages
• Simplified and Traditional Chinese Search

Character Encoding

Servers send data, such as web pages, to user agents, such as browsers, as a sequence of encoded bytes. The user agent then decodes the bytes into a sequence of characters. When sending requests to the WebSearch service, you can specify the encoding schemes for both your search query and for the XML response that you receive.

You can use the ie request parameter to specify the encoding mechanism for the characters in your HTTP request. You can also use the oe parameter to specify the encoding scheme that Google should use to encode your XML response. If you are using an encoding scheme other than ISO-8859-1 (or latin1 ), please ensure that you specify the correct values for the ie and oe parameters.

Note: If you are providing search functionality for multiple languages, we recommend you use the utf8 (UTF-8) encoding value for both the ie and oe parameters.

Please refer to the Character Encoding Schemes appendix for a complete list of the values that you can use for the ie and oe parameters.

For more general information about character encoding, please see http://www.w3.org/TR/REC-html40/charset.html .

Interface Languages

You can use the hl request parameter to identify the language of your graphical interface. The hl parameter value may affect XML search results, especially on international queries when language restriction (using the lr parameter) is not explicitly specified. In such cases, the hl parameter may promote search results in the same language as the user's input language.

We suggest you explicitly set the hl parameter in search results to ensure that Google selects the highest quality search results for each query.

Please see the Supported Interface Languages section for a complete list of valid values for the hl parameter.

Searching for Documents Written in Specific Languages

You can use the lr request parameter to restrict search results to documents that are written in a particular language or set of languages.

The lr parameter supports Boolean Operators to allow you to specify multiple languages that should be included (or excluded) from search results.

The following examples show how you might use Boolean Operators to request documents in different languages.

For documents written in Japanese:

lr=lang_jp

For documents written in Italian or German:

lr=lang_it|lang_de

For documents not written in Hungarian or Czech:

lr=(-lang_hu).(-lang_cs)

Please see the Language Collection Values section for a complete list of possible values for the lr parameter and the Boolean Operators section for a complete discussion of the use of these operators.

Simplified and Traditional Chinese Search

Simplified Chinese and Traditional Chinese are two writing variants of the Chinese language. The same concept may be written differently in each variant. Given a query in one of the variants, the Google WebSearch service can return results that include pages in both variants.

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

1. Set the c2coff request parameter to 0
   и
2. Do one of the following:
   • Do not set the lr request parameter
     или
   • Set the lr request parameter to lr=lang_zh-TW|lang_zh-CN

The following example shows the query parameters you would include in a request for results in both simplified and traditional Chinese. (Note that additional required information, such as the client , is not included in the example.)

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

Filtering Results

Google WebSearch provides a number of ways to filter your search results:

• Automatic Filtering of Search Results
• Language and Country Filtering
• Filtering Adult Content with SafeSearch

Automatic Filtering of Search Results

In an effort to provide the best search results possible, Google uses two techniques to automatically filter search results that are generally considered undesirable:

• Duplicate Content —If multiple documents contain the same information, then only the most relevant document of that set is included in your search results.

• Host Crowding —If there are many search results from the same site, Google may not show all the results from that site or may show the results lower in
  the ranking than they otherwise would have been.

We recommend you leave these filters on for typical search requests because the filters significantly enhance the quality of most search results. However, you can bypass these automatic filters by setting the filter query parameter to 0 in your search request.

Language and Country Filtering

The Google WebSearch service returns results from a master index of all Web documents. The master index contains subcollections of documents that are grouped by particular attributes, including language and country of origin.

You can use the lr and cr request parameters to restrict search results to subcollections of documents that are written in particular languages or originate from particular countries, respectively.

Google WebSearch determines the language of a document by analyzing:

• the top-level domain (TLD) of the document's URL
• language meta tags within the document
• the primary language used in the body text of the document

Please also see the definition of the lr parameter, the section on Searching for Documents Written in Specific Languages and the Language Collection Values that can be used as values for the lr parameter for more information on restricting results based on language.

Google WebSearch determines the country of a document by analyzing:

• the top-level domain (TLD) of the document's URL
• the geographic location of the Web server's IP address

Please also see the definition of the cr parameter and the Country Collection Values that can be used as values for the cr parameter for more information on restricting results by country of origin.

Note: You can combine language values and country values to customize your search results. For example, you could request documents that are written in French and come from France or Canada, or you could request documents that come from Holland and are not written in English. The lr and cr parameters both support Boolean Operators .

Filtering Adult Content with SafeSearch

Many Google customers do not want to display search results for sites that contain adult content. Using our SafeSearch filter, you can screen for search results that contain adult content and eliminate them. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results.

Google strives to keep SafeSearch as current and comprehensive as possible by continually crawling the Web and by incorporating updates from user suggestions.

SafeSearch is available in the following languages:

You can adjust the degree to which Google filters your results for adult content using the safe query parameter. The following table explains Google's SafeSearch settings and how those settings will affect your search results:

If you have SafeSearch activated and you find sites that contain offensive content in your results, please email the site's URL to safesearch@google.com , and we will investigate the site.

XML Results

• Google XML Results DTD
• About the XML Response
• XML Results for Regular and Advanced Search Queries
• Regular/Advanced Search: Sample Query and XML Result
• Regular/Advanced Search: XML Tags

Google XML Results DTD

Google uses the same DTD to describe the XML format for all types of search results. Many of the tags and attributes are applicable for all search types. Some tags, however, are applicable only for certain search types. Consequently, the definitions in the DTD may be less restrictive than the definitions given in this document.

This document describes those aspects of the DTD that are relevant for WebSearch. When you look at the DTD, if you're working on WebSearch, you can safely ignore tags and attributes that are not documented here. If the definition differs between the DTD and the documentation, that fact is noted in this document.

Google can return XML results either with or without a reference to the most recent DTD. The DTD is a guide to help search administrators and XML parsers understand Google's XML results. Because Google's XML grammar may change from time to time, you should not configure your parser to use the DTD to validate each XML result.

Additionally, you should not configure your XML parser to fetch the DTD each time you submit a search request. Google updates the DTD infrequently, and these requests create unnecessary delay and bandwidth requirements.

Google recommends that you use the xml_no_dtd output format to get XML results. If you specify the xml output format in your search request, the only difference is the inclusion of the following line in the XML results:

<!DOCTYPE GSP SYSTEM "google.dtd">

You can access the latest DTD at http://www.google.com/google.dtd .

Please note that not all features in the DTD may be available or supported at this time.

About the XML Response

• All element values are valid HTML suitable for display unless otherwise noted in the XML tag definitions.
• Some element values are URLs that need to be HTML-encoded before they are displayed.
• Your XML parser should ignore undocumented attributes and tags. This allows your application to continue working without modification if Google adds more features to the XML output.
• Certain characters must be escaped when included as values in XML tags. Your XML processor should convert these entities back to the appropriate characters. If you do not convert entities properly, the browser may, for example, render the & character as "&". The XML Standard documents these characters; these characters are reproduced in the table below:

  Характер	Escaped Forms	Сущность	Код символа
  Амперсанд	&	&	&
  Single Quote	'	'	'
  Double Quote	"	"	"
  Больше, чем	>	>	>
  Меньше, чем	<	&lt;	&#60;

XML Results for Regular and Advanced Search Queries

Regular/Advanced Search: Sample Query and XML Result

This sample WebSearch request asks for 10 results ( num=10 ) about the search term "socer" ( q=socer ), which is the word "soccer" intentionally spelled wrong for this example.)

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i 

This request yields the XML result below. Note that there are several comments in the XML result to indicate where certain tags not included in the result would appear.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

Regular/Advanced Search: XML Tags

XML responses for regular search requests and advanced search requests both use the same set of XML tags. These XML tags are shown in the XML example above and explained in the tables below.

The XML tags below are listed alphabetically by tag name, and each tag definition contains a description of the tag, an example showing how the tag would appear in an XML result and the format of the tag's content. If the tag is a subtag of another XML tag or if the tag has subtags or attributes of its own, that information is also provided in the tag's definition table.

Certain symbols may be displayed next to some subtags in the definitions below. These symbols, and their meanings, are:

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

XML Results for Image Search Queries

This sample Image request asks for 5 results (num=5) about the search term "monkey" (q=monkey).

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

This request yields the XML result below.

G<SP VER="3.2"
>  T<M0>.395037/<TM
>  Q<m>onkeys/<Q
>
  P<ARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_e<scaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/
>  P<ARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/
>  P<ARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/
>  P<ARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/
>  P<ARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/
>  P<ARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/
>  P<ARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/
>  P<ARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/
>  P<ARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/
>  P<ARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/
>
  C<ontext
>    t<itled>omestigeek/<title
>  /<Context
>
  A<RES/
>  R<ES SN="1" EN="2"
>    M<2>500000/<M
>    N<B
>      N<U/>images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      /<NU
>    /<NB
>    R<G START="1" SIZE="2"/
>      R< N="1" MIME="image/jpeg"
>        R<Uh>ttp://www.flickr.com/photos/fncll/135465558//<RU
>        U<
>          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        /<U
>        U<E
>          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        /<UE
>        T<C>omputer b<M>onkeys/<b >| Flickr - Photo Sharing!/<T
>        R<K0>/<RK
>        B<YLINEDATE1>146034800/<BYLINEDATE
>        S<C>omputer b<M>onkeys/<b >| Flickr/<S
>        L<ANGe>n/<LANG
>        I<MG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"
>          S<Z8>8386/<SZ
>          I<N/
>        /<IMG
>        T<BN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/
>      /<R
>      R< N="2" MIME="image/jpeg"
>        R<U
>          http://www.flickr.com/photos/flickerbulb/187044366/
        /<RU
>        U<
>          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        /<U
>        U<E
>          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        /<UE
>        T<
>          one. ugly. b<m>onkey/<b.> | Flickr - Photo Sharing!
        /<T
>        R<K0>/<RK
>        B<YLINEDATE1>152514800/<BYLINEDATE
>        S<o>ne. ugly. b<m>onkey/<b.>/<S
>        L<ANGe>n/<LANG
>        I<MG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"S><Z5>8339/<SZ
>          I<N/
>        /<IMG
>        T<BN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/
>      /<R
>  /<RES
>/<GSP
>

Image Search: XML Tags

The table below shows additional XML tags used in XML responses for image search queries.

Certain symbols may be displayed next to some subtags in the definitions below. These symbols, and their meanings, are: