Search

Ответ на запрос пользовательского поиска.

JSON-представление
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Поля
kind

string

Уникальный идентификатор типа текущего объекта. Для этого API это customsearch#search.

url

object

Элемент URL-адреса OpenSearch, определяющий шаблон для этого API.

url.type

string

Тип MIME шаблона URL-адреса OpenSearch для API JSON пользовательского поиска.

url.template

string

Фактический шаблон OpenSearch для этого API.

queries

object

Содержит один или несколько наборов метаданных запроса, сгруппированных по имени роли. Возможные имена ролей включают request , определенный ролями запроса OpenSearch , и две пользовательские роли: nextPage и previousPage .

queries.previousPage[]

object

Метаданные, представляющие предыдущую страницу результатов, если применимо.

queries.previousPage[].title

string

Описание запроса.

queries.previousPage[].totalResults

string ( int64 format)

Примерное общее количество результатов поиска. Может быть неточно.

queries.previousPage[].searchTerms

string

Условия поиска, введенные пользователем.

queries.previousPage[].count

integer

Количество результатов поиска, возвращенных в этом наборе.

queries.previousPage[].startIndex

integer

Индекс текущего набора результатов поиска в общем наборе результатов, где индекс первого результата равен 1.

queries.previousPage[].startPage

integer

Номер страницы этого набора результатов, где длина страницы задается свойством count .

queries.previousPage[].language

string

Язык результатов поиска.

queries.previousPage[].inputEncoding

string

Кодировка символов, поддерживаемая для поисковых запросов.

queries.previousPage[].outputEncoding

string

Кодировка символов, поддерживаемая для результатов поиска.

queries.previousPage[].safe

string

Указывает уровень безопасного поиска , используемый для фильтрации результатов для взрослых. Это настраиваемое свойство, не определенное в спецификации OpenSearch. Допустимые значения параметров:

  • "off" : отключить безопасный поиск.

  • "active" : включить безопасный поиск.

queries.previousPage[].cx

string

Идентификатор системы, созданный с помощью панели управления программируемой поисковой системой. Это настраиваемое свойство, не определенное в спецификации OpenSearch. Этот параметр является обязательным .

queries.previousPage[].sort

string

Указывает, что результаты должны быть отсортированы в соответствии с указанным выражением. Например, отсортировать по дате.

queries.previousPage[].filter

string

Активирует или деактивирует автоматическую фильтрацию результатов поиска Google. Дополнительную информацию о фильтрах результатов поиска Google см. в разделе Автоматическая фильтрация . Допустимые значения для этого параметра:

  • 0 : Отключено

  • 1 : Включено (по умолчанию)

Примечание . По умолчанию Google применяет фильтрацию ко всем результатам поиска, чтобы улучшить их качество.

queries.previousPage[].gl

string

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

Указание значения параметра gl в запросах WebSearch должно повысить релевантность результатов. Это особенно актуально для международных клиентов и, в частности, для клиентов в англоязычных странах, за исключением США.

queries.previousPage[].cr

string

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

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

  • Домен верхнего уровня (TLD) URL-адреса документа.

  • Географическое расположение IP-адреса веб-сервера.

Список допустимых значений для этого параметра см. в разделе «Значения параметра страны (cr)» .

queries.previousPage[].googleHost

string

Указывает домен Google (например, google.com, google.de или google.fr), которым должен быть ограничен поиск.

queries.previousPage[].disableCnTwTranslation

string

Включает или отключает функцию поиска на упрощенном и традиционном китайском языке .

Поддерживаемые значения:

  • 0 : включено (по умолчанию)

  • 1 : отключено

queries.previousPage[].hq

string

Добавляет указанные условия запроса к запросу, как если бы они были объединены логическим оператором AND

queries.previousPage[].hl

string

Указывает язык интерфейса (язык хоста) вашего пользовательского интерфейса. Явная установка этого параметра повышает производительность и качество результатов поиска.

Дополнительные сведения см. в разделе «Языки интерфейса» документа «Интернационализация запросов и представления результатов» , а список поддерживаемых языков — в разделе «Поддерживаемые языки интерфейса ».

queries.previousPage[].siteSearch

string

Ограничивает результаты URL-адресами с указанного сайта.

queries.previousPage[].siteSearchFilter

string

Указывает, включать или исключать результаты с сайта, указанного в параметре sitesearch . Поддерживаемые значения:

  • i : включить контент с сайта

  • e : исключить контент с сайта

queries.previousPage[].exactTerms

string

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

queries.previousPage[].excludeTerms

string

Определяет слово или фразу, которые не должны появляться ни в каких документах в результатах поиска.

queries.previousPage[].linkSite

string

Указывает, что все результаты должны содержать ссылку на определенный URL-адрес.

queries.previousPage[].orTerms

string

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

queries.previousPage[].relatedSite

string

Указывает, что все результаты поиска должны представлять собой страницы, связанные с указанным URL-адресом. Значение параметра должно быть URL-адресом.

queries.previousPage[].dateRestrict

string

Ограничивает результаты URL-адресами на основе даты. Поддерживаемые значения включают в себя:

  • d[number] : запрашивает результаты за указанное количество прошлых дней.

  • w[number] : запрашивает результаты за указанное количество прошлых недель.

  • m[number] : запрашивает результаты за указанное количество прошлых месяцев.

  • y[number] : запрашивает результаты за указанное количество прошлых лет.

queries.previousPage[].lowRange

string

Указывает начальное значение диапазона поиска. Используйте cse:lowRange и cse:highrange , чтобы добавить к запросу инклюзивный диапазон поиска lowRange...highRange .

queries.previousPage[].highRange

string

Указывает конечное значение диапазона поиска. Используйте cse:lowRange и cse:highrange , чтобы добавить к запросу инклюзивный диапазон поиска lowRange...highRange .

queries.previousPage[].fileType

string

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

  • Формат переносимого документа Adobe ( pdf )

  • Adobe PostScript ( ps )

  • Lotus 1-2-3 ( wk1 , wk2 , wk3 , wk4 , 5 нед, wk5 , wki , wks , wku )

  • Лотос WordPro ( lwp )

  • Макрайт ( mw )

  • Microsoft Excel ( xls )

  • Microsoft PowerPoint ( ppt )

  • Microsoft Word ( doc )

  • Microsoft Works ( wks , wps , wdb )

  • Microsoft Write ( wri )

  • Расширенный текстовый формат ( rtf )

  • Ударно-волновая вспышка ( swf )

  • Текст ( ans , txt ).

В будущем могут быть добавлены дополнительные типы файлов. Актуальный список всегда можно найти в FAQ по типам файлов Google.

queries.previousPage[].rights

string

Фильтры на основе лицензирования. Поддерживаемые значения включают в себя:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

Допустимые значения: web или image . Если не указано, результаты ограничиваются веб-страницами.

queries.previousPage[].imgSize

string

Ограничивает результаты изображениями указанного размера. Поддерживаемые значения:

  • icon (маленький)

  • small | medium | large | xlarge (средний)

  • xxlarge (большой)

  • huge (очень большой)

queries.previousPage[].imgType

string

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

  • clipart (Картинка)

  • face (Лицо)

  • lineart (линейный рисунок)

  • photo (Фото)

  • animated (анимированный)

  • stock (акции)

queries.previousPage[].imgColorType

string

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

  • mono (черно-белый)

  • gray (оттенки серого)

  • color (цвет)

queries.previousPage[].imgDominantColor

string

Ограничивает результаты изображениями с определенным доминирующим цветом. Поддерживаемые значения:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Метаданные, представляющие текущий запрос.

queries.request[].title

string

Описание запроса.

queries.request[].totalResults

string ( int64 format)

Примерное общее количество результатов поиска. Может быть неточно.

queries.request[].searchTerms

string

Условия поиска, введенные пользователем.

queries.request[].count

integer

Количество результатов поиска, возвращенных в этом наборе.

queries.request[].startIndex

integer

Индекс текущего набора результатов поиска в общем наборе результатов, где индекс первого результата равен 1.

queries.request[].startPage

integer

Номер страницы этого набора результатов, где длина страницы задается свойством count .

queries.request[].language

string

Язык результатов поиска.

queries.request[].inputEncoding

string

Кодировка символов, поддерживаемая для поисковых запросов.

queries.request[].outputEncoding

string

Кодировка символов, поддерживаемая для результатов поиска.

queries.request[].safe

string

Указывает уровень безопасного поиска , используемый для фильтрации результатов для взрослых. Это настраиваемое свойство, не определенное в спецификации OpenSearch. Допустимые значения параметров:

  • "off" : отключить безопасный поиск.

  • "active" : включить безопасный поиск.

queries.request[].cx

string

Идентификатор системы, созданный с помощью панели управления программируемой поисковой системой. Это настраиваемое свойство, не определенное в спецификации OpenSearch. Этот параметр является обязательным .

queries.request[].sort

string

Указывает, что результаты должны быть отсортированы в соответствии с указанным выражением. Например, отсортировать по дате.

queries.request[].filter

string

Активирует или деактивирует автоматическую фильтрацию результатов поиска Google. Дополнительную информацию о фильтрах результатов поиска Google см. в разделе Автоматическая фильтрация . Допустимые значения для этого параметра:

  • 0 : Отключено

  • 1 : Включено (по умолчанию)

Примечание . По умолчанию Google применяет фильтрацию ко всем результатам поиска, чтобы улучшить их качество.

queries.request[].gl

string

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

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

queries.request[].cr

string

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

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

  • Домен верхнего уровня (TLD) URL-адреса документа.

  • Географическое расположение IP-адреса веб-сервера.

Список допустимых значений для этого параметра см. в разделе «Значения параметра страны (cr)» .

queries.request[].googleHost

string

Указывает домен Google (например, google.com, google.de или google.fr), которым должен быть ограничен поиск.

queries.request[].disableCnTwTranslation

string

Включает или отключает функцию поиска на упрощенном и традиционном китайском языке .

Поддерживаемые значения:

  • 0 : включено (по умолчанию)

  • 1 : отключено

queries.request[].hq

string

Добавляет указанные условия запроса к запросу, как если бы они были объединены логическим оператором AND

queries.request[].hl

string

Указывает язык интерфейса (язык хоста) вашего пользовательского интерфейса. Явная установка этого параметра повышает производительность и качество результатов поиска.

Дополнительные сведения см. в разделе «Языки интерфейса» документа «Интернационализация запросов и представления результатов» , а список поддерживаемых языков — в разделе «Поддерживаемые языки интерфейса ».

queries.request[].siteSearch

string

Ограничивает результаты URL-адресами с указанного сайта.

queries.request[].siteSearchFilter

string

Указывает, включать или исключать результаты с сайта, указанного в параметре sitesearch . Поддерживаемые значения:

  • i : включить контент с сайта

  • e : исключить контент с сайта

queries.request[].exactTerms

string

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

queries.request[].excludeTerms

string

Определяет слово или фразу, которые не должны появляться ни в каких документах в результатах поиска.

queries.request[].linkSite

string

Указывает, что все результаты должны содержать ссылку на определенный URL-адрес.

queries.request[].orTerms

string

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

queries.request[].relatedSite

string

Указывает, что все результаты поиска должны представлять собой страницы, связанные с указанным URL-адресом. Значение параметра должно быть URL-адресом.

queries.request[].dateRestrict

string

Ограничивает результаты URL-адресами на основе даты. Поддерживаемые значения включают в себя:

  • d[number] : запрашивает результаты за указанное количество прошлых дней.

  • w[number] : запрашивает результаты за указанное количество прошлых недель.

  • m[number] : запрашивает результаты за указанное количество прошлых месяцев.

  • y[number] : запрашивает результаты за указанное количество прошлых лет.

queries.request[].lowRange

string

Указывает начальное значение диапазона поиска. Используйте cse:lowRange и cse:highrange , чтобы добавить к запросу инклюзивный диапазон поиска lowRange...highRange .

queries.request[].highRange

string

Указывает конечное значение диапазона поиска. Используйте cse:lowRange и cse:highrange , чтобы добавить к запросу инклюзивный диапазон поиска lowRange...highRange .

queries.request[].fileType

string

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

  • Формат переносимого документа Adobe ( pdf )

  • Adobe PostScript ( ps )

  • Lotus 1-2-3 ( wk1 , wk2 , wk3 , wk4 , 5 нед, wk5 , wki , wks , wku )

  • Лотос WordPro ( lwp )

  • Макрайт ( mw )

  • Microsoft Excel ( xls )

  • Microsoft PowerPoint ( ppt )

  • Microsoft Word ( doc )

  • Microsoft Works ( wks , wps , wdb )

  • Microsoft Write ( wri )

  • Расширенный текстовый формат ( rtf )

  • Ударно-волновая вспышка ( swf )

  • Текст ( ans , txt ).

В будущем могут быть добавлены дополнительные типы файлов. Актуальный список всегда можно найти в FAQ по типам файлов Google.

queries.request[].rights

string

Фильтры на основе лицензирования. Поддерживаемые значения включают в себя:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

Допустимые значения: web или image . Если не указано, результаты ограничиваются веб-страницами.

queries.request[].imgSize

string

Ограничивает результаты изображениями указанного размера. Поддерживаемые значения:

  • icon (маленький)

  • small | medium | large | xlarge (средний)

  • xxlarge (большой)

  • huge (очень большой)

queries.request[].imgType

string

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

  • clipart (Картинка)

  • face (Лицо)

  • lineart (линейный рисунок)

  • photo (Фото)

  • animated (анимированный)

  • stock (акции)

queries.request[].imgColorType

string

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

  • mono (черно-белый)

  • gray (оттенки серого)

  • color (цвет)

queries.request[].imgDominantColor

string

Ограничивает результаты изображениями с определенным доминирующим цветом. Поддерживаемые значения:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Метаданные, представляющие следующую страницу результатов, если применимо.

queries.nextPage[].title

string

Описание запроса.

queries.nextPage[].totalResults

string ( int64 format)

Примерное общее количество результатов поиска. Может быть неточно.

queries.nextPage[].searchTerms

string

Условия поиска, введенные пользователем.

queries.nextPage[].count

integer

Количество результатов поиска, возвращенных в этом наборе.

queries.nextPage[].startIndex

integer

Индекс текущего набора результатов поиска в общем наборе результатов, где индекс первого результата равен 1.

queries.nextPage[].startPage

integer

Номер страницы этого набора результатов, где длина страницы задается свойством count .

queries.nextPage[].language

string

Язык результатов поиска.

queries.nextPage[].inputEncoding

string

Кодировка символов, поддерживаемая для поисковых запросов.

queries.nextPage[].outputEncoding

string

Кодировка символов, поддерживаемая для результатов поиска.

queries.nextPage[].safe

string

Указывает уровень безопасного поиска , используемый для фильтрации результатов для взрослых. Это настраиваемое свойство, не определенное в спецификации OpenSearch. Допустимые значения параметров:

  • "off" : отключить безопасный поиск.

  • "active" : включить безопасный поиск.

queries.nextPage[].cx

string

Идентификатор системы, созданный с помощью панели управления программируемой поисковой системой. Это настраиваемое свойство, не определенное в спецификации OpenSearch. Этот параметр является обязательным .

queries.nextPage[].sort

string

Указывает, что результаты должны быть отсортированы в соответствии с указанным выражением. Например, отсортировать по дате.

queries.nextPage[].filter

string

Активирует или деактивирует автоматическую фильтрацию результатов поиска Google. Дополнительную информацию о фильтрах результатов поиска Google см. в разделе Автоматическая фильтрация . Допустимые значения для этого параметра:

  • 0 : Отключено

  • 1 : Включено (по умолчанию)

Примечание . По умолчанию Google применяет фильтрацию ко всем результатам поиска, чтобы улучшить их качество.

queries.nextPage[].gl

string

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

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

queries.nextPage[].cr

string

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

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

  • Домен верхнего уровня (TLD) URL-адреса документа.

  • Географическое расположение IP-адреса веб-сервера.

Список допустимых значений для этого параметра см. в разделе «Значения параметра страны (cr)» .

queries.nextPage[].googleHost

string

Указывает домен Google (например, google.com, google.de или google.fr), которым должен быть ограничен поиск.

queries.nextPage[].disableCnTwTranslation

string

Включает или отключает функцию поиска на упрощенном и традиционном китайском языке .

Поддерживаемые значения:

  • 0 : включено (по умолчанию)

  • 1 : отключено

queries.nextPage[].hq

string

Добавляет указанные условия запроса к запросу, как если бы они были объединены логическим оператором AND

queries.nextPage[].hl

string

Указывает язык интерфейса (язык хоста) вашего пользовательского интерфейса. Явная установка этого параметра повышает производительность и качество результатов поиска.

Дополнительные сведения см. в разделе «Языки интерфейса» документа «Интернационализация запросов и представления результатов» , а список поддерживаемых языков — в разделе «Поддерживаемые языки интерфейса ».

queries.nextPage[].siteSearch

string

Ограничивает результаты URL-адресами с указанного сайта.

queries.nextPage[].siteSearchFilter

string

Указывает, включать или исключать результаты с сайта, указанного в параметре sitesearch . Поддерживаемые значения:

  • i : включить контент с сайта

  • e : исключить контент с сайта

queries.nextPage[].exactTerms

string

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

queries.nextPage[].excludeTerms

string

Определяет слово или фразу, которые не должны появляться ни в каких документах в результатах поиска.

queries.nextPage[].linkSite

string

Указывает, что все результаты должны содержать ссылку на определенный URL-адрес.

queries.nextPage[].orTerms

string

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

queries.nextPage[].relatedSite

string

Указывает, что все результаты поиска должны представлять собой страницы, связанные с указанным URL-адресом. Значение параметра должно быть URL-адресом.

queries.nextPage[].dateRestrict

string

Ограничивает результаты URL-адресами на основе даты. Поддерживаемые значения включают в себя:

  • d[number] : запрашивает результаты за указанное количество прошлых дней.

  • w[number] : запрашивает результаты за указанное количество прошлых недель.

  • m[number] : запрашивает результаты за указанное количество прошлых месяцев.

  • y[number] : запрашивает результаты за указанное количество прошлых лет.

queries.nextPage[].lowRange

string

Указывает начальное значение диапазона поиска. Используйте cse:lowRange и cse:highrange , чтобы добавить к запросу инклюзивный диапазон поиска lowRange...highRange .

queries.nextPage[].highRange

string

Указывает конечное значение диапазона поиска. Используйте cse:lowRange и cse:highrange , чтобы добавить к запросу инклюзивный диапазон поиска lowRange...highRange .

queries.nextPage[].fileType

string

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

  • Формат переносимого документа Adobe ( pdf )

  • Adobe PostScript ( ps )

  • Lotus 1-2-3 ( wk1 , wk2 , wk3 , wk4 , 5 нед, wk5 , wki , wks , wku )

  • Лотос WordPro ( lwp )

  • Макрайт ( mw )

  • Microsoft Excel ( xls )

  • Microsoft PowerPoint ( ppt )

  • Microsoft Word ( doc )

  • Microsoft Works ( wks , wps , wdb )

  • Microsoft Write ( wri )

  • Расширенный текстовый формат ( rtf )

  • Ударно-волновая вспышка ( swf )

  • Текст ( ans , txt ).

В будущем могут быть добавлены дополнительные типы файлов. Актуальный список всегда можно найти в FAQ по типам файлов Google.

queries.nextPage[].rights

string

Фильтры на основе лицензирования. Поддерживаемые значения включают в себя:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

Допустимые значения: web или image . Если не указано, результаты ограничиваются веб-страницами.

queries.nextPage[].imgSize

string

Ограничивает результаты изображениями указанного размера. Поддерживаемые значения:

  • icon (маленький)

  • small | medium | large | xlarge (средний)

  • xxlarge (большой)

  • huge (очень большой)

queries.nextPage[].imgType

string

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

  • clipart (Картинка)

  • face (Лицо)

  • lineart (линейный рисунок)

  • photo (Фото)

  • animated (анимированный)

  • stock (акции)

queries.nextPage[].imgColorType

string

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

  • mono (черно-белый)

  • gray (оттенки серого)

  • color (цвет)

queries.nextPage[].imgDominantColor

string

Ограничивает результаты изображениями с определенным доминирующим цветом. Поддерживаемые значения:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object ( Promotion )

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

context

object ( Struct format)

Метаданные и уточнения, связанные с данной поисковой системой, в том числе:

  • Имя поисковой системы, которая использовалась для запроса.

  • Набор фасетных объектов (уточнений), которые можно использовать для уточнения поиска.

searchInformation

object

Метаданные об этом поиске, включая время поиска и общее количество результатов.

searchInformation.searchTime

number

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

searchInformation.formattedSearchTime

string

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

searchInformation.totalResults

string

Общее количество результатов поиска, возвращаемых запросом.

searchInformation.formattedTotalResults

string

Общее количество результатов поиска, отформатированное в соответствии со стилем локали.

spelling

object

Инкапсулирует исправленный запрос.

spelling.correctedQuery

string

Исправленный запрос.

spelling.htmlCorrectedQuery

string

Исправленный запрос, отформатированный в HTML.

items[]

object ( Result )

Текущий набор результатов пользовательского поиска.

Повышение

Результат продвижения.

JSON-представление
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Поля
title

string

Название акции.

htmlTitle

string

Название рекламной акции в формате HTML.

bodyLines[]

object

Массив блочных объектов для данной акции.

bodyLines[].title

string

Текст объекта блока, если он имеет текст.

bodyLines[].htmlTitle

string

Текст объекта блока в HTML, если он имеет текст.

bodyLines[].url

string

URL-адрес ссылки на объект блокировки, если она есть.

bodyLines[].link

string

Текст привязки ссылки объекта блока, если он имеет ссылку.

image

object

Изображение, связанное с этой рекламной акцией, если оно есть.

image.source

string

URL изображения для этой рекламной ссылки.

image.width

integer

Ширина изображения в пикселях.

image.height

integer

Высота изображения в пикселях.

Результат

Пользовательский результат поиска.

JSON-представление
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Поля
kind

string

Уникальный идентификатор типа текущего объекта. Для этого API это customsearch#result.

title

string

Название результата поиска в виде обычного текста.

htmlTitle

string

Название результата поиска в формате HTML.

snippet

string

Фрагмент результата поиска в виде обычного текста.

htmlSnippet

string

Фрагмент результата поиска в формате HTML.

cacheId

string

Указывает идентификатор кэшированной версии результата поиска Google.

formattedUrl

string

URL-адрес, отображаемый после фрагмента для каждого результата поиска.

htmlFormattedUrl

string

URL-адрес в формате HTML, отображаемый после фрагмента для каждого результата поиска.

pagemap

object ( Struct format)

Содержит информацию PageMap для этого результата поиска.

mime

string

MIME-тип результата поиска.

fileFormat

string

Формат файла результатов поиска.

image

object

Инкапсулирует всю информацию об изображении, возвращаемую в результатах поиска.

image.contextLink

string

URL-адрес, указывающий на веб-страницу, на которой размещено изображение.

image.height

integer

Высота изображения в пикселях.

image.width

integer

Ширина изображения в пикселях.

image.byteSize

integer

Размер изображения в байтах.

image.thumbnailLink

string

URL-адрес миниатюры изображения.

image.thumbnailHeight

integer

Высота миниатюры изображения в пикселях.

image.thumbnailWidth

integer

Ширина миниатюры изображения в пикселях.

labels[]

object

Инкапсулирует всю информацию о метках уточнений.

labels[].name

string

Имя метки уточнения, которую можно использовать для уточнения поиска. Не отображайте это в своем пользовательском интерфейсе; вместо этого используйте displayName.

labels[].displayName

string

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

labels[].label_with_op

string

Метка уточнения и связанная с ним операция уточнения.