Shopify Flow i GraphQL Admin API

Aplikacja Flow używa Shopify GraphQL Admin API do tworzenia automatyzacji i integracji, które rozszerzają i ulepszają panel administracyjny Shopify. Aplikacja Flow używa API w wersji 2026-01 do oceny warunków i zmiennych w przepływach pracy, a także do podejmowania działań w sklepie Shopify. Ponieważ aplikacja Flow uzyskuje dostęp do danych sklepu poprzez wywołanie API, masz z jej poziomu dostęp do prawie wszystkich pól dostępnych w API.

Ponieważ Shopify co 3 miesiące wydaje nowe wersje API, niektóre przepływy pracy mogą wymagać aktualizacji, gdy pola są zmieniane lub wycofywane.

Używanie GraphQL Admin API w przepływach pracy

Większość działań w aplikacji Flow używa GraphQL Admin API do wprowadzania zmian w sklepie Shopify. Na przykład działanie Dodaj tagi zamówienia używa mutacji tagsAdd. Działanie Wyślij żądanie do Admin API może używać większości mutacji, w tym tych, które nie są jeszcze dostępne jako działania w aplikacji Flow.

Podczas tworzenia przepływów pracy często napotkasz nazwy pól i opisy oparte na składni GraphQL Admin API. Na przykład, aby określić całkowitą ilość wariantu możliwego do sprzedania w ramach przepływu pracy, należy użyć zmiennej variants_item.inventoryQuantity. Innym przykładem jest określanie lokalizacji, w której klient zapisał się na newsletter e-mail — w tym celu należy użyć zmiennej emailSubscriptionMethod.

Nie musisz biegle posługiwać się API, aby tworzyć przepływy pracy za pomocą aplikacji Flow, ale zrozumienie nazw zmiennych i ich definicji może pomóc w budowaniu określonej logiki przepływu pracy. Na przykład znajomość różnicy między displayName a firstName klienta może pomóc przepływowi pracy uzyskać dostęp do prawidłowych danych w zależności od tego, do czego chcesz ich użyć. Definicje są dołączone do każdej zmiennej podczas tworzenia przepływu pracy i możesz kliknąć ikonę , aby dowiedzieć się więcej o dowolnej zmiennej lub definicji.

Dane sklepu i GraphQL Admin API

Przepływy pracy wykorzystują dane ze sklepu w warunkach i działaniach. Aplikacja Flow uzyskuje dostęp do danych sklepu za pomocą GraphQL Admin API, co oznacza, że masz dostęp do prawie wszystkich pól w API. Jeśli działanie nie ma niezbędnych danych dostarczonych przez wyzwalacz lub działanie Pobierz dane, przepływ pracy nie zostanie uruchomiony i zostanie wyświetlony komunikat o błędzie.

Na przykład przepływ pracy rozpoczyna się od wyzwalacza Klient utworzony i importuje dane klienta do przepływu pracy. Jeśli po tym wyzwalaczu następuje działanie Dodaj tagi zamówienia, które wymaga danych zamówienia, a nie danych klienta, w przepływie pracy wystąpi błąd braku danych.

Może być konieczne wyświetlenie podglądu danych lub przejrzenie dokumentacji API, aby zrozumieć, jakie dane są zwracane przez API i używane w aplikacji Flow, oraz aby upewnić się, że przepływ pracy zwraca oczekiwane dane.

Argumenty pól i GraphQL Admin API

Niektóre pola GraphQL Admin API wymagają argumentów, czyli dodatkowych parametrów, które zawężają zwracane dane. Na przykład pole product.inCollection potrzebuje argumentu id kolekcji, aby wiedzieć, którą kolekcję sprawdzić. Bez niego pole nie może zwrócić wyniku.

W Flow możesz tworzyć zmienne z tych pól, podając wymaganą wartość argumentu, którą można następnie wykorzystać w przepływie pracy. Możesz także przypisać zmiennej niestandardową nazwę, aby ułatwić odwoływanie się do niej w kolejnych krokach, na przykład nazywając product.inCollection(id: "gid://shopify/Collection/123456") jako product.inSummerBestsellers.

Dowiedz się więcej o tworzeniu zmiennych z pól z argumentami.

Tworzenie zmiennych z metapól wymaga dodatkowych informacji w Flow, ponieważ przestrzeń nazw i klucz każdego metapola definiujesz samodzielnie, więc argumenty są zawsze unikalne dla Twojego sklepu. Dowiedz się więcej o metapolach w Flow.

Wersjonowanie API

Shopify co 3 miesiące wydaje nowe wersje API, a aplikacja Flow wdraża nowe wersje tak szybko, jak to możliwe, ale może nie być w pełni zaktualizowana do najnowszej wersji. W miarę możliwości zmiany między wersjami są rozwiązywane automatycznie, ale niektóre zmiany mogą nie być proste, w tym w następujących sytuacjach:

• Gdy pola są usuwane, ale nie jest zapewnione żadne zastępstwo, co może mieć wpływ na sposób oceny warunków lub kodu Liquid.
• Gdy pola stają się dopuszczające wartość null, co może mieć wpływ na sposób oceny warunków lub kodu Liquid.
• Gdy zmieniają się wartości typu enum lub dodawane są nowe typy unii lub interfejsu, co może mieć wpływ na kod Liquid lub inny kod.
• Gdy zmieniają się argumenty mutacji, co może mieć wpływ na konfigurację działań typu Wyślij żądanie do Admin API.

Niektóre przepływy pracy mogą wymagać ręcznej aktualizacji. W takich przypadkach przepływy pracy mogą wyświetlać błąd Wymagana aktualizacja lub Nieobsługiwane API i odsyłać do odpowiedniej dokumentacji API w celu wprowadzenia wymaganych zmian w edytorze przepływu pracy. Po zakończeniu i zapisaniu tych aktualizacji przepływ pracy automatycznie zaktualizuje się do najnowszej wersji API dostępnej w aplikacji Flow.

Możesz tymczasowo zignorować problemy, aby wprowadzić pilne zmiany w przepływie pracy z błędami zgodności wersji API. Jeśli te problemy nie zostaną rozwiązane, przepływ pracy może przestać działać lub powodować błędy, gdy starsza wersja API nie będzie już obsługiwana przez Shopify.