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