Помощь
Войти

Получить данные о подарочной карте

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

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

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

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

Поля

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

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

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

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

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

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

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

  • Список доступных фильтров для подарочных карт

  • Запросы должны соответствовать определённому синтаксису

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

  • Вы можете запустить или протестировать запрос в своём магазине, используя Shopify GraphiQL app.

  • Помните, что произойдёт, если ваш запрос завершится с ошибкой. Часто API возвращает все результаты (а не ни одного).

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

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

  • Если вам нужно обработать каждый элемент списка по отдельности, например добавить тег для каждого из них, вы можете использовать действие For each.
  • Если вам нужно агрегировать данные, например подсчитать количество возвращённых результатов, вы можете использовать действия Count или Sum.
  • Если вам нужно вывести список, например чтобы отправить по электронной почте все элементы, то возвращённые данные можно использовать напрямую в последующих действиях.

Чтобы получить доступ к возвращённым данным на следующих за этим действием шагах, используйте переменную с названием Get gift card data, которая представляет собой список подарочных карт. Эту переменную можно использовать как в условиях, так и в действиях. Например, вы можете отправить список подарочных карт в действии Send internal email следующим образом:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Триггеры

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

Сведения об API