На этой странице объясняется, как вы можете загружать свои продукты и управлять ими программно. Используя API торговых продуктов, вы можете вставлять или обновлять продукт в источнике данных, получать продукт из своей учетной записи и удалять продукт из источника данных.
Вы можете использовать ресурс products для создания каталога интернет-магазина, то есть списка товаров, доступных в товарных объявлениях. Вы можете использовать ресурс products после того, как создадите свою учетную запись Merchant Center и будете готовы загрузить первоначальный набор продуктов через API.
Вы несете ответственность за соблюдение правил в отношении товарных объявлений и бесплатных предложений . Товарные объявления оставляют за собой право обеспечивать соблюдение этих политик и реагировать соответствующим образом, если мы обнаружим контент или поведение, нарушающие эти правила.
Ресурс products загружает информацию о продуктах в базу данных Shopping Merchant Center . Он также предоставляет ряд методов, позволяющих получать доступ, обновлять или удалять информацию о продукте по одному или сразу по нескольким в пакетном режиме .
Ресурс productInput представляет входные данные, которые вы отправляете для продукта. Ресурс productInput должен иметь следующие поля:
-
channel: канал продукта. -
offerId: уникальный идентификатор продукта. Это значение одинаково для входящего продукта и обработанного продукта. -
contentLanguage: двухбуквенный код языка ISO 639-1 для продукта. -
feedLabel: метка фида для продукта.
Хотя продавцы имеют возможность загружать товары с помощью файла под названием Primary Feed , создание и удаление товаров с помощью Merchant API дает ряд преимуществ. Эти преимущества включают более быстрое время ответа и возможность обновлять несколько продуктов в режиме реального времени без необходимости управлять несколькими дополнительными фидами . Прежде чем изменения продукта, внесенные вызовами API, отобразятся в базе данных Shopping Merchant Center, может пройти до нескольких часов.
Google может автоматически поддерживать определенные атрибуты ваших продуктов. Дополнительные сведения см. в разделе Включение автоматических улучшений .
Предварительные условия
Если у вас нет источника данных, создайте его с помощью API источников данных Merchant или Merchant Center.
Если у вас уже есть источник данных, который вы создали с помощью пользовательского интерфейса Merchant Center или API, вы можете использовать API Merchant Products API для добавления своих продуктов. Если вы используете Content API for Shopping для добавления продуктов, обратитесь к руководству по миграции , чтобы понять, как начать работу с API Merchant Products API.
Загрузите информацию о продукте в свой аккаунт
Чтобы загрузить данные о продукте в свою учетную запись, используйте метод accounts.productInputs.insert . Вы должны передать уникальный идентификатор основного или дополнительного источника данных для вставки продукта с помощью API торговых продуктов.
Получите обработанный продукт из своей учетной записи
Чтобы получить обработанный продукт из вашей учетной записи, используйте метод accounts.products.get . После вставки обработанный продукт может появиться через несколько минут.
Удалить информацию о продукте из своей учетной записи
Чтобы удалить ввод продукта из вашей учетной записи, используйте метод accounts.productInputs.delete . Для удаления продукта с помощью API торговых продуктов необходимо передать уникальный идентификатор основного или дополнительного источника данных, которому принадлежит продукт.
Перечислите продукты из вашего аккаунта
Чтобы перечислить обработанные продукты в вашей учетной записи, используйте метод accounts.products.list .