Shopify Flow та GraphQL Admin API

Flow використовує GraphQL Admin API від Shopify для створення автоматизацій та інтеграцій, які розширюють і вдосконалюють панель адміністрування Shopify. Flow використовує версію API 2026-01 для оцінювання умов і змінних у робочих процесах, а також для виконання дій у вашому магазині Shopify. Оскільки Flow отримує доступ до даних магазину шляхом виклику API, у ньому вам доступні майже всі поля, які є в API.

Оскільки Shopify випускає нові версії API кожні 3 місяці, деякі робочі процеси може знадобитися оновлювати, коли поля змінюються або стають застарілими.

Використання GraphQL Admin API в робочих процесах

Більшість дій у Flow використовують GraphQL Admin API для внесення змін до вашого магазину Shopify. Наприклад, дія Додати теги замовлення використовує мутацію tagsAdd. Дія Надіслати запит Admin API може використовувати більшість мутацій, зокрема ті, які ще недоступні як дії у Flow.

Під час створення робочих процесів ви часто стикатиметеся з назвами полів та описами, заснованими на синтаксисі GraphQL Admin API. Наприклад, щоб визначити загальну кількість варіанта, придатну для продажу, у робочому процесі, потрібно використати змінну variants_item.inventoryQuantity. Інший приклад: щоб визначити розташування, де клієнт підписався на вашу інформаційну розсилку, потрібно використати змінну emailSubscriptionMethod.

Вам не обов’язково досконало знати API, щоб створювати робочі процеси в застосунку Flow. Проте базове розуміння назв змінних та їхніх визначень допоможе побудувати потрібну логіку робочого процесу. Наприклад, знання різниці між displayName і firstName клієнта допоможе вашому робочому процесу отримувати правильні дані залежно від мети їх використання. Визначення додаються до кожної змінної під час створення робочого процесу, і ви можете натиснути , щоб дізнатися більше про будь-яку змінну або визначення.

Дані магазину та GraphQL Admin API

Робочі процеси використовують дані з вашого магазину в умовах і діях. Flow отримує доступ до даних магазину за допомогою GraphQL Admin API, що означає, що ви маєте доступ майже до всіх полів у API. Якщо дія не має необхідних даних, наданих тригером або дією «Отримати дані», робочий процес не запуститься, і з’явиться повідомлення про помилку.

Наприклад, робочий процес починається з тригера Створено клієнта та імпортує дані клієнта в робочий процес. Якщо після цього тригера йде дія Додати теги замовлення, яка потребує даних замовлення, а не даних клієнта, у робочому процесі виникне помилка через відсутність даних.

Можливо, вам знадобиться попередньо переглянути дані або ознайомитися з документацією API, щоб зрозуміти, що виводиться через API та використовується у Flow, і переконатися, що ваш робочий процес видає очікувані дані.

Аргументи полів та GraphQL Admin API

Деякі поля GraphQL Admin API вимагають аргументів — додаткових параметрів, які звужують обсяг повернутих даних. Наприклад, поле product.inCollection потребує аргументу id колекції, щоб знати, яку колекцію перевіряти. Без нього поле не зможе повернути результат.

У Flow можна створювати змінні з цих полів, надаючи необхідне значення аргументу, яке потім використовуватиметься в робочому процесі. Ви також можете призначити змінній спеціальну назву, щоб на неї було легше посилатися на наступних етапах. Наприклад, назвати product.inCollection(id: "gid://shopify/Collection/123456") як product.inSummerBestsellers.

Дізнайтеся більше про створення змінних із полів з аргументами.

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

Керування версіями API

Shopify випускає нові версії API кожні 3 місяці, і Flow переходить на нові версії якнайшвидше, але може відставати від останньої версії. За можливості зміни між версіями вирішуються автоматично, але деякі зміни можуть бути не такими простими, зокрема в таких ситуаціях:

• Якщо поля видалено, але заміни не передбачено, що може вплинути на оцінювання умов або коду Liquid.
• Якщо поля стають такими, що допускають значення null, що може вплинути на оцінювання умов або коду Liquid.
• Коли змінюються значення enum або додаються нові типи union чи interface, що може вплинути на Liquid або код.
• Коли змінюються аргументи мутації, що може вплинути на конфігурацію дій «Надіслати запит Admin API».

Деякі робочі процеси може знадобитися оновити вручну. У таких випадках робочі процеси можуть відображати помилку Потрібне оновлення або Непідтримуваний API і спрямовувати вас до відповідної документації API, щоб ви могли внести потрібні зміни в редакторі робочих процесів. Коли ці оновлення буде завершено та збережено, робочий процес автоматично оновиться для використання останньої версії API, доступної у Flow.

Ви можете тимчасово проігнорувати ці проблеми, щоб внести термінові зміни в робочий процес із помилками сумісності версій API. Якщо ці проблеми не усунути, робочий процес може перестати запускатися або викликати помилки, коли стара версія API більше не підтримуватиметься Shopify.