Shopify Flow i GraphQL Admin API

Flow wykorzystuje Shopify GraphQL Admin API do tworzenia automatyzacji i integracji, które rozszerzają i udoskonalają panel administracyjny Shopify. Flow obecnie korzysta z wersji 2024-07 API w celu oceny warunków i zmiennych w przepływach pracy, a także podejmowania działań w Twoim sklepie Shopify. Ponieważ Flow uzyskuje dostęp do danych sklepu poprzez wywołanie interfejsu API, z poziomu Flow masz dostęp do niemal wszystkich pól dostępnych w interfejsie API.

Większość czynności we Flow używa interfejsu API do wprowadzania zmian w sklepie Shopify. Na przykład czynność Dodaj tagi zamówienia używa mutacji tagsAdd . Czynność Wyślij żądanie API Admin może używać większości mutacji, w tym mutacji, które nie są jeszcze dostępne jako czynności we Flow.

Podczas tworzenia przepływów pracy często natkniesz się na nazwy pól i opisy oparte na API. Może być konieczne wyświetlenie podglądu danych lub zapoznanie się z dokumentacją interfejsu API, aby zrozumieć, co jest generowane przez interfejs API i wykorzystywane w usłudze Flow, a także aby upewnić się, że Twój przepływ pracy generuje oczekiwane dane.

Wersjonowanie API

Shopify wydaje nowe wersje API co trzy miesiące, a Flow wdraża nowe wersje tak szybko, jak to możliwe, ale może wystąpić opóźnienie w stosunku do najnowszej wersji. Jeśli to możliwe, zmiany między wersjami są rozwiązywane automatycznie, ale niektóre zmiany mogą nie być proste, między innymi: * Jeśli po usunięciu pól nie zostanie podany żaden element zastępujący, może to mieć wpływ na sposób oceny warunków lub kodu Liquid. * Gdy pola stają się polami dopuszczającymi wartość null, mając możliwy wpływ na sposób oceny warunków lub kodu Liquid. * Gdy zmieniają się wartości wyliczeń lub dodawane są nowe typy połączeń lub interfejsów, mając możliwy wpływ na Liquid lub kod. * Gdy argumenty mutacji ulegną zmianie, mając możliwy wpływ na konfigurację czynności Wyślij żądanie API Admin.

Niektóre procesy workflow mogą wymagać ręcznego uaktualnienia. W takich przypadkach procesy workflow mogą wyświetlać błąd Wymagane uaktualnienie lub Nieobsługiwane API i kierować użytkownika do odpowiedniej dokumentacji API w celu wprowadzenia wymaganych zmian w edytorze procesu workflow. Po zakończeniu i zapisaniu tych uaktualnień proces workflow zostanie automatycznie uaktualniony, aby móc korzystać z najnowszej wersji API dostępnej we Flow.

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