Google Indexing API: для каких страниц работает и как подключить

Что такое Google Indexing API

Indexing API отправляет Google уведомления о конкретных адресах. Типов уведомлений два:

• URL_UPDATED — по адресу появилась новая страница или изменился контент;
• URL_DELETED — страница удалена с сервера или закрыта метатегом noindex.

По каждому адресу можно запросить, когда Google в последний раз получал уведомления каждого типа. В русскоязычных материалах интерфейс иногда называют «индекс API».

Запросы отправляет не человек в браузере, а программа. Она работает от имени сервисного аккаунта, который добавлен делегированным владельцем сайта в Search Console.

Indexing API, Search Console API и проверка URL — не одно и то же

Инструмент	Для чего	Для каких страниц
Indexing API	Уведомить Google, что адрес новый, обновлён или удалён	Только страницы с JobPosting или BroadcastEvent в VideoObject
«Запросить индексирование» в инструменте проверки URL	Вручную запросить сканирование отдельной страницы. Число запросов в день ограничено, индексирование не гарантируется	Отдельные страницы вашего ресурса в Search Console
Файл Sitemap	Сообщить Google о большом количестве страниц	Важные адреса сайта
Search Console API	Программный доступ к большей части функций Search Console: ресурсы, файлы Sitemap, данные о результатах поиска, проверка отдельных страниц	Ресурсы, которыми вы управляете в Search Console

«Search Console API» и «Indexing API» часто путают. Первый даёт данные и управление ресурсом, второй отправляет уведомления о страницах. Отправки страниц на индексирование в обзоре Search Console API нет.

Для каких страниц работает Indexing API

Вакансии и прямые трансляции

Документация называет два типа страниц:

• вакансии со структурированными данными JobPosting;
• прямые трансляции с BroadcastEvent, встроенным в объект VideoObject.

Структурированные данные — разметка в коде страницы, которая описывает её содержимое в формате, понятном поисковой системе. Подробнее о том, что такое структурированные данные Schema.org, — в отдельной статье.

Google объясняет, зачем API таким страницам. На сайтах, где много страниц с коротким жизненным циклом, отдельные уведомления об обновлениях помогают показывать в поиске актуальный контент. В справке о разметке вакансий Google рекомендует для их адресов Indexing API, а не файлы Sitemap.

Прежде чем подключать API, проверьте, что разметка на страницах действительно есть и в ней нет ошибок. Для этого в справке Google назван инструмент проверки расширенных результатов.

Что документация говорит об остальных страницах

Других типов страниц в документации Indexing API нет. Документация формулирует это как ограничение: API поддерживает только страницы с JobPosting или BroadcastEvent в VideoObject.

В блогах встречается совет отправлять через API любые страницы: статьи, товары, услуги. Документация Google такого использования не описывает. Для обычных страниц Google предлагает другие способы: проверку URL для отдельных адресов и файл Sitemap для большого количества страниц.

Руководство также предупреждает: попытки неправильного использования API, например несколько аккаунтов или иные способы превысить квоты, могут привести к запрету доступа. Добавлять разметку вакансий на страницы без вакансий ради доступа к API не стоит: такая разметка уже не описывает страницу, а обходит ограничение.

Что API делает и чего не гарантирует

На успешный запрос API отвечает кодом HTTP 200. По документации это значит, что Google может в ближайшее время ещё раз просканировать страницу по этому адресу. О попадании страницы в индекс и её месте в поиске такой ответ ничего не говорит.

URL_DELETED — тоже уведомление, а не кнопка удаления. Его отправляют, когда страница уже удалена с сервера или закрыта от индексирования. Перед запросом адрес должен отвечать кодом 404 или 410 либо содержать метатег robots со значением noindex. Успешный ответ на такое уведомление означает, что Google может удалить адрес из индекса. Само уведомление страницу не закрывает: сначала меняют ответ сервера или добавляют метатег. О том, как закрыть страницу от индексации или убрать её из поиска, — в отдельной статье.

Как подключить Indexing API: шаги по документации Google

Шаги имеют смысл, только если на сайте есть страницы с JobPosting или BroadcastEvent. Порядок по документации:

1. Создать проект и включить Indexing API.
2. Создать сервисный аккаунт и ключ.
3. Добавить сервисный аккаунт владельцем сайта в Search Console.
4. Получить токен доступа.
5. Запросить одобрение и увеличение квоты.
6. Отправлять уведомления и проверять их статус.

Названия разделов и кнопок в консолях меняются. Поэтому ниже — ориентиры, а не перевод инструкции.

Проект и включённый API в Google Cloud

Проект создают в Google API Console — консоли, где управляют проектами Google Cloud и их API. Для первого шага Google предлагает инструмент настройки: он помогает создать проект и включить Indexing API.

Сервисный аккаунт и ключ

Сервисный аккаунт — технический аккаунт, от имени которого программа обращается к API без участия человека. Для него создают ключ, и документация рекомендует формат JSON. Google предупреждает, что скачанный ключ — единственная копия.

Ключ — это секрет. Храните его как пароль: не публикуйте в открытом репозитории и не вставляйте в код страниц сайта.

Права владельца в Search Console

Адрес электронной почты сервисного аккаунта нужно добавить делегированным владельцем сайта в Search Console. В документации это делается в карточке ресурса: в списке подтверждённых владельцев кнопкой «Добавить владельца».

Токен доступа

Каждый запрос к API передаёт токен доступа OAuth — строку, которую программа получает от имени сервисного аккаунта. При получении токена в качестве области действия (scope) указывают https://www.googleapis.com/auth/indexing. Токены можно получить с помощью клиентских библиотек Google API для разных языков программирования.

Отправить уведомление URL_UPDATED или URL_DELETED

Уведомление — POST-запрос к адресу https://indexing.googleapis.com/v3/urlNotifications:publish. В теле запроса передают адрес страницы и тип уведомления. Пример для страницы вакансии на условном сайте:

POST https://indexing.googleapis.com/v3/urlNotifications:publish
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "url": "https://example.ru/vacancies/seo-specialist/",
  "type": "URL_UPDATED"
}

Вместо <ACCESS_TOKEN> подставляют токен доступа. Чтобы сообщить об удалении страницы, в том же запросе указывают "type": "URL_DELETED".

Проверить статус уведомления

Статус запрашивают GET-запросом к адресу https://indexing.googleapis.com/v3/urlNotifications/metadata. Адрес страницы передают в параметре url в процентной кодировке:

GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fexample.ru%2Fvacancies%2Fseo-specialist%2F
Authorization: Bearer <ACCESS_TOKEN>

В ответе — тип и время последнего уведомления: latest_update для URL_UPDATED и latest_remove для URL_DELETED. Сокращённо:

{
  "url": "https://example.ru/vacancies/seo-specialist/",
  "latest_update": {
    "type": "URL_UPDATED",
    "notify_time": "<время отправки уведомления>"
  }
}

Это время отправки уведомлений, а не состояние страницы в индексе.

Пакетные запросы

Чтобы уменьшить число HTTP-соединений, до 100 запросов к Indexing API можно объединить в один HTTP-запрос к адресу https://indexing.googleapis.com/batch.

После подключения удобно проверить цепочку на одной странице. Отправьте URL_UPDATED для одной вакансии и запросите статус уведомления. Затем откройте эту страницу в инструменте проверки URL в Search Console и посмотрите её текущее состояние.

Основной источник по подключению — пошаговая инструкция Google: требования и интерфейсы в ней обновляются.

Квоты и правила использования

Квота по умолчанию, 200 запросов, предназначена для подключения API и проверки отправленных материалов. Для использования сверх неё требуется дополнительное одобрение Google.

Квоты считаются на проект и разделены по методам:

• запросы publish (уведомления URL_UPDATED и URL_DELETED) — 200 в день;
• запросы на чтение getMetadata (статус уведомления) — 180 в минуту;
• все запросы вместе — 380 в минуту.

Текущие квоты своего проекта смотрите в Google API Console. Одобрение и увеличение квоты запрашивают через форму, ссылка на которую есть в документации. Платы за использование Indexing API нет. Значения квот приведены по документации на октябрь 2026 года; перед подключением сверьте их с ней.

Правила использования:

• к контенту, который вы отправляете через API, применяются правила Google в отношении спама;
• все материалы, отправленные через Indexing API, проходят проверку на спам;
• попытки превысить квоты с помощью нескольких аккаунтов или иных средств могут привести к запрету доступа.

Что делать с обычными страницами

Если на сайте нет вакансий и трансляций, API вам не нужен. Ниже — что использовать для обычных страниц.

Файл Sitemap для новых и изменённых адресов

Если нужно, чтобы Google просканировал много страниц, он советует отправить файл Sitemap. Дату изменения lastmod Google учитывает, если она точная; в ней указывают время последнего значительного изменения страницы. О том, как подготовить карту сайта и сообщить о ней поисковикам, — в отдельной статье.

Внутренние ссылки на новые страницы

В первую очередь Google находит страницы, на которые ведут ссылки с других, уже просканированных страниц. Поэтому на новую статью или карточку товара должны вести ссылки из разделов и связанных материалов. О том, как внутренние ссылки помогают находить новые страницы, — в статье о перелинковке.

Проверка URL в Search Console

Для отдельной важной страницы подойдёт инструмент проверки URL: в нём можно запросить сканирование. Число таких запросов в день ограничено, а отправка не гарантирует появления страницы в индексе. О том, что показывают проверка URL и отчёт об индексировании, — в статье об индексации.

Если страница долго не индексируется, причину стоит искать в настройках сайта: robots.txt, noindex, canonical, код ответа. Способ отправки здесь обычно ни при чём. Подробный разбор — почему страница не индексируется и что проверить.

А IndexNow?

IndexNow — протокол, через который сайт автоматически сообщает поисковым системам о новых, обновлённых и удалённых страницах. По данным сайта протокола, его поддерживают Microsoft Bing, Naver, Seznam.cz, Яндекс и Yep. Справка Яндекс Вебмастера тоже подтверждает поддержку IndexNow.

Для Google используйте способы из его документации: файл Sitemap и проверку URL. Как сообщить о новых страницах Яндексу — в статье про переобход страниц в Яндекс Вебмастере.

Итог: чем сообщить Google о странице

Какие страницы	Чем сообщить Google
Вакансии (JobPosting) и прямые трансляции (BroadcastEvent в VideoObject)	Indexing API
Новые и изменённые обычные страницы	Файл Sitemap и внутренние ссылки
Одна важная страница	Проверка URL в Search Console
Страницу нужно убрать из поиска	Удалить её (код 404 или 410) или закрыть noindex; для вакансий и трансляций — затем отправить URL_DELETED

Если страницы сайта не попадают в индекс постоянно, отправлять их повторно бесполезно: сначала нужен разбор настроек индексации: robots.txt, метатегов, canonical, кодов ответа и карты сайта.

Частые вопросы

Можно ли отправлять через Indexing API обычные страницы — статьи, товары, услуги?

Документация Google описывает API только для страниц с JobPosting или BroadcastEvent в VideoObject. Для остальных страниц Google предлагает файл Sitemap и проверку URL. Подробнее — в разделе «Что документация говорит об остальных страницах».

Нужна ли разметка на странице, чтобы отправить её через API?

Да. Тип страницы, для которого предназначен API, определяется структурированными данными: JobPosting для вакансий, BroadcastEvent в VideoObject для трансляций.

Гарантирует ли успешный ответ API, что страница появится в поиске?

Нет. Код HTTP 200 означает, что Google может в ближайшее время повторно просканировать адрес. Решение об индексировании Google принимает отдельно.

Удаляет ли URL_DELETED страницу из поиска?

Само по себе — нет: это уведомление. До его отправки страница должна отвечать кодом 404 или 410 либо содержать метатег noindex. После успешного ответа Google может удалить адрес из индекса.

Сколько URL можно отправить в день?

По умолчанию квота — 200 запросов на публикацию уведомлений в день на проект. Она предназначена для подключения и проверки, а для использования сверх неё нужно одобрение Google. Значения могут меняться, текущие — в Google API Console.

Работает ли Indexing API для Яндекса?

Нет, это интерфейс Google. Яндекс поддерживает протокол IndexNow — подробнее в разделе «А IndexNow?».