Помощь
Войти

Получение данных о товаре

В рабочих процессах, использующих данные о товарах, вы можете использовать действие «Получить данные о товаре», чтобы извлечь информацию о товарах из вашего магазина.

На этой странице

Конфигурация

Поля

Действие «Получить данные о товаре» содержит следующие поля, которые используются для создания запроса:

Поля, используемые в действиях «Получить данные».
ПолеОписание
Сортировать данные поОбязательное поле. Параметры, по которым сортируются данные, возвращаемые поисковым запросом.
Максимальное количество результатовОбязательное поле. Максимальное количество результатов, которое может вернуть выбранный вами поисковый запрос. Одновременно можно вернуть до 100 результатов.
ЗапросОбязательное поле. Выберите один из стандартных запросов или «Расширенный», чтобы создать собственный.

Строка запроса

Вот пример запроса для получения товаров, которые были обновлены за последний день:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Переменная updated_at — это фильтр, доступный в запросе товаров. Его можно использовать несколько раз или комбинировать с другими переменными. Переменная Liquid scheduledAt доступна в рабочих процессах, в которых используется триггер «Запланированное время». Тег Liquid date_minus — это специальный тег Flow, который позволяет вычитать время из даты.

При составлении запросов полезно знать следующее:

  • Список доступных фильтров товаров
  • Запросы должны соответствовать определённому синтаксису
  • Значения полей запроса не всегда документированы. В некоторых случаях их можно найти в документации по API. Кроме того, значения полей часто можно найти в URL-адресах в панели администратора при применении фильтров. Например, чтобы найти некоторые значения для запроса заказов, отфильтруйте страницу «Заказы» в панели администратора, а затем проверьте URL-адрес.
  • Вы можете запустить или протестировать запрос в своём магазине с помощью приложения Shopify GraphiQL.
  • Учитывайте, что произойдёт в случае сбоя запроса. Часто API возвращает все результаты (вместо того, чтобы не возвращать ничего).

Возвращаемые данные

Все действия «Получить данные» возвращают список, содержащий от 0 до 100 ресурсов. В зависимости от вашего сценария использования вы можете работать с этими данными по-разному:

  • Если вам нужно обработать каждый элемент списка отдельно, например добавить к каждому из них тег, вы можете использовать действие «Для каждого».
  • Если вам нужно агрегировать данные, например подсчитать количество возвращённых результатов, вы можете использовать действия «Подсчёт» или «Суммирование».
  • Если вам нужно вывести список, например отправить электронное письмо со всеми элементами, вы можете использовать возвращённые данные непосредственно в последующих действиях.

Чтобы получить доступ к возвращаемым данным на шагах, следующих за этим действием, используйте переменную с именем «Получить данные о товаре», которая представляет собой список товаров. Эту переменную можно использовать как в условиях, так и в действиях. Например, вы можете отправить список товаров с помощью действия «Отправить внутреннее электронное письмо» следующим образом:

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

Триггеры

Это действие можно использовать в любом рабочем процессе, в том числе с триггером «Запланированное время». В рабочем процессе, использующем триггер «Запланированное время», запуск происходит в указанное вами время, а не в результате какого-либо события. Поскольку запуск рабочего процесса не инициируется каким-либо конкретным событием в вашем магазине или приложении, никакие данные не включаются автоматически.

Сведения об API

Шаблоны

Добавление товаров с определённым тегом в коллекцию в будущем

В определённый момент в будущем получить все товары с определённым тегом, а затем добавить их в коллекцию. Посмотреть шаблон

Удаление неактивных товаров

Удаление товаров без товарных запасов, которые не обновлялись в течение года. Посмотреть шаблон

Публикация товаров с определённым тегом в будущем

В определённую дату в будущем получить товары с определённым тегом и опубликовать их. Используются триггер «Запланированное время» и действие «Получить данные о товаре». Посмотреть шаблон

Удаление тега «Новинка» через 90 дней после создания товара

Каждый день рабочий процесс получает до 100 товаров, которые были созданы более 90 дней назад и до сих пор имеют тег «new». Затем он удаляет эти теги у каждого товара. Посмотреть шаблон

Планирование удаления товаров из интернет-магазина в указанные дату и время

В определённую дату в будущем удаление товаров из интернет-магазина по тегу, ID или артикулу. Используются триггер «Запланированное время», действие «Получить данные о товаре» и цикл последовательной обработки элементов. Посмотреть шаблон

Отправка ежедневной сводки по электронной почте о товарах, которых нет в наличии

Каждый день получает все товары с нулевым запасом и отправляет сводку по электронной почте. Используются действие «Получить данные о товаре» и триггер «Запланированное время». Посмотреть шаблон

Отправка уведомления по электронной почте при добавлении варианта с дублирующимся артикулом

При добавлении нового варианта рабочий процесс проверяет, не используют ли другие варианты тот же артикул. Если да, он отправляет внутреннее электронное письмо со ссылками на соответствующие товары и варианты. Посмотреть шаблон

Отслеживание вариантов товаров на распродаже с помощью метаполя товара

Устанавливает метаполе для товара, если хотя бы один из его вариантов находится на распродаже. Это может быть полезно для отслеживания товаров, которые в данный момент на распродаже. Посмотреть шаблон