SiteHub
Авторизація
Реєстрація Забули пароль?
Прес-релізи

Content API for Shopping закрито - перехід на Merchant API v1 для інтернет-магазинів

Content API for Shopping закрито - перехід на Merchant API v1 для інтернет-магазинів

Google офіційно закрив Content API for Shopping 18 серпня 2026 року. Інтерфейс, через який продавці більше десятиліття передавали дані про товари в Merchant Center, поступається місцем Merchant API v1 — модульній архітектурі з окремими суб-API під кожен домен даних. Магазини, що досі викликають shoppingcontent.googleapis.com з власного коду, отримали чіткий графік згасання сервісу та обовʼязок перевести інтеграцію на нову платформу.

Графік згасання сервісу

Google опублікував трирівневий календар припинення роботи старого API. Дата 18 серпня 2026 року зафіксована як офіційна дата закриття (sunset). З 1 вересня 2026 року запити від клієнтів без активного розширення доступу починають переривчасто повертати HTTP 410 Gone з розширеним payload помилки, що містить ідентифікатор GCP-проєкту, номер проєкту та посилання на посібник з міграції. Повне відключення ендпоінтів заплановане на початок 2027 року — після цієї дати жоден виклик до старих URL не пройде.

Помилка 410 Gone супроводжується структурою error.details типу google.rpc.ErrorInfo з reason: content_api_sunset та доменом shoppingcontent.googleapis.com. Цей код варто відловлювати в моніторингу та алертингу — саме він служить сигналом того, що частина інтеграції ще працює на застарілому інтерфейсі.

Модульна архітектура Merchant API v1

Merchant API оголошений загальнодоступним (GA) влітку 2025 року. Базовий домен змістився з content.googleapis.com на merchantapi.googleapis.com зі структурою URL {SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}. Google розділив монолітний інтерфейс на кілька субʼAPI: products, inventories, accounts, datasources, reports, promotions, lfp та інші. Кожен модуль версіонується самостійно, що дозволяє команді Google розвивати окремі напрямки без ризику зламати сумісність усього API.

Ідентифікація ресурсів побудована за AIP-специфікацією: замість пари merchantId + productId вживається імʼя ресурсу виду accounts/4321/products/online~en~US~1234. Роздільник у продуктовому ідентифікаторі змінився з двокрапки на тильду — ця дрібниця впливає на всі клієнтські бібліотеки, кеші та внутрішні реєстри, де раніше зберігалися ідентифікатори в старому форматі.

Ціни перевели з десяткових рядків у формат amountMicros типу int64, де 1 000 000 мікро дорівнюють одній одиниці валюти. Значення 29.99 USD передається як 29990000. Зміна виправляє історичні неточності обробки плаваючої коми та вимагає перевірки конверсії у всіх точках, де формуються фіди — приховані баги округлення здатні занизити або завищити ціну всього каталогу.

Метод customBatch з v2.1 в новому API відсутній без прямого замінника. Google рекомендує паралельні виклики окремих ендпоінтів з використанням Data Sources для великих обʼємів. Команди, які покладалися на customBatch для щогодинної синхронізації десятків тисяч SKU, отримують окремий напрямок роботи з перепроєктуванням циклу оновлень.

Кого міграція не стосується

Обовʼязок переходу лежить на командах, що викликають Google API з власного бекенду. Три наступні сценарії залишаються поза периметром міграції:

  1. Ручне завантаження файлів з фідами через інтерфейс Merchant Center.
  2. Заплановане завантаження за URL (scheduled fetch).
  3. Джерела даних на базі Google Sheets.

Ці канали продовжують працювати за колишньою логікою.

Багато B2C-магазинів на Shopify, WooCommerce та інших SaaS-платформах передають товари через застосунки самої платформи. У такому випадку відповідальність за міграцію лежить на розробнику застосунку — власнику магазину достатньо переконатися, що вендор випустив оновлення з підтримкою Merchant API v1. Перевірити тип джерела можна в Merchant Center у розділі Data Sources: позначка "Content API" сигналізує про потребу дії до 18 серпня 2026 року.

Для команд, які фізично не встигають завершити перенос, Google додав механізм extended access — форму запиту на продовження доступу до Content API. Заявка розглядається індивідуально, потребує обґрунтування та не гарантує позитивного рішення. Розглядати цей механізм як штатну стратегію не варто: продовження стосується інтерфейсу, у розвиток якого Google вже не інвестує.

Посібник з міграції Google

Офіційний посібник з міграції розміщений на developers.google.com/merchant/api та охоплює покроковий переклад інтеграції: заміну облікових даних OAuth і сервісних акаунтів, перебудову моделей ресурсів у клієнтському коді, ремапінг полів фіду, оновлення обробки помилок під новий формат ErrorInfo, міграцію звітності. Кожна сторінка розділу відкривається блоком з датою sunset і посиланням на форму розширеного доступу.

Разом з міграцією 22 квітня 2026 року Google Ads Scripts Editor отримав підтримку Merchant API як Advanced API — це закрило залежність рекламних скриптів від старого інтерфейсу. Оновлення дозволило рекламодавцям переписати скрипти автоматизації Performance Max, Shopping-кампаній і фідів прямо в редакторі Google Ads.

Інтеграція магазинів на OpenCart з Merchant API

Український розробник OpenCartBot, офіційний партнер OpenCart, випустив модуль інтеграції OpenCart 3 з Merchant API для магазинів, що використовували старий Content API. Модуль підтримує OpenCart 3.x і OcStore 3.x на PHP 8.1 і вище, поставляється у форматі ocmod.zip з відкритим кодом без обфускації та ionCube. Актуальна версія 1.0.3 датована 11 серпня 2026 року.

Модуль створює канали товарів для передачі каталогу з OpenCart у Merchant Center через API-протокол. Оновлення відбувається у двох режимах: онлайн під час ручного редагування позиції в адмінпанелі та за розкладом cron для магазинів, де дані оновлюються через імпорт або парсинг зовнішніх джерел. Підтримується передача товарів локальних магазинів для локальної видачі в Google Shopping.

Ідентифікатори offerId зберігаються тими самими, що використовувалися у попередніх модулях розробника на базі Content API. Це критично для збереження історії товарів і накопиченої статистики в Merchant Center — імпорт з новими ідентифікаторами обнулив би дані Performance Max і скинув би навчання алгоритмів. Для клієнтів, які раніше купували старий модуль Content API на той самий домен, діє знижка 70%.

Налаштування починається зі створення проєкту в Google Cloud Console, увімкнення Merchant API у цьому проєкті, генерації сервісного акаунту з JSON-ключем та реєстрації email розробника через кнопку "Зареєструвати GCP-проєкт" у модулі — вона встановлює тип доступу "Розробник API", необхідний для роботи з новим інтерфейсом. Далі email сервісного акаунту додається у Merchant Center за шляхом Налаштування → Доступ і сервіс → Додати користувача з правами адміністратора та стандартного користувача.

Модуль поки не підтримує товари з опціями розмірів, кольору, матеріалу, статі — категорії Одяг і Взуття потребують окремого рішення. Для магазинів на OpenCart 4 та інших конфігурацій, що виходять за межі цього модуля, OpenCartBot пропонує альтернативний варіант — генератор XML-фідів Merchant XML.

Про автора

Анна Горожанецька

Анна Горожанецька

Головна авторка та експертка з веб-технологій

Спеціалістка з UX/UI дизайну та веб-розробки з 10+ років досвіду. Ментор молодих дизайнерів та активна учасниця IT-спільноти України.

10+
Років досвіду
50+
Клієнтів
10+
Виступів