Merchant API

Как работает

Merchant API позволяет программам делать то, что человек делает в Merchant Center. Он добавляет и обновляет товары, управляет остатками, источниками данных и промоакциями, читает проблемы аккаунта. Кроме того, он выдаёт отчёты об эффективности по методам маркетинга: реклама или бесплатные результаты. Наше руководство объясняет, где смотреть эффективность бесплатных листингов.

Это переработанный Content API for Shopping, разделённый на подчинённые API; у каждого своя версия в адресе, например products/v1. Чтобы обратиться к нему, разработчик связывает проект Google Cloud с аккаунтом Merchant Center и входит через OAuth или сервисный аккаунт.

Срок отключения Content API for Shopping наступил 18 августа 2026 года. С 1 сентября 2026 года запросы к нему без действующего продления время от времени завершаются ошибкой HTTP 410. Google планирует полностью выключить его в начале 2027 года. Что это ломает в инструментах для работы с фидами, разобрано в нашем руководстве Переход на Merchant API.

Где это видно

• Портал: раздел «Фид и Merchant Center» читает каталог и отчёты через Merchant API v1 и ничего не меняет в фиде.

Пример

Пример на вымышленном магазине, числа не клиентские.

Собственный скрипт магазина посуды обновляет цену обеденного сервиза с идентификатором предложения ds-24 в его немецком фиде. В Content API идентификатор товара был online:de:DE:ds-24. В Merchant API он de~DE~ds-24: часть с каналом (online) исчезла, а тильды заменили двоеточия.

Цена 600 теперь уходит как amountMicros: 600000000, потому что Merchant API ожидает суммы в миллионных долях. Скрипт, который по-прежнему строит старый идентификатор или отправляет просто 600, нужно переписать.

Не путать с

• Google Ads API — интерфейс к кампаниям, ставкам и рекламным отчётам. Merchant API охватывает данные о товарах и аккаунт Merchant Center.

Верное и неверное прочтение

• Неверно: «Мы синхронизируем товары через приложение Google & YouTube на Shopify, значит, нам нужно мигрировать». Верно: Google говорит, что если данные синхронизирует технологический партнёр, переход выполняет партнёр, а вам ничего делать не нужно. Проверьте скрипты и интеграции, которые вы создали сами.

Источники

• Overview of Merchant API (на английском) — что он обслуживает, подчинённые API, доступ. Проверено 02.10.2026.
• Migrate from Content API for Shopping to Merchant API (на английском) — идентификаторы, цены в микроединицах, приложения партнёров. Проверено 02.10.2026.
• Deprecation and sunset (Content API for Shopping, на английском) — даты и HTTP 410. Проверено 02.10.2026.
• Performance reports (Merchant API, на английском) — сегменты по методам маркетинга. Проверено 02.10.2026.