Возвращает метаданные о выполненном поиске, метаданные о системе, используемой для поиска, и результаты поиска. Использует небольшой набор шаблонов URL.
HTTP-запрос
GET https://customsearch.googleapis.com/customsearch/v1/siterestrict
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры | |
---|---|
c2coff | Включает или отключает упрощенный и традиционный китайский поиск . Значение по умолчанию для этого параметра — 0 (ноль), что означает, что функция включена. Поддерживаемые значения:
|
cr | Ограничивает результаты поиска документами, происходящими из определенной страны. Вы можете использовать логические операторы в значении параметра cr. Поиск Google определяет страну документа, анализируя:
Список допустимых значений для этого параметра см. на странице «Значения параметров страны» . |
cx | Идентификатор программируемой поисковой системы, который будет использоваться для этого запроса. |
dateRestrict | Ограничивает результаты URL-адресами на основе даты. Поддерживаемые значения включают в себя:
|
exactTerms | Определяет фразу, которую должны содержать все документы в результатах поиска. |
excludeTerms | Определяет слово или фразу, которые не должны появляться ни в каких документах в результатах поиска. |
fileType | Ограничивает результаты файлами указанного расширения. Список типов файлов, индексируемых Google, можно найти в Справочном центре Search Console. |
filter | Управляет включением или отключением фильтра дублированного контента.
Приемлемые значения:
|
gl | Геолокация конечного пользователя.
|
googlehost | Устарело . Используйте параметр Локальный домен Google (например, google.com, google.de или google.fr), который будет использоваться для поиска. |
highRange | Указывает конечное значение диапазона поиска.
|
hl | Устанавливает язык пользовательского интерфейса.
|
hq | Добавляет указанные условия запроса к запросу, как если бы они были объединены логическим оператором И. |
imgColorType | Возвращает черно-белые, полутоновые, прозрачные или цветные изображения. Приемлемые значения:
|
imgDominantColor | Возвращает изображения определенного доминирующего цвета. Приемлемые значения:
|
imgSize | Возвращает изображения указанного размера. Приемлемые значения:
|
imgType | Возвращает изображения определенного типа. Приемлемые значения:
|
linkSite | Указывает, что все результаты поиска должны содержать ссылку на определенный URL-адрес. |
lowRange | Указывает начальное значение диапазона поиска. Используйте |
lr | Ограничивает поиск документами, написанными на определенном языке (например, Приемлемые значения:
|
num | Количество возвращаемых результатов поиска.
|
orTerms | Предоставляет дополнительные условия поиска для проверки в документе, при этом каждый документ в результатах поиска должен содержать хотя бы один из дополнительных условий поиска. |
q | Запрос |
relatedSite | Устарело. |
rights | Фильтры на основе лицензирования. Поддерживаемые значения включают: |
safe | Уровень безопасности поиска. Приемлемые значения:
|
searchType | Указывает тип поиска: Приемлемые значения:
|
siteSearch | Указывает данный сайт, который всегда должен быть включен или исключен из результатов (см. параметр |
siteSearchFilter | Определяет, включать или исключать результаты с сайта, указанного в параметре Приемлемые значения:
|
sort | Выражение сортировки, применяемое к результатам. Параметр sort указывает, что результаты сортируются в соответствии с указанным выражением, т. е. сортируются по дате. Пример: сортировка=дата . |
start | Индекс первого возвращаемого результата. По умолчанию количество результатов на странице равно 10, поэтому |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр Search
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/cse
Дополнительную информацию см. в обзоре OAuth 2.0 .