Как исправить ошибку доступа к Google Custom Search JSON API

Ошибка «This project does not have the access to Custom Search JSON API» при работе с Google Custom Search JSON API возникает из-за закрытия сервиса для новых клиентов — это официальная политика Google. Даже если биллинг включен, квоты в норме, роль Owner и ключ без ограничений, новый проект не получит доступ, пока не мигрируете на Vertex AI Search или не используете альтернативы вроде SerpApi. Существующие клиенты имеют время до 1 января 2027 года, но для публичного использования сейчас это не вариант без перехода.

---

Содержание

• Что такое Google Custom Search JSON API и почему ошибка доступа
• Основные причины ошибки Google Custom Search API
• Шаги по устранению неисправностей для Google Search API key
• Как включить Custom Search JSON API в Google Cloud Console
• Миграция на Vertex AI Search как основное решение
• Настройка Programmable Search Engine и CX для Google Custom Search
• Альтернативы Google Custom Search JSON API
• Ценообразование, квоты и мониторинг
• Источники
• Заключение

---

Что такое Google Custom Search JSON API и почему ошибка доступа

Google Custom Search JSON API — это инструмент для программного поиска по веб-страницам или изображениям через ваш собственный Programmable Search Engine. Он возвращает результаты в JSON по спецификации OpenSearch 1.1, идеален для интеграций вроде n8n или скриптов. Но вот засада: с недавних пор официальная документация прямо заявляет, что API закрыт для новых клиентов.

Почему именно ваша ошибка? Пользователи на Stack Overflow жалуются на то же самое — даже после создания нового проекта и ключа. Google рекомендует Vertex AI Search для поиска по до 50 доменам или форму для полного веб-поиска. А публичный доступ? Для новых аккаунтов — нет, это не миф. Если вы пробовали через браузер или Console, увидели то же самое.

И да, это не баг в вашем troubleshooting. Google Cloud AI-ассистент мог пропустить ключевой момент: сервис уходит в историю.

---

Основные причины ошибки Google Custom Search API

Давайте разберемся по пунктам. Первая и главная — политика Google: Custom Search JSON API больше не активируется для свежих проектов. Документация четко пишет: “closed to new customers”. Существующие до 2027 года, но новые — стоп.

Вторая причина — отсутствие включенного API в проекте. Даже с Owner-ролью и биллингом, если Custom Search API не enabled в Library, привет ошибка. Третья: неправильный CX (Search Engine ID) или ключ без привязки к проекту.

А что насчет n8n или браузера? Там запросы идут с параметрами key и cx, но без доступа к API на уровне проекта — фейл. Пользователи отмечают, что квоты и ограничения ключа здесь ни при чем, если сервис заблокирован системно. Шок? Да, Google закрывает старые API в пользу AI-новинок.

Интересно, пробовали ли вы старый проект? Если да — сработает. Нет — вот почему persists.

---

Шаги по устранению неисправностей для Google Search API key

Вы уже прошли базовый чек — молодец. Но давайте углубимся. Сначала: в Google Cloud Console перейдите APIs & Services > Library, найдите “Custom Search API” и нажмите Enable. Если кнопки нет или ошибка — подтверждение блокировки для новых.

Проверьте ключ: Credentials > Create Credentials > API Key. Установите HTTP referer restriction на https://cse.google.com/* или без, IP — на ваш. Тестируйте запрос: https://www.googleapis.com/customsearch/v1?key=YOUR_KEY&cx=YOUR_CX&q=test.

Если persists — IAM: убедитесь в ролях Editor/Owner. Биллинг: Billing > Link project. Квоты: Quotas > Custom Search API > Requests — должно быть 100 free/day.

Но стоп. На Stack Overflow советуют: это не поможет новым проектам. Создайте PSE заново? Попробуйте, но без API-доступа — зря.

Коротко: если все checks green, но ошибка — мигрируйте.

---

Как включить Custom Search JSON API в Google Cloud Console

Шаг за шагом, если проект “старый” или повезет.

1. Console > APIs & Services > Library.
2. Поиск “Custom Search API” — Enable.
3. Credentials > API Key (без рефереров сначала).
4. PSE: https://programmablesearchengine.google.com/controlpanel/create — создайте, скопируйте CX.

Тест: curl “https://www.googleapis.com/customsearch/v1?key=API_KEY&cx=CX&q=котики”.

Не сработало? Migration guide подтверждает: для новых — Vertex AI. Включите там: AI Applications > Vertex AI Search > Enable.

Почему не всегда работает? Google фазаутает сервис. В n8n: node HTTP Request с теми же params.

---

Миграция на Vertex AI Search как основное решение

Вот реальный фикс. Google толкает на Vertex AI Search в Generative AI App Builder. Инструкция по миграции:

1. Console > Vertex AI > Search & Conversation > Create app.
2. Site search with AI, Enterprise edition, отключите Generative Responses для аналога Custom Search.
3. Datastores: импортируйте сайты из PSE.
4. Deploy app — получите endpoint.

Для ключей: searchLite method с key (ограничение на discoveryengine.googleapis.com/*). OAuth для полного.

В n8n: смените endpoint на https://discoveryengine.googleapis.com/v1/projects/.../locations/global/collections/default_collection_engines/…:searchLite.

Преимущества? AI-улучшения, больше доменов. Минус: только ваш сайт, не full web. Но для custom — ок.

Звучит сложно? 15 минут — и работает.

---

Настройка Programmable Search Engine и CX для Google Custom Search

PSE — предпосылка. https://programmablesearchengine.google.com/controlpanel/all > Create.

• Sites to search: добавьте домены.
• Overview > Details > Search engine ID (CX).

Параметры запроса: q=запрос, key=…, cx=…, num=10, start=1.

Введение в API: только list method (GET /customsearch/v1). Для site restrict — /siterestrict.

Без API-доступа CX бесполезен. В браузере: вставьте URL с params — увидите ошибку.

Совет: экспортируйте из старого PSE для миграции.

---

Альтернативы Google Custom Search JSON API

Google закрыл — не беда. SerpApi: full web search, JSON, $50/5000 запросов. serper.dev: дешево, просто API key.

Другие:

• Tavily: AI-optimized.
• Bing Search API: Microsoft аналог.
• Exa.ai: для research.

В n8n: HTTP node на их endpoints. На Stack Overflow хвалят SerpApi за drop-in замену.

Хотите full web? Заполните форму Google.

---

Ценообразование, квоты и мониторинг

Бесплатно 100 запросов/день, потом $5/1000 до 10k/day. Мониторинг: Cloud Console > APIs & Services > Dashboard или Operations (service=‘customsearch.googleapis.com’).

Vertex AI: pay-per-use, дешевле для больших объемов. SerpApi: tiered pricing.

Квоты reset daily UTC. Превысили? Wait или quota increase request.

Для продакшена — alerts на usage.

---

Источники

1. Custom Search JSON API Overview — Официальное объявление о закрытии API для новых клиентов и альтернативах: https://developers.google.com/custom-search/v1/overview
2. Stack Overflow Thread — Обсуждение ошибки с рекомендациями по SerpApi и Vertex AI: https://stackoverflow.com/questions/79875238/im-getting-this-project-does-not-have-the-access-to-custom-search-json-api-wh
3. Migrate from CSE to Vertex AI — Подробная инструкция по миграции и включению Vertex AI Search: https://cloud.google.com/generative-ai-app-builder/docs/migrate-from-cse
4. Custom Search JSON API Introduction — Предпосылки, CX и методы API: https://developers.google.com/custom-search/v1/introduction
5. Custom Search JSON API Reference — Справочник методов list и siterestrict: https://developers.google.com/custom-search/v1/reference/rest
6. Programmable Search Engine Control Panel — Создание PSE и получение CX: https://programmablesearchengine.google.com/controlpanel/all
7. Google Full Web Search Interest Form — Форма для запроса полного веб-поиска: https://docs.google.com/forms/d/e/1FAIpQLSfYcIpOzj57MoetWyeFpJf9Cf4yezG5HDq3VsqbJhlngp5pXw/viewform

---

Заключение

Ошибка доступа к Google Custom Search JSON API — сигнал к миграции: Vertex AI Search решит 90% кейсов быстро и бесплатно на старте. Альтернативы вроде SerpApi подойдут для full web без головной боли. Не тратьте время на новые проекты — фокусируйтесь на переходе, и поиск заработает. Удачи с n8n!