Pobierz dane lokalizacji

W workflow, które wymagają danych o lokalizacji, możesz użyć akcji Pobierz dane lokalizacji, aby pobrać informacje o lokalizacji z Twojego sklepu Shopify. Lokalizacje to dowolne miejsca, w których przechowujesz zapasy, sprzedajesz produkty lub wysyłasz bądź realizujesz zamówienia.

Na tej stronie

Konfiguracja

Pola

Akcja Pobierz dane lokalizacji zawiera następujące pola.

Pola używane w akcjach Pobierz dane.
Pole	Opis
Sortuj dane według	Wymagane. Parametry, według których sortowane są dane zwrócone 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ć do 100 wyników.
Zapytanie	Wymagane. Wybierz spośród typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne.

Ciąg zapytania

Oto przykładowe zapytanie dotyczące pobierania lokalizacji, w których włączono opcję odbioru w sklepie:

pickup_in_store:enabled

Zmienna pickup_in_store to filtr dostępny w zapytaniu o lokalizacje, który można stosować wielokrotnie lub łączyć z innymi zmiennymi.

Podczas wysyłania zapytań o dane warto wiedzieć o następujących kwestiach:

Lista dostępnych filtrów lokalizacji
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źć, przeglądając dokumentację API. Alternatywnie często można znaleźć wartości pól w adresach URL w panelu administracyjnym podczas filtrowania. Na przykład, aby znaleźć niektóre wartości zapytań dotyczących zamówień, przefiltruj stronę Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.
Możesz uruchomić lub przetestować zapytanie w swoim sklepie, korzystając z aplikacji Shopify GraphiQL.
Należy pamiętać o tym, co się stanie, jeśli zapytanie zakończy się niepowodzeniem. Często API zwróci wszystkie wyniki (zamiast żadnego).

Zwrócone dane

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

Jeśli chcesz obsłużyć każdą pozycję listy indywidualnie, na przykład w celu dodania tagu do każdej z nich, możesz użyć akcji Dla każdego.
Jeśli chcesz agregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć akcji Policz lub Suma.
Jeśli chcesz przekazać listę, na przykład wysłać e-mail ze wszystkimi pozycjami, możesz użyć zwróconych danych 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 lokalizacji, która jest listą lokalizacji. Możesz użyć tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę lokalizacji w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Wyzwalacze

Możesz użyć tej akcji w dowolnym workflow, w tym w wyzwalaczu Zaplanowany czas. W workflow, który używa wyzwalacza Zaplanowany czas, workflow uruchamia się o określonej przez Ciebie godzinie, a nie w wyniku zdarzenia. Ponieważ nie ma konkretnego zdarzenia w Twoim sklepie lub z aplikacji, które uruchamia workflow, żadne dane nie są dołączane automatycznie.

Dokumentacja API

Więcej informacji na temat API używanego w tej akcji można znaleźć w zapytaniu o lokalizacje.