Возвращает метаданные о выполненном поиске, метаданные о системе, используемой для поиска, и результаты поиска.
HTTP-запрос
 GET https://customsearch.googleapis.com/customsearch/v1
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 .