Отримати дані подарункової картки
У робочих процесах, які потребують даних подарункової картки, ви можете використовувати дію Отримати дані подарункової картки, щоб отримувати інформацію про подарункові картки з вашого магазину.
Важливо зазначити, що у вашому магазині є як товари-подарункові картки, які використовуються для створення подарункових карток, так і самі подарункові картки — фактичні подарункові картки, якими клієнти можуть розраховуватися за купівлі. Дія Отримати дані подарункової картки отримує інформацію про самі подарункові картки. Щоб отримати інформацію про товари-подарункові картки, використовуйте дії Отримати дані товару або Отримати дані варіанта товару.
На цій сторінці
Конфігурація
Поля
Дія Отримати дані подарункової картки містить такі поля, які використовуються для створення запиту:
| Поле | Опис |
|---|---|
| Сортувати дані за | Обов’язково. Параметри, за якими сортуються дані, отримані за пошуковим запитом. |
| Максимальна кількість результатів | Обов’язково. Максимальна кількість результатів, які може повернути вибраний пошуковий запит. Одночасно можна отримати до 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, запуск відбувається в зазначений вами час, а не внаслідок події. Оскільки немає конкретної події у вашому магазині чи із застосунку, яка б запускала робочий процес, жодні дані не включаються автоматично.