Обновление документации Google по Web Search Service API: что нужно знать партнерам

Google обновил свою публичную документацию для Web Search Service API, сервиса, который позволяет партнерам извлекать и отображать результаты поиска Google на своих веб-сайтах и в приложениях. Обновления были внесены 9 сентября, и каждое обращение к API требует наличия клиентского идентификатора, связанного с партнерским соглашением, а также проекта Google Cloud и ключа API.

Основные аспекты API

В документации Google описан один основной метод — Search, который выполняет "полный веб-поиск". Результаты возвращаются в формате JSON через REST или gRPC. Каждое обращение должно включать клиентский идентификатор партнера, IP-адрес пользователя и поисковый запрос. Указание IP-адреса помогает с региональной маршрутизацией и предотвращает злоупотребления. Пользователи могут получать до 20 результатов за запрос, по умолчанию — 10, с возможностью получения дополнительных страниц с помощью токена. Также доступны фильтры по языку, стране, диапазону дат, включение SafeSearch и сортировка по дате. Ответ включает такие поля, как заголовок, URL, сниппет, MIME-тип, формат файла, оценочное общее количество результатов и исправленный запрос, если Google предлагает его.

Ограниченный доступ

В документации пользователи обозначены как "программные партнеры". На странице введения объясняется, что запросы связаны с партнерским соглашением через клиентский идентификатор. Этот идентификатор имеет стандартный формат, включающий детали, такие как партнер, название, продукт и набор функций. Это отличает сервис от API, который разработчик может активировать в проекте Google Cloud и начать использовать сразу. Однако в документации нет информации о том, как компания может стать партнером, какова стоимость сервиса или какие ограничения по запросам могут быть установлены.

Переход на Search API

В январе Google объявил, что Programmable Search Element, их виджет поиска по сайту, теперь будет сосредоточен на поисках по 50 или менее доменам. Они указали на потребности предприятий, такие как разговорный поиск и использование Vertex AI Search. Для партнеров, желающих искать за пределами набора сайтов, Google предложил решение для полного веб-поиска для "тех, кто требует нашего полного индекса". Заинтересованные партнеры могут зарегистрироваться, заполнив форму. Google пока не предоставил подробной информации о функциях или ценах. Пользователи Search Element, которые ищут на более чем 50 доменах или по всему вебу, должны будут перейти на другое решение до 1 января 2027 года. Тот же срок применяется к пользователям Custom Search JSON API, и на странице обзора API теперь указано, что API закрыт для новых клиентов и будет прекращен в указанную дату. Web Search Service API соответствует требованиям полного веб-поиска по двум пунктам: он выполняет полный веб-поиск и ограничен партнерами. На 11 сентября ни пост от января, ни обновленные страницы не упоминают друг о друге.

Значение обновлений

Объявление Google в январе содержало форму интереса для разработчиков, которым нужны результаты полного веб-поиска, но не включало много деталей об этом предложении. Обновленная документация Web Search Service теперь предоставляет гораздо более четкое объяснение того, как работает API, доступный только для партнеров, и что должно содержаться в запросе для его принятия. Пользователи Custom Search JSON API для проектов полного веба все еще не имеют полного пути миграции. Google задокументировал API для полного веба для партнеров, но не сообщил, могут ли текущие пользователи перейти на него или какие требования должны быть выполнены для того, чтобы стать партнерами.

Перспективы

Срок 1 января 2027 года остается в силе. В то же время ожидайте обновлений о праве на партнерство, стоимости, ограничениях по запросам и о том, будет ли Web Search Service API обозначен как путь для пользователей Custom Search, нуждающихся в полном веб-поиске. Пост от января все еще направляет пользователей Custom Search, которым нужны результаты полного веба, к форме интереса. Документация Web Search Service не объясняет, как компания может получить необходимое партнерское соглашение.