Мы разработали API Merchant, чтобы он был знаком разработчикам Content API для покупок, но при этом стал проще и гибче. Ниже представлена подробная информация о дизайне API Merchant.
Суб-API
API продавца — это набор под-API. Под-API представляют собой группы связанных сервисов и ресурсов. Такая структура позволяет вам использовать только те под-API, которые необходимы для вашей уникальной интеграции.
API торговца включает в себя следующие под-API:
- Счета : масштабное управление счетами Merchant Center.
- Конверсии : управляйте источниками конверсий для вашего аккаунта.
- Источники данных : просматривайте и управляйте источниками данных для ваших продуктов.
- Решение проблем : найдите проблемы, влияющие на вашу учетную запись, и создайте страницу диагностики в приложении.
- Запасы : демонстрируйте свои продукты по магазину или региону в Google.
- Партнерство по местным каналам : загрузите канал с данными о местных запасах продукции.
- Уведомления : управление подписками на уведомления.
- Отслеживание заказов : предоставление исторических данных отслеживания заказов для уточнения оценок доставки и дополнения листингов аннотациями о доставке.
- Продукты : управление данными о продуктах, такими как цена и доступность.
- Product Studio : используйте Google Product Studio для автоматического создания изображений продуктов и текстовых предложений.
- Акции : создавайте и управляйте акциями, чтобы демонстрировать специальные предложения на ваши продукты.
- Квота : проверьте квоту API ваших учетных записей.
- Отчеты : просматривайте данные о ваших продуктах, эффективности и конкурентной среде в Google.
- Обзоры : управление отзывами о товарах и продавцах.
Транспорт
Механизм передачи данных по умолчанию в Merchant API — gRPC . Вы также можете использовать REST .
Более подробную информацию смотрите в кратком руководстве .
Перечисления
Поля enum в API Merchant могут в будущем предоставлять новые значения. Ваш код должен быть структурирован таким образом, чтобы он мог корректно обрабатывать нераспознанные значения. Вам следует отслеживать появление нераспознанных enum-значений и принимать меры для поддержания актуальности кода.
Версионирование
Версии суб-API контролируются отдельно. Это означает, что вам не нужно ничего делать, если мы обновим суб-API, который вы не используете. Вам нужно обновлять код только при выпуске новых версий используемых вами суб-API. Подробнее см. в разделе «Контроль версий» .
Версии, заканчивающиеся на «бета», могут быть изменены или удалены.