Google Content API for Shopping был выведен из эксплуатации 18 августа 2026 года. С 1 сентября запросы из проектов без одобренного продления периодически завершаются ошибкой HTTP 410, а в начале 2027 года эндпоинты будут полностью отключены (уведомление Google о прекращении поддержки). Если скрипт, плагин или собственный коннектор всё ещё отправляет ваши товары в Merchant Center через старый API, часть этих обновлений уже теряется.
Это руководство предназначено для разработчиков и владельцев фидов, которые сами поддерживают такой конвейер. Прочитав его, вы сможете найти все оставшиеся вызовы Content API, сопоставить каждый из них с аналогом в Merchant API, создать источник данных, которого требует новый API, и убедиться в Merchant Center, что товары и цены по-прежнему поступают.
Как понять, что вас затронуло отключение
Сбой легко пропустить, потому что он возникает периодически. Google описывает тело ошибки как 410 с сообщением, которое начинается со слов «Content API for Shopping was sunset on August 18, 2026»; в нём указаны ID и номер вашего проекта Google Cloud и ссылка на справочный центр. Поищите эту строку, а также shoppingcontent.googleapis.com, в журналах вашей интеграции.
Обычно ещё до того, как кто-то заглянет в журнал, проявляются три симптома:
- Изменения цен или наличия доходят до Google с опозданием на несколько часов или только при некоторых запусках.
- Ежедневное задание сообщает об успехе для большинства пакетов и о сбое для нескольких.
- Merchant Center показывает устаревшие данные, хотя в магазине указана правильная цена.
У последнего симптома есть и вторая возможная причина — автоматические обновления товаров Google, которые перезаписывают ваши значения. Мы разбираем это отдельно в статье о том, как запретить Google незаметно перезаписывать цену и наличие в вашем фиде. Сначала исключите ошибки 410, потому что их проще подтвердить.
Шаг 1. Составьте перечень всех источников вызовов старого API
Google рекомендует проверить код приложения на наличие прямых вызовов эндпоинтов Content API. На практике вызовы прячутся в четырёх местах: в плагине Google для вашей платформы магазина, в собственном скрипте, написанном предыдущим разработчиком, в промежуточном ПО для фидов или ERP и в скрипте Google Ads или Apps Script, который кто-то запланировал много лет назад.
Составьте короткий реестр — по одной строке на каждый источник вызовов. Укажите, что он делает, через какой проект Google Cloud проходит аутентификацию и кто за него отвечает. ID проекта важен, потому что продления и сообщение 410 привязаны именно к нему.
| Источник вызовов | Что отправляет | Ответственный | Действие |
|---|---|---|---|
| Плагин магазина | Весь каталог, ежедневно | Поставщик платформы | Узнать, какую версию API он использует сейчас |
| Скрипт остатков | Цены и остатки, ежечасно | Ваш разработчик | Перевести на Merchant API |
| Инструмент управления фидами | Оптимизированный фид | Поставщик инструмента | Запросить письменное подтверждение миграции |
Если подключением управляет поставщик, ваша задача — спросить, а не переделывать. Productsup и Feedonomics опубликовали материалы о миграции, и зрелый поставщик уже должен был перейти. Задайте каждому поставщику из списка один и тот же вопрос и сохраните ответы.
Шаг 2. Решите, нужно ли вам продление
Google предлагает форму запроса на продление Content API для организаций, которым нужно больше времени. Одобренное продление защищает проект от плановых ответов с ошибками на одобренный период и не действует после окончательного отключения в начале 2027 года. Google не уточняет, кто может получить продление.
Используйте простое правило. Если все источники вызовов можно перевести и протестировать за несколько недель, пропустите продление и потратьте это время на миграцию. Если источник вызовов принадлежит поставщику, который подтвердил миграцию, но не назвал сроков, запросите продление только для этого проекта. Продление — это запас времени, а не план.
Шаг 3. Сопоставьте каждый вызов с аналогом в Merchant API
Merchant API разделяет прежний монолит на под-API и указывает версию в URL (/products/v1/). Версия v1 стала общедоступной в июле 2025 года, а v1beta была выведена из эксплуатации 28 февраля 2026 года, поэтому разрабатывайте под v1 и игнорируйте любые найденные руководства по v1beta (примечания к выпускам Merchant API).
| Content API | Merchant API | Что меняется |
|---|---|---|
products.insert | productInputs.insert | Требуется параметр запроса dataSource |
products.update | productInputs.patch | Постоянное обновление одного входного набора данных товара |
products.delete | productInputs.delete | Требуется параметр dataSource |
products.get / list | products.get / list | Возвращает обработанный товар, только для чтения |
productstatuses.get / list | products.get / list | Статус теперь входит в ресурс Product |
custombatch | Параллельные асинхронные вызовы | Метода customBatch нет |
datafeeds | dataSources | Каждый источник данных относится к одной метке фида и одному языку |
Источник: сопоставление для миграции товаров и сопоставление источников данных от Google. Концептуальное изменение — разделение на ProductInput, то есть исходные данные, которые вы записываете, и Product, то есть обработанный результат, доступный только для чтения. Обработанный товар формируется из одного основного входного набора и любых дополнительных наборов после применения правил фида (обзор товаров).
Шаг 4. Создайте источник данных API до любой вставки
Именно на этом шаге ломается большинство первых миграций. Content API автоматически создавал источник данных «Content API» при первой вставке. Merchant API этого не делает. Google указывает, что нужно создать как минимум один источник данных типа API и что под-API Products может записывать только в источники данных этого типа (миграция источников данных).
Теперь каждый источник данных соответствует одной комбинации feedLabel и contentLanguage. Если вы обслуживали Турцию на турецком и ОАЭ на английском из одного фида с несколькими целевыми странами, теперь вам нужны отдельные источники данных. Создайте их через под-API Data Sources или в Merchant Center, а затем используйте полученное имя ресурса в формате accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} при каждой записи.
Шаг 5. Перепишите полезную нагрузку: разбор на примере
Большинство ошибок вызывают три изменения полей. Цена переходит из десятичной строки в целое число микроединиц (micros), где один миллион микроединиц равен одной денежной единице. Атрибуты товара переносятся в объект productAttributes. А targetCountry заменяется на feedLabel, тогда как channel исчезает.
Старый идентификатор товара выглядел так, а новый использует тильды и не содержит канала:
Content API: online:en:US:SKU12345
Merchant API: en~US~SKU12345
Входные данные товара, которые Google приводит в качестве примера в своём руководстве, выглядят так (вставка через POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}):
{
"offerId": "SKU12345",
"contentLanguage": "en",
"feedLabel": "US",
"productAttributes": {
"title": "Classic Cotton T-Shirt",
"link": "https://www.example.com/p/SKU12345",
"imageLink": "https://www.example.com/img/SKU12345.jpg",
"availability": "IN_STOCK",
"price": { "amountMicros": "15990000", "currencyCode": "USD" },
"condition": "NEW",
"gtins": ["9780007350896"]
}
}
Сравните со старой структурой: "price": {"value": "15.99", "currency": "USD"} превращается в amountMicros и currencyCode, а наличие становится перечислением (enum), поэтому in stock превращается в IN_STOCK. Источник: руководство Google по добавлению товаров и управлению ими.
Для турецкой лиры 1 249,90 TRY — это "amountMicros": "1249900000". Вычисляйте микроединицы целочисленной арифметикой по минимальной денежной единице, а не умножением числа с плавающей точкой, иначе вы отправите 1249899999 и будете гадать, почему цены расходятся на копейки.
Кроме того, используйте новое поле versionNumber, когда один и тот же товар записывают несколько заданий. Оно не позволяет более старому обновлению перезаписать более новое, если запросы приходят не по порядку.
Шаг 6. Замените пакетную обработку и считывайте статус из товара
customBatch больше нет. Замените его параллельными асинхронными запросами, ограничьте степень параллелизма и повторяйте только неудавшиеся запросы. Ведите журнал результатов по каждому предложению, чтобы частичный сбой не превратился незаметно в устаревший каталог.
Для получения статуса перестаньте вызывать productstatuses. Вместо этого считывайте обработанный Product, который содержит свой статус. Google отмечает, что между вставкой или обновлением и появлением итогового товара может пройти несколько минут, поэтому чтение сразу после записи не является проверкой на сбой.
Шаг 7. Проверьте всё, прежде чем отключать старый путь
Сначала запустите новый путь на небольшом, малорискованном срезе, например на 50 товарах с одной меткой фида. Затем оцените переход по этому чек-листу. Каждый пункт должен получить ответ «да», прежде чем вы выведете из работы старый источник вызовов.
- Источник вызовов проходит аутентификацию в зарегистрированном вами проекте и семь дней подряд не получает ошибку 410.
- Для каждой обслуживаемой пары «метка фида — язык» существует источник данных типа API.
- Для тестового среза обработанный товар совпадает с вашим эталонным источником по цене, наличию и ссылке.
- Больше ничто не записывает те же ID предложений из старого источника данных.
- Неудавшиеся предложения журналируются и отправляются повторно, а не теряются.
- У всех источников вызовов из вашего реестра, которыми управляют поставщики, есть письменное подтверждение миграции.
Четвёртый пункт заслуживает особого внимания. Второй источник записи для того же ID предложения — например, старый источник вызовов и новый источник данных API — как раз и приводит к конфликтующим значениям. Решите, какой источник отвечает за каждый товар, и удалите другой.
Где это руководство не работает
Мы написали его на основе опубликованной документации Google и не переносили ваш код. Ряд вопросов остаётся за его рамками. Google не указывает критерии для продления, поэтому мы не можем сказать, будет ли одобрен конкретный проект. Обзор товаров не документирует сроки точнее, чем «несколько минут», поэтому любые более строгие ожидания по задержке вам придётся измерять самостоятельно. Местные остатки, региональные остатки, промоакции и отзывы имеют собственные подресурсы в Merchant API, и их сопоставление мы здесь не рассматривали.
Если вы вообще не хотите поддерживать интеграцию с API, управляемая платформа для фидов будет лучшим решением, чем переписывание. Productsup и Feedonomics публикуют рекомендации по миграции на Merchant API, и для корпоративной команды с нестандартными моделями данных любая из них может подойти лучше, чем наше решение. Наше решение именно для Google Shopping описано на странице интеграции с Google Merchant Center.
Часто задаваемые вопросы
Работает ли ещё Content API for Shopping?
Ненадёжно. Google сообщает, что API был выведен из эксплуатации 18 августа 2026 года, что с 1 сентября 2026 года запросы без действующего продления начали периодически завершаться ошибкой HTTP 410 и что в начале 2027 года все эндпоинты будут отключены.
Что говорится в ошибке 410 Content API?
Сообщение начинается со слов «Content API for Shopping was sunset on August 18, 2026». Ответ содержит ID и номер вашего проекта GCP, а также ссылку на справочный центр — по ним видно, какой проект нужно перевести или продлить.
Можно ли получить больше времени с помощью продления?
Google предоставляет форму запроса на продление Content API. Одобренное продление защищает ваш проект от плановых ошибок только на одобренный период и не действует после отключения в начале 2027 года.
Почему productInputs.insert запрашивает dataSource?
В Merchant API операции записи относятся к явно указанному источнику данных. В отличие от старого API, он не создаёт источник данных «Content API» при первой вставке, поэтому нужно создать источник данных типа API и передавать его имя ресурса.
Как передавать цены в Merchant API?
Используйте amountMicros в виде целого числа в строке и currencyCode в формате ISO 4217. Один миллион микроединиц равен одной денежной единице, поэтому 15.99 USD — это 15990000.
Поддерживает ли Merchant API пакетную обработку?
Метода customBatch нет. Google рекомендует использовать асинхронные параллельные вызовы, а значит, вам нужно добавить собственное ограничение параллелизма и повторные попытки для каждого предложения.
Куда делся productstatuses?
Статус теперь входит в обработанный ресурс Product. Считывайте его с помощью products.get или products.list, помня, что обработка может отставать от вставки на несколько минут.
На какой версии Merchant API разрабатывать?
На v1, которая стала общедоступной в июле 2025 года. Версия v1beta была выведена из эксплуатации 28 февраля 2026 года, поэтому написанные под неё руководства не сработают.
Проверьте, что на самом деле видит Google
После миграции самый быстрый способ проверки — сравнить исходный фид с тем, что обработал Merchant Center. Прогоните действующий фид через наш бесплатный инструмент аудита товарного фида, чтобы получить оценку полноты и качества, и исправьте всё, что он отметит, до следующего рекламного цикла.

Сооснователь Feedance, использующий свой опыт инженера-программиста и маркетолога для получения аналитических инсайтов. Уделяя особое внимание превращению данных в практические стратегии, он помогает брендам добиваться значительного роста в цифровой среде.
LinkedIn


















