Отримати дані спроб стягнення оплати за передплату
У робочих процесах, які потребують даних про спроби стягнення оплати за передплату, ви можете використовувати дію отримання даних спроб стягнення оплати за передплату, щоб отримати інформацію про замовлення з вашого магазину.
На цій сторінці
Конфігурація
Поля
Дія отримання даних спроб стягнення оплати за передплату містить наведені нижче поля, які використовуються для створення запиту:
| Поле | Опис |
|---|---|
| Сортувати дані за | Обов’язково. Параметри, за якими сортуються дані, повернуті пошуковим запитом. |
| Максимальна кількість результатів | Обов’язково. Максимальна кількість результатів, яку може повернути вибраний вами пошуковий запит. Одночасно можна отримати до 100 результатів. |
| Запит | Обов’язково. Виберіть зі стандартних запитів або натисніть Розширені, щоб створити власний. |
Рядок запиту
Це приклад запиту для отримання даних про спроби стягнення оплати за передплату, створені за останні три дні:
created_at:>'{{ createdAt | date_minus: "3 day" }}'Змінна created_at є фільтром, доступним у запиті спроб стягнення оплати за передплату, і її можна використовувати для вибору конкретного повідомлення про помилку для спроб стягнення оплати за передплату.
Під час надсилання запиту до даних корисно знати таке:
- Список доступних фільтрів спроб стягнення оплати за передплату
- Запити мають відповідати певному синтаксису
- Значення полів запиту не завжди задокументовано. Іноді ці значення можна знайти в документації API. Часто значення полів можна також знайти в URL-адресах у панелі адміністрування під час фільтрування. Наприклад, щоб знайти значення запиту для замовлень, відфільтруйте сторінку «Замовлення» в панелі адміністрування, а потім перевірте URL-адресу.
- Ви можете запустити або перевірити запит у вашому магазині за допомогою застосунку Shopify GraphiQL.
- Зважайте на те, що станеться в разі помилки запиту. Часто API повертає всі результати (а не порожню відповідь).
Повернуті дані
Усі дії отримання даних повертають список від 0 до 100 ресурсів. Залежно від вашого варіанта використання ви можете працювати з цими даними по-різному:
- Якщо вам потрібно обробити кожну одиницю списку окремо, наприклад додати тег для кожної, можна скористатися дією Для кожного.
- Якщо вам потрібно згрупувати дані, наприклад порахувати кількість повернутих результатів, можна використати дію Підрахувати або Підсумувати.
- Якщо потрібно вивести список, наприклад надіслати електронний лист з усіма одиницями, ви можете використовувати повернуті дані безпосередньо в наступних діях.
Щоб отримати доступ до повернутих даних у кроках після цієї дії, використовуйте змінну з назвою Отримати дані спроб стягнення оплати за передплату (список спроб стягнення оплати за передплату). Ви можете використовувати цю змінну як в умовах, так і в діях. Наприклад, ви можете надіслати список спроб стягнення оплати за передплату в дії Надіслати внутрішній електронний лист у такий спосіб:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Приклад
Наприклад, запуск робочого процесу заплановано щонеділі о 9:00. Дія Отримати дані про спроби стягнення оплати за передплатою використовується для збору даних про спроби стягнення оплати, створені минулого тижня. Якщо виникає повідомлення про помилку, надсилається електронний лист із цією інформацією.