Отримати дані подарункової картки

У робочих процесах, які потребують даних подарункової картки, ви можете використовувати дію Отримати дані подарункової картки, щоб отримувати інформацію про подарункові картки з вашого магазину.

Важливо зазначити, що у вашому магазині є як товари-подарункові картки, які використовуються для створення подарункових карток, так і самі подарункові картки — фактичні подарункові картки, якими клієнти можуть розраховуватися за купівлі. Дія Отримати дані подарункової картки отримує інформацію про самі подарункові картки. Щоб отримати інформацію про товари-подарункові картки, використовуйте дії Отримати дані товару або Отримати дані варіанта товару.

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

Поля

Дія Отримати дані подарункової картки містить такі поля, які використовуються для створення запиту:

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

Рядок запиту

Ось приклад запиту для отримання подарункових карток, які було оновлено протягом останнього дня:

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

Змінна created_at — це фільтр, доступний у запиті щодо подарункових карток, і її можна використовувати кілька разів або комбінувати з іншими змінними. Змінна Liquid scheduledAt доступна в робочих процесах, які використовують тригер Scheduled time. Тег Liquid date_minus — це спеціальний тег Flow, який дає змогу віднімати час від дати.

Під час запиту даних корисно знати таке:

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

  • Запити мають відповідати певному синтаксису

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

  • Ви можете запустити або перевірити запит у своєму магазині за допомогою застосунку Shopify GraphiQL.

  • Зважайте на те, що станеться в разі збою запиту. Часто 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, запуск відбувається в зазначений вами час, а не внаслідок події. Оскільки немає конкретної події у вашому магазині чи із застосунку, яка б запускала робочий процес, жодні дані не включаються автоматично.