Pobierz dane karty prezentowej
W workflow, które wymagają danych kart prezentowych, możesz użyć akcji Pobierz dane karty prezentowej, aby pobrać informacje o kartach prezentowych ze swojego sklepu.
Co ważne, w Twoim sklepie znajdują się zarówno produkty będące kartami prezentowymi, które służą do generowania kart prezentowych, jak i same karty prezentowe, czyli rzeczywiste karty, za pomocą których klienci mogą dokonywać zakupów. Akcja Pobierz dane karty prezentowej pobiera informacje o samych kartach prezentowych. Aby uzyskać informacje o produktach będących kartami prezentowymi, użyj akcji Pobierz dane produktu lub Pobierz dane wariantu produktu.
Na tej stronie
Konfiguracja
Pola
Akcja Pobierz dane karty prezentowej zawiera następujące pola, które służą do tworzenia zapytania:
| 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żesz zwrócić do 100 wyników. |
| Zapytanie | Wymagane. Wybierz spośród popularnych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne. |
Ciąg zapytania
To jest przykładowe zapytanie dotyczące pobierania kart prezentowych, które zostały zaktualizowane w ostatnim dniu:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'Zmienna created_at jest filtrem dostępnym w zapytaniu o karty prezentowe i może być używana wielokrotnie lub w połączeniu z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w workflow, które używają wyzwalacza Zaplanowany czas. Tag Liquid date_minus to specjalny tag Flow, który pozwala odjąć czas od daty.
Podczas wysyłania zapytań o dane warto wiedzieć:
Zapytania muszą mieć określoną składnię
Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach można je znaleźć w dokumentacji API. Wartości te można też często znaleźć w adresach URL w panelu administracyjnym podczas filtrowania. Aby na przykład 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 sklepie za pomocą aplikacji Shopify GraphiQL.
Pamiętaj o tym, co się stanie, jeśli zapytanie się nie powiedzie. Często API zwróci 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 chcesz przetwarzać każdy element listy pojedynczo, na przykład aby dodać tag do każdego z nich, możesz użyć akcji Dla każdego.
- Jeśli potrzebujesz zagregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć akcji Policz lub Suma.
- Jeśli chcesz wykorzystać listę wyników, na przykład, aby 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 kolejnych krokach, użyj zmiennej o nazwie Pobierz dane karty prezentowej, która jest listą kart prezentowych. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład, możesz wysłać listę kart prezentowych w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}Wyzwalacze
Możesz użyć tej akcji w dowolnym workflow, w tym w wyzwalaczu Zaplanowany czas. W przypadku workflow korzystającego z wyzwalacza Zaplanowany czas, uruchamia się on o określonej przez Ciebie godzinie, a nie w wyniku zdarzenia. Ponieważ żadne konkretne zdarzenie w sklepie ani w aplikacji nie uruchamia workflow, żadne dane nie są automatycznie dołączane.