Shopify Flow и GraphQL Admin API

Flow използва Shopify GraphQL Admin API за изграждане на автоматизации и интеграции, които разширяват и подобряват администраторския панел на Shopify. Flow използва версия 2026-01 на API, за да оценява условия и променливи в работните процеси, както и да предприема действия във Вашия магазин в Shopify. Тъй като Flow осъществява достъп до данните на магазина чрез извикване на API, имате достъп до почти всички полета, налични в API, чрез Flow.

Тъй като 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.
• Когато полета станат nullable, което потенциално засяга начина, по който се оценяват условията или Liquid.
• Когато стойностите на enum се променят или се добавят нови типове union или interface, което потенциално засяга Liquid или кода.
• Когато аргументите на промяната се променят, което потенциално засяга конфигурацията на действията за изпращане на заявка до Admin API.

Някои работни процеси може да се нуждаят от ръчно актуализиране. В тези случаи работните процеси може да показват грешка Необходима е актуализация или Неподдържан API и да Ви насочат към съответната документация на API, за да направите необходимите промени в редактора на работни процеси. Когато тези актуализации бъдат завършени и запазени, работният процес автоматично се актуализира, за да използва най-новата версия на API, налична във Flow.

Можете да изберете временно да игнорирате проблемите, за да направите спешни промени в работен процес с грешки в съвместимостта на версията на API. Ако тези проблеми не бъдат разрешени, работният процес може да спре да се изпълнява или да причини грешки, когато по-старата версия на API вече не се поддържа от Shopify.