Отримати дані сторінки

У робочих процесах, які потребують даних сторінки, ви можете скористатися дією Отримати дані сторінки, щоб отримати інформацію про сторінку з вашого магазину. Сторінки — це вебсторінки у вашому інтернет-магазині, які містять інформацію, що рідко змінюється, наприклад сторінка «Про нас» або «Контакти».

Примітка

Це різновид дії Отримати дані. Щоб дізнатися, як використовувати цей тип дії з тригером Запланований час і циклами перебору, перегляньте статтю Розклади, отримання даних і циклічні робочі процеси в Shopify Flow.

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

Поля

Дія Отримати дані сторінки містить такі поля:

Поля, що використовуються в діях отримання даних.

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

Рядок запиту

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

published_status:published

Змінна published_status — це фільтр, доступний у запиті щодо сторінок, який можна використовувати кілька разів або комбінувати з іншими змінними.

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

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

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

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

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

• Зважайте на те, що станеться, якщо ваш запит не буде виконано. Часто API повертає всі результати (замість жодного).

Повернені дані

Усі дії Отримати дані повертають список, що містить від 0 до 100 ресурсів. Залежно від вашого сценарію використання, ви можете використовувати ці дані різними способами:

• Якщо вам потрібно обробити кожну одиницю списку окремо, наприклад додати тег для кожної з них, ви можете скористатися дією циклу перебору.
• Якщо вам потрібно агрегувати дані, наприклад підрахувати кількість повернених результатів, ви можете скористатися дією Підрахунок або Сума.
• Якщо вам потрібно вивести список, наприклад надіслати електронний лист із усіма одиницями, ви можете використовувати повернені дані безпосередньо в наступних діях.

Щоб отримати доступ до повернених даних на кроках, які слідують за цією дією, використовуйте змінну з назвою Get page data, яка містить список сторінок. Ви можете використовувати цю змінну як в умовах, так і в діях. Наприклад, ви можете надіслати список сторінок за допомогою дії Надіслати внутрішній електронний лист подібно до цього:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Примітка

Якщо дія Отримати дані використовується кілька разів в одному робочому процесі, до назви змінної додається число. Наприклад, у робочому процесі, який двічі використовує дію Отримати дані замовлення, перша змінна для повернених даних матиме назву getOrderData, а друга — getOrderData1. Цю назву неможливо змінити.

Тригери

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

Довідник API

Докладнішу інформацію про API, що використовується в цій дії, дивіться в розділі про запит щодо сторінок.