Merchant API

Як працює

Merchant API дає змогу програмам робити те, що робить людина в Merchant Center. Він додає й оновлює товари, керує залишками, джерелами даних і промоакціями та читає проблеми акаунта. Також він отримує звіти про результативність за методом маркетингу: реклама чи органічна видача. Наш посібник розповідає, де дивитися результати безкоштовних розміщень.

Це переробка Content API for Shopping, розбита на окремі підінтерфейси (sub-API), кожен зі своєю версією в адресі, наприклад products/v1. Щоб його викликати, розробник прив’язує проєкт Google Cloud до акаунта Merchant Center і входить через OAuth або сервісний акаунт.

Content API for Shopping досяг дати припинення роботи 18 серпня 2026 року. З 1 вересня 2026 року запити до нього без чинного подовження (extension) час від часу завершуються помилкою HTTP 410. Google планує повністю вимкнути його на початку 2027 року. Наш посібник про перехід на Merchant API розповідає, що це ламає в інструментах роботи з фідом.

Де це видно

• Портал: розділ Фід і Merchant Center читає каталог і звіти через Merchant API v1 і нічого не змінює у фіді.

Приклад

Приклад на вигаданому магазині, числа не клієнтські.

Власний скрипт магазину посуду оновлює ціну обіднього сервіза, offer ID ds-24, у його німецькому фіді. У Content API ID товару був online:de:DE:ds-24. У Merchant API він такий: de~DE~ds-24 — частини з каналом (online) немає, а двокрапки замінено тильдами.

Ціна 600 тепер передається як amountMicros: 600000000, бо Merchant API очікує суми в мільйонних частках. Скрипт, який досі будує старий ID або надсилає просто 600, потрібно переписати.

Не плутати з

• Google Ads API — інтерфейс до кампаній, ставок і звітів про рекламу. Merchant API охоплює дані про товари та акаунт Merchant Center.

Правильне й неправильне прочитання

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

Джерела

• Overview of Merchant 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.