Search Console API — программный доступ к отчётам и рычагам кабинета Google: search analytics, список свойств, карты сайта, URL Inspection. Это не недельное чтение интерфейса Google Search Console и не Indexing API для JobPosting. Хаб — Google SEO. Как в принципе вешать кабинеты на cron — API в SEO-процессах. Витрина выдачи — Google Search.
Кто ходит по URL — Googlebot. Решение положить документ в индекс API не принимает — это индексация Google. Служебная карта — sitemap.xml для Google.
Кабинет, API и соседние продукты Google
| Слой | Зачем | Чего не делает |
|---|---|---|
| Search Console (UI) | Раз в неделю смотреть срезы и одну проверку URL | Не ночной дамп тысяч строк и не CI |
| Search Console API | Тот же контур программно: аналитика, sitemaps, sites, inspect | Не мгновенный индекс и не «кнопка в топ» |
| Indexing API | Пинг JobPosting / BroadcastEvent | Не каталог услуг и не блог. Другой endpoint |
| Bulk Data Export | Выгрузка в BigQuery без поточечных query | Не замена inspect и не управление sitemap |
Путать имена в тикете нельзя. «Залить сайт через API» чаще про Indexing API, который Google для обычных URL не открыл. «Сверить клики за 16 месяцев» — Search Console API или Bulk Export. Ежедневный клик «запросить индексирование» в UI API не масштабирует в пакетный краул каталога.
Какие методы реально нужны в проде
searchanalytics.query. Показы, клики, CTR, средняя позиция по измерениям query, page, country, device, date, searchAppearance. Тип поиска — web / image / video / news / discover / googleNews: не складывайте в одну линию, как в кабинете. Последние дни неполные, лаг как в UI — около двух суток, не «сегодня как Метрика».
urlInspection.index.inspect. Программный близнец проверки URL: индексный статус, роботы, каноникал, last crawl. Это карточка одного адреса, не сводка «Страницы». Лимиты Google режет; сжигать inspect на пагинации фильтров — типичный вечер впустую.
sitemaps.list / submit / delete. То, что кабинет показывает в разделе карт. Submit не заставляет сканирование обойти все URL сегодня. Сначала валидный sitemap, потом API, не наоборот.
sites.list. Какие свойства видит токен. Если подрядчик «не видит сайт», это право в Search Console и Cloud-проект, не баг метода query.
Авторизация — OAuth пользователя или сервис с делегированием, у аккаунта должно быть право на свойство. Ключ в репозитории и токен на ноутбуке уволенного подрядчика — дыра, не интеграция. Квоты Google меняет; конкретных чисел «запросов в день на РФ» не выдумываем: смотрите текущую квоту проекта, не статью 2019 года.
Как не соврать цифрой
- Зафиксируйте поисковый тип, страну, устройство и агрегацию (byPage vs byProperty). Сумма строк query часто меньше итога UI: обрезка редкого хвоста и сэмплирование — ожидаемое поведение Search Analytics, не «API сломался».
- Не сравнивайте сегодняшний GA4 с GSC API «за сегодня». Кабинет описывает витрину с лагом. Релиз title помечайте в своей таблице, иначе любой всплеск станет «нас апдейтнуло» без окна на Google Updates.
- Inspect — точечный диагноз после деплоя шаблона, не ночной обход 50 тысяч URL. Для покрытия карты смотрите sitemap и отчёт индексирования в UI, не цикл inspect.
- Не подменяйте API еженедельное чтение кабинета. График свойства и таблица страниц по-прежнему расходятся по методике Google. API ту же методику отдаёт, только без кликов мышью.
- Если пайплайн рисует красиво, а очередь задач пустая — это дашборд ради дашборда. Смысл: расхождение sitemap vs индекс, денежные URL с показами и мёртвым CTR, регресс после выкладки. Смешанная картина без гипотезы — постановка SEO-аудита, не новый ключ в Cloud.
Ограничение. Нет замера «какой процент агентств РФ ходит в searchanalytics.query» и нет вечной таблицы квот. Поля ответа Google дополняет; перед спором откройте текущий Search Console API, не SDK 2015 года. Вебмастер API и коннектор Sheets — соседние контуры, не этот H1.
Частые вопросы
Заменяет ли Search Console API кабинет Google Search Console?
Нет. API забирает те же отчёты и часть действий без мыши. Срезы, проверка одного URL руками и письма о мерах остаются в кабинете.
Можно ли через Search Console API загнать весь сайт в индекс?
Нет. Это не Indexing API и не пакетный «запросить индексирование» на каталог. Submit sitemap и inspect одного URL не отменяют robots, noindex и очередь краула.
Почему сумма строк API меньше графика в интерфейсе?
Чаще обрезка редких запросов, сэмплирование, другой набор измерений или неполный последний день. Сверяйте фильтры и смотрите тренд, не абсолют из двух мест.
Нужен ли разработчик, если уже есть выгрузка в Sheets?
Не всегда. Коннектор закрывает дамп. Код нужен, когда склеиваете inspect, sitemap и свои пороги в CI. Сам факт API позиции не двигает.