Pobierz dane rynku

W przepływach pracy, które wymagają danych o rynku, możesz użyć akcji Pobierz dane rynku, aby pobrać informacje o rynkach ze sklepu Shopify. Rynki to grupy regionów lub lokalizacji, do których kierujesz swoją sprzedaż.

Na tej stronie

Konfiguracja

Pola

Akcja Pobierz dane rynku zawiera następujące pola:

Pola używane w akcjach typu Pobierz dane.
Pole	Opis
Sortuj dane według	Wymagane. Parametry określające sposób sortowania danych zwróconych przez zapytanie wyszukiwania.
Maksymalna liczba wyników	Wymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednorazowo można zwrócić maksymalnie 100 wyników.
Zapytanie	Wymagane. Wybierz spośród typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne.

Ciąg zapytania

To jest przykładowe zapytanie służące do pobierania wszystkich aktywnych rynków:

status:ACTIVE

Zmienna status to filtr dostępny w zapytaniu Markets, którego można użyć wielokrotnie lub połączyć z innymi zmiennymi.

Podczas tworzenia zapytań o dane warto wiedzieć, że:

Lista dostępnych filtrów rynków
Zapytania muszą być zgodne z określoną składnią
Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach można je znaleźć w dokumentacji API. Często wartości pól można również znaleźć w adresach URL w panelu administracyjnym podczas filtrowania. Na przykład, aby znaleźć niektóre wartości dla zapytania Order, przefiltruj stronę Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.
Możesz uruchomić lub przetestować zapytanie w sklepie, używając aplikacji Shopify GraphiQL.
Pamiętaj o tym, co się stanie, jeśli zapytanie się nie powiedzie. Często API zwraca wszystkie wyniki (zamiast żadnego).

Zwrócone dane

Wszystkie akcje Pobierz dane zwracają listę zawierającą od 0 do 100 zasobów. W zależności od przypadku użycia możesz wykorzystać te dane na różne sposoby:

Jeśli musisz przetworzyć każdą pozycję z listy z osobna, na przykład po to, aby dodać do niej tag, możesz użyć akcji Dla każdego.
Jeśli musisz zagregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć akcji Policz lub Zsumuj.
Jeśli musisz wygenerować listę jako dane wyjściowe, na przykład po to, aby wysłać e-mail ze wszystkimi pozycjami, możesz wykorzystać zwrócone dane bezpośrednio w kolejnych akcjach.

Aby uzyskać dostęp do zwróconych danych w krokach następujących po tej akcji, użyj zmiennej o nazwie Pobierz dane rynku, która jest listą rynków. Zmiennej tej można używać zarówno w warunkach, jak i akcjach. Możesz na przykład wysłać listę rynków w akcji Wyślij wewnętrzny e-mail podobnej do tej:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Wyzwalacze

Możesz użyć tej akcji w dowolnym przepływie pracy, w tym w połączeniu z wyzwalaczem Zaplanowany czas. W przepływie pracy, w którym wykorzystano wyzwalacz Zaplanowany czas, działanie jest uruchamiane o podanej godzinie, a nie w wyniku zdarzenia. Ponieważ żadne konkretne zdarzenie w sklepie ani w aplikacji nie uruchamia przepływu pracy, żadne dane nie są uwzględniane automatycznie.

Dokumentacja API

Więcej informacji o API używanym w tej akcji znajdziesz w sekcji zapytanie Markets.