Pobierz dane próby rozliczenia subskrypcji
W workflow, które wymagają danych o próbie rozliczenia subskrypcji, możesz użyć akcji „Pobierz dane próby rozliczenia subskrypcji”, aby pobrać informacje o zamówieniu ze sklepu.
Na tej stronie
Konfiguracja
Pola
Akcja „Pobierz dane próby rozliczenia subskrypcji” 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żna zwrócić do 100 wyników. |
| Zapytanie | Wymagane. Wybierz jedno z typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne. |
Ciąg zapytania
To jest przykładowe zapytanie do pobierania prób rozliczenia subskrypcji, które zostały utworzone w ciągu ostatnich trzech dni:
created_at:>'{{ createdAt | date_minus: "3 day" }}'Zmienna created_at to filtr dostępny w zapytaniu o próbę rozliczenia subskrypcji, który może być używany do wybierania określonych komunikatów o błędach dla prób rozliczenia subskrypcji.
Podczas wysyłania zapytań o dane warto wiedzieć:
- Lista dostępnych filtrów dla prób rozliczenia subskrypcji
- 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. Alternatywnie, wartości pól można często znaleźć w adresach URL w panelu administracyjnym po zastosowaniu filtrów. Na przykład, aby znaleźć niektóre wartości zapytania dotyczącego 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 zakończy się niepowodzeniem. Często API zwróci wszystkie wyniki (zamiast żadnego).
Zwrócone dane
Wszystkie akcje typu 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 obsłużyć każdą pozycję z listy osobno, np. dodać do każdej tag, możesz użyć akcji Dla każdego.
- Jeśli chcesz agregować dane, na przykład zliczyć, ile wyników zostało zwróconych, możesz użyć akcji Zlicz lub Sumuj.
- Jeśli chcesz wykorzystać listę, na przykład wysłać e-mail zawierający wszystkie pozycje, 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 o próbach rozliczenia subskrypcji, która jest listą prób rozliczenia subskrypcji. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Możesz na przykład wysłać listę prób rozliczenia subskrypcji w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Przykład
Na przykład, workflow jest zaplanowany do uruchomienia w każdą niedzielę o 9:00. Akcja Pobierz dane o próbach rozliczenia subskrypcji służy do zbierania danych dotyczących prób rozliczenia subskrypcji utworzonych w ostatnim tygodniu. Jeśli zawierają komunikat o błędzie, wyślij e-mail z próbami rozliczenia.