Получить данные о скидках

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

Примечание

Это один из типов действий «Получить данные». Чтобы узнать, как использовать действия этого типа с триггером «Запланированное время» и циклами «Для каждого», обратитесь к статье «Расписания, получение данных и циклические рабочие процессы в Shopify Flow».

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

Поля

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

Поля, используемые в действиях «Получить данные».

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

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

Ниже приведен пример запроса для получения активных скидок, использующих код:

method:code AND status:active

Переменные method и status — это фильтры, доступные в запросе узла скидки. Их можно использовать несколько раз или в сочетании с другими переменными.

При работе с запросами полезно знать:

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

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

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

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

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

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Примечание

Если действие «Получить данные» используется в одном рабочем процессе несколько раз, то к названию переменной добавляется номер. Например, в рабочем процессе, где действие «Получить данные о заказах» используется дважды, первая переменная для возвращённых данных называется getOrderData, а вторая — getOrderData1. Это название нельзя изменить.

Триггеры

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

Детали API

• Ресурс скидки
• Фильтры запросов для скидок

Шаблоны

Еженедельная сводка по электронной почте об активных скидках с кодом

Отправляет сводку об активных скидках с кодом. Рабочий процесс запускается по расписанию каждый понедельник в 9:00. Рабочий процесс можно настроить, чтобы изменить время запуска, способ получения сводки, типы включаемых скидок и режим. Просмотреть шаблон