Дизайн Merchant API

Мы разработали Merchant API так, чтобы он был знаком разработчикам Content API for Shopping, но при этом был проще и гибче. Ниже приведена подробная информация о структуре Merchant API.

Дочерние API

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

Merchant API включает следующие дочерние API:

  • Accounts. Управление аккаунтами Merchant Center.
  • Конверсии. Управление источниками конверсий в аккаунте.
  • Источники данных. Просматривайте источники данных о товарах и управляйте ими.
  • Устранение проблем. Получайте информацию о проблемах, влияющих на ваш аккаунт, и создайте страницу диагностики в приложении.
  • Ассортимент. Показывайте товары в Google с разбивкой по магазинам или регионам.
  • Партнерство по фидам ассортимента местных товаров. Загрузите фид ассортимента местных товаров.
  • Уведомления. Управление подписками на уведомления.
  • Отслеживание заказов. Предоставьте историю отслеживания заказов, чтобы улучшить расчеты доставки и добавить в предложения аннотации о доставке.
  • Товары. Управляйте данными о товарах, например ценами и сведениями о наличии.
  • Product Studio. Используйте Google Product Studio, чтобы автоматически генерировать изображения товаров и варианты текста.
  • Промоакции. Создавайте промоакции и управляйте ими, чтобы показывать специальные предложения для ваших товаров.
  • Quota Проверьте квоту API для своих аккаунтов.
  • Отчеты. Просматривайте данные о товарах, эффективности и конкуренции в Google.
  • Отзывы. Управляйте отзывами о товарах и продавцах.

Транспортная часть

По умолчанию в Merchant API используется транспортный механизм gRPC. Вы также можете использовать REST.

Дополнительную информацию можно найти в кратком руководстве.

Перечисления

В будущем в полях Enum в Merchant API могут появиться новые значения. Код должен быть структурирован таким образом, чтобы он мог корректно обрабатывать нераспознанные значения. Вам следует отслеживать появление нераспознанных значений перечисления и принимать меры, чтобы поддерживать код в актуальном состоянии.

Управление версиями

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