Контентное API Яндекс.Маркет: Загрузка товаров, характеристик и обновление цен
10 февраля 2015
Автор: Шашалевич Станислав
Компания Сотбит анонсирует выпуск нового топ-решения «Контентное API Яндекс.Маркет: Загрузка товаров, характеристик и обновление цен».
От клиентов нашего модуля «Парсер контента» поступало очень много заявок, чтобы мы заточили парсер под парсинг Яма. Идея, конечно, хорошая, но для нас сомнительная, так как, во-первых, уже существуют подобные решения в Маркетплейсе, а во-вторых, стабильность работы такого парсера не гарантируется из-за качественной защиты Яндексом своего контента.
В итоге, мы решили не пилить уже существующее решение, а сделать
совершенно новое и абсолютно легальное решение для загрузки товаров с
Яндекс Маркета. От клиента остается самое простое(а может и самое
сложное) – это получить ключик на полный доступ к контентному АПИ Яма.
Ключик не предоставляется простым интернет-магазинам. Вы можете получить
ключик, если ваш сайт является:
Возможности модуля:
Визуальная часть модуля находится в административном разделе Контент – Контентное API Яндекс.Маркет.
Чтобы решение работало, в настройках модуля указать ваш ключ от АПИ:
Теперь рассмотрим основной интерфейс решения – форма добавления и редактирования задания.
Если на сайте установлен модуль Каталог, то форма добавления будет состоять из 9 вкладок, в ином случае из 8-ми.
Теперь рассмотрим каждую вкладку в отдельности.
Вкладка Задание
Режим работы – режим, в котором будет выполняться задание.
Debug – режим для отладка задания.
Ограничения debug режима:
- Работа только с 3 разделами
- Работа только с 30 товарами
- Запуск по агенту не осуществляется
- Логирование не ведется
Если вы используете модуль в демо-режиме, то все задания будут выполняться фактически в debug режиме.
Work – рабочий режим, когда вы полностью убедились в правильности выполнения задания.
Активность – задание будет выполняться в активном состоянии.
Название – название задания.
Код информационного блока – айди инфоблока, в который будет произведена выгрузка разделов и товаров.
Выбрать задание.
Главной сущностью модуля являются задания. На данный момент существует три типа заданий:
1. Загрузка разделов с ЯМ
2. Загрузка товаров из категорий ЯМ по фильтру
3. Поиск и загрузка конкретных товаров из каталога
1. Загрузка разделов с ЯМ
Самое простое задание. Осуществляется загрузка указанных категорий из ЯМ.
2. Загрузка товаров из категорий ЯМ по фильтру
Загружает модели и предложения из указанных категорий. Категории могут задаваться из категорий ЯМ или из разделов вашего интернет-магазина. Главное условие: разделы вашего интернет-магазина должны быть связаны с категориями ЯМ через id.
Фильтр можно использовать, если указана лишь одна категория ЯМ, так как поля и свойства фильтра привязаны к конкретной категории.
3. Поиск и загрузка конкретных товаров из каталога
Модели и предложения загружаются по id или названию из конкретных разделов вашего интернет-магазина, указанных во вкладке Категории. Загрузка по названию возможна одновременно для моделей и предложений. Загрузка по id возможна только отдельно для моделей и предложений.
Вкладка Регионы
Задания выполняются по конкретному региону, который вас интересует.
Вкладка Категории
Категории из ЯМ – список категорий, которые вы можете выгрузить в указанный инфоблок своего сайта. Чтобы подгрузить подкатегории, необходимо нажать соответствующую кнопку. Если вы хотите сбросить все категории, то нажмите на кнопку «Сбросить категории»
Данное поле является обязательным для задания 1. Также может использоваться для задания 2, если разделы на вашем сайте связаны с категориями ЯМ одинаковым названием или айдишником категории.
Разделы инфоблока – это разделы вашего инфоблока. Поле является обязательным для задания 3, а также возможно для использования в задании 2(приоритетно, если также активно поле Категории ЯМ)
Определять уникальность раздела – каким образом определять уникальность раздела. Варианты: по названию и по айди категории в ЯМ.
Записывать id категории ЯМ в – в какое поле записывать айди категории ЯМ. Варианты: во внешний код раздела или в пользовательское свойство.
Вкладка Фильтр
Фильтр работает только в задании 2 при условии, что выбрана одна категория в поле «Категории из ЯМ», так как свойства и параметры привязаны к конкретной категории ЯМ.
Вкладка Модели товаров
Загружать модели из выдачи – если галочка не проставлена, то в задании 2 и 3 модели не будут выгружаться.
Определять уникальность модели – каким образомопределять уникальность модели. Варианты: по названию или айди модели.
Записывать id модели в – в какое поле записывать айди модели. Варианты: внешний код элемента или свойство элемента.
Описание – загружать описание в базу или нет. Варианты: Не загружать, Загружать в превью описание, загружать в детальное описание, загружать в превью и детальное описание.
Превью картинка – загружать превью картинку или нет. Варианты: Не загружать, Загружать, Загружать из детальной
Детальная картинка – загружать или нет в базу. Варианты: Не загружать, Загружать
Доп. картинки – указывается загружать ли доп картинки. Если да, то необходимо указать поле, в которое загружать.
URL в ЯМ – в какое поле загружать URL товара.
Цена – указывается какую цены выгружать на сайт: не выгружать, минимальную, среднюю, максимальную.
Загружать характеристики модели – требуется ли загружать характеристики и если да, то какие именно. Варианты: Не загружать, Все характеристики, Основные характеристики.
Тип создаваемых свойств – необходимо указать тип свойств, которые будут создаваться. Идентификация свойств осуществляется строго по названию. Поэтому не рекомендуется изменять названия свойств.
Далее следует список полей, отвечающих за обновление моделей.
Обновлять товары – обновлять или нет модели.
Цена – обновлять цену
Параметры каталога – обновлять параметры каталога
Превью описание – обновлять или нет превью описание. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Детальное описание – обновлять или нет детальное описание. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Превью картинка – обновлять или нет превью картинку. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Детальная картинка – обновлять или нет детальную картинку. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Свойства товара – обновлять или нет свойства модели.
Вкладка Товарные предложения
Поля очень схожи с предыдущей вкладкой, поэтому их подробно рассматривать не будем.
Вкладка Торговый каталог
Вкладка активна, если у вас установлен модуль Торговый каталог.
Тип цены – выбор типа цены.
Ставка НДС – выбор ставки НДС
Включать НДС в цену – включать или нет НДС в цену.
Валюта – выбор валюты.
Единица измерения – выбор ед. измерения
Коэффициент ед. измерения – устанавливается значение коэф. Ед. измерения.
Конвертировать в валюту – выбор валюты, в которую необходимо конвертировать текущую.
Далее следует список условий, по которому можно изменять цену. Также предоставляется возможность добавить и удалить условие
Вкладка Доп. настройки
Шаг загрузки товаров – поле, актуальное для задания 3, которое устанавливает количество товаров, обрабатываемых за один шаг выполнения задания. По умолчанию 10.
Запускать по агенту – если задание необходимо периодически запускать, то устанавливаем галочку. Агент рекомендуется запускать по крону.
Остальные поля интуитивно понятны и рассматривать подробно их не будем.
Вкладка Логи
Простое логирование в файл – происходит запись лога в файл, который вы можете скачать.
Умное логирование – в будущих обновлениях все логи будут заноситься в базу. Каждая запись будет связана с товаром или разделов.
Решение находится еще на модерации, но Вы можете скачать его в демо-режиме на нашем сайте.
Компания Сотбит работает для Вас.
От клиентов нашего модуля «Парсер контента» поступало очень много заявок, чтобы мы заточили парсер под парсинг Яма. Идея, конечно, хорошая, но для нас сомнительная, так как, во-первых, уже существуют подобные решения в Маркетплейсе, а во-вторых, стабильность работы такого парсера не гарантируется из-за качественной защиты Яндексом своего контента.
В итоге, мы решили не пилить уже существующее решение, а сделать
совершенно новое и абсолютно легальное решение для загрузки товаров с
Яндекс Маркета. От клиента остается самое простое(а может и самое
сложное) – это получить ключик на полный доступ к контентному АПИ Яма.
Ключик не предоставляется простым интернет-магазинам. Вы можете получить
ключик, если ваш сайт является:
- - крупным региональным порталом
- - сайтом производителей товаров
- - ресурсом по выбору товаров и магазинов
Возможности модуля:
- - Загрузка категорий с сохранением полной иерархии
- - Загрузка моделей и предложений из конкретной категории ЯМа
- - Обновление товаров из уже существующей базы товаров вашего интернет-магазина.
- - Загрузка товаров по конкретному региону и фильтру
- - Возможность отслеживания товаров по конкретному магазину или производителю(с использованием фильтра)
- - Загрузка картинок и характеристик
- - Загрузка и обновление цен
Визуальная часть модуля находится в административном разделе Контент – Контентное API Яндекс.Маркет.
Чтобы решение работало, в настройках модуля указать ваш ключ от АПИ:
Теперь рассмотрим основной интерфейс решения – форма добавления и редактирования задания.
Если на сайте установлен модуль Каталог, то форма добавления будет состоять из 9 вкладок, в ином случае из 8-ми.
Теперь рассмотрим каждую вкладку в отдельности.
Вкладка Задание
Режим работы – режим, в котором будет выполняться задание.
Debug – режим для отладка задания.
Ограничения debug режима:
- Работа только с 3 разделами
- Работа только с 30 товарами
- Запуск по агенту не осуществляется
- Логирование не ведется
Если вы используете модуль в демо-режиме, то все задания будут выполняться фактически в debug режиме.
Work – рабочий режим, когда вы полностью убедились в правильности выполнения задания.
Активность – задание будет выполняться в активном состоянии.
Название – название задания.
Код информационного блока – айди инфоблока, в который будет произведена выгрузка разделов и товаров.
Выбрать задание.
Главной сущностью модуля являются задания. На данный момент существует три типа заданий:
1. Загрузка разделов с ЯМ
2. Загрузка товаров из категорий ЯМ по фильтру
3. Поиск и загрузка конкретных товаров из каталога
1. Загрузка разделов с ЯМ
Самое простое задание. Осуществляется загрузка указанных категорий из ЯМ.
2. Загрузка товаров из категорий ЯМ по фильтру
Загружает модели и предложения из указанных категорий. Категории могут задаваться из категорий ЯМ или из разделов вашего интернет-магазина. Главное условие: разделы вашего интернет-магазина должны быть связаны с категориями ЯМ через id.
Фильтр можно использовать, если указана лишь одна категория ЯМ, так как поля и свойства фильтра привязаны к конкретной категории.
3. Поиск и загрузка конкретных товаров из каталога
Модели и предложения загружаются по id или названию из конкретных разделов вашего интернет-магазина, указанных во вкладке Категории. Загрузка по названию возможна одновременно для моделей и предложений. Загрузка по id возможна только отдельно для моделей и предложений.
Вкладка Регионы
Задания выполняются по конкретному региону, который вас интересует.
Вкладка Категории
Категории из ЯМ – список категорий, которые вы можете выгрузить в указанный инфоблок своего сайта. Чтобы подгрузить подкатегории, необходимо нажать соответствующую кнопку. Если вы хотите сбросить все категории, то нажмите на кнопку «Сбросить категории»
Данное поле является обязательным для задания 1. Также может использоваться для задания 2, если разделы на вашем сайте связаны с категориями ЯМ одинаковым названием или айдишником категории.
Разделы инфоблока – это разделы вашего инфоблока. Поле является обязательным для задания 3, а также возможно для использования в задании 2(приоритетно, если также активно поле Категории ЯМ)
Определять уникальность раздела – каким образом определять уникальность раздела. Варианты: по названию и по айди категории в ЯМ.
Записывать id категории ЯМ в – в какое поле записывать айди категории ЯМ. Варианты: во внешний код раздела или в пользовательское свойство.
Вкладка Фильтр
Фильтр работает только в задании 2 при условии, что выбрана одна категория в поле «Категории из ЯМ», так как свойства и параметры привязаны к конкретной категории ЯМ.
Вкладка Модели товаров
Загружать модели из выдачи – если галочка не проставлена, то в задании 2 и 3 модели не будут выгружаться.
Определять уникальность модели – каким образомопределять уникальность модели. Варианты: по названию или айди модели.
Записывать id модели в – в какое поле записывать айди модели. Варианты: внешний код элемента или свойство элемента.
Описание – загружать описание в базу или нет. Варианты: Не загружать, Загружать в превью описание, загружать в детальное описание, загружать в превью и детальное описание.
Превью картинка – загружать превью картинку или нет. Варианты: Не загружать, Загружать, Загружать из детальной
Детальная картинка – загружать или нет в базу. Варианты: Не загружать, Загружать
Доп. картинки – указывается загружать ли доп картинки. Если да, то необходимо указать поле, в которое загружать.
URL в ЯМ – в какое поле загружать URL товара.
Цена – указывается какую цены выгружать на сайт: не выгружать, минимальную, среднюю, максимальную.
Загружать характеристики модели – требуется ли загружать характеристики и если да, то какие именно. Варианты: Не загружать, Все характеристики, Основные характеристики.
Тип создаваемых свойств – необходимо указать тип свойств, которые будут создаваться. Идентификация свойств осуществляется строго по названию. Поэтому не рекомендуется изменять названия свойств.
Далее следует список полей, отвечающих за обновление моделей.
Обновлять товары – обновлять или нет модели.
Цена – обновлять цену
Параметры каталога – обновлять параметры каталога
Превью описание – обновлять или нет превью описание. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Детальное описание – обновлять или нет детальное описание. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Превью картинка – обновлять или нет превью картинку. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Детальная картинка – обновлять или нет детальную картинку. Варианты: Не обновлять, Обновлять, Обновлять если пустое
Свойства товара – обновлять или нет свойства модели.
Вкладка Товарные предложения
Поля очень схожи с предыдущей вкладкой, поэтому их подробно рассматривать не будем.
Вкладка Торговый каталог
Вкладка активна, если у вас установлен модуль Торговый каталог.
Тип цены – выбор типа цены.
Ставка НДС – выбор ставки НДС
Включать НДС в цену – включать или нет НДС в цену.
Валюта – выбор валюты.
Единица измерения – выбор ед. измерения
Коэффициент ед. измерения – устанавливается значение коэф. Ед. измерения.
Конвертировать в валюту – выбор валюты, в которую необходимо конвертировать текущую.
Далее следует список условий, по которому можно изменять цену. Также предоставляется возможность добавить и удалить условие
Вкладка Доп. настройки
Шаг загрузки товаров – поле, актуальное для задания 3, которое устанавливает количество товаров, обрабатываемых за один шаг выполнения задания. По умолчанию 10.
Запускать по агенту – если задание необходимо периодически запускать, то устанавливаем галочку. Агент рекомендуется запускать по крону.
Остальные поля интуитивно понятны и рассматривать подробно их не будем.
Вкладка Логи
Простое логирование в файл – происходит запись лога в файл, который вы можете скачать.
Умное логирование – в будущих обновлениях все логи будут заноситься в базу. Каждая запись будет связана с товаром или разделов.
Решение находится еще на модерации, но Вы можете скачать его в демо-режиме на нашем сайте.
Компания Сотбит работает для Вас.
Предлагаем еще прочесть
