Pridobi podatke o poskusih zaračunavanja naročnine
V potekih dela, ki zahtevajo podatke o poskusih zaračunavanja naročnine, lahko uporabite dejanje Pridobi podatke o poskusih zaračunavanja naročnine, da iz svoje trgovine pridobite informacije o naročilu.
Na tej strani
Konfiguracija
Polja
Dejanje Pridobi podatke o poskusih zaračunavanja naročnine vsebuje naslednja polja, ki se uporabljajo za pripravo poizvedbe:
| Polje | Opis |
|---|---|
| Razvrsti podatke po | Obvezno. Parametri, po katerih se razvrščajo podatki, ki jih vrne iskalna poizvedba. |
| Največje število rezultatov | Obvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat lahko vrnete do 100 rezultatov. |
| Poizvedba | Obvezno. Izberite med pogostimi poizvedbami ali izberite možnost Napredno, da ustvarite svojo. |
Niz poizvedbe
To je primer poizvedbe za pridobivanje poskusov zaračunavanja naročnine, ki so bili ustvarjeni v zadnjih treh dneh:
created_at:>'{{ createdAt | date_minus: "3 day" }}'Spremenljivka created_at je filter, ki je na voljo v poizvedbi o poskusih zaračunavanja naročnine, in se lahko uporabi za izbiro določenih sporočil o napaki za poskuse zaračunavanja naročnine.
Pri poizvedovanju po podatkih je dobro vedeti naslednje:
- Seznam razpoložljivih filtrov za poskuse zaračunavanja naročnine
- Poizvedbe morajo slediti določeni sintaksi
- Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji za API. Pogosto pa lahko vrednosti polj najdete tudi v URL-naslovih v skrbniški plošči, ko uporabite filtre. Za iskanje nekaterih vrednosti poizvedbe za naročila na primer filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.
- Poizvedbo lahko zaženete ali preizkusite v svoji trgovini z uporabo aplikacije Shopify GraphiQL.
- Bodite pozorni na to, kaj se zgodi, če vaša poizvedba ni uspešna. API bo pogosto vrnil vse rezultate (namesto nobenega).
Vrnjeni podatki
Vsa dejanja tipa Pridobi podatke vrnejo seznam od 0 do 100 virov. Glede na vaš primer uporabe boste morda želeli te podatke uporabiti na različne načine:
- Če morate vsak element seznama obravnavati posamezno, na primer tako, da mu dodate oznako, lahko uporabite dejanje Za vsakega.
- Če morate zbrati podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanja Preštej ali Vsota.
- Če želite izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v naslednjih dejanjih.
Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke o poskusu zaračunavanja naročnine, ki je seznam poskusov zaračunavanja naročnine. To spremenljivko lahko uporabite v pogojih in dejanjih. Seznam poskusov zaračunavanja naročnine lahko na primer pošljete v dejanju Pošlji interno e-pošto takole:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Primer
Potek dela je na primer načrtovan za izvajanje vsako nedeljo ob 9. uri. Dejanje Pridobi podatke o poskusu zaračunavanja naročnine se uporablja za zbiranje podatkov o poskusih zaračunavanja naročnine, ustvarjenih v prejšnjem tednu. Če vsebujejo sporočilo o napaki, se pošlje e-pošta s poskusi zaračunavanja.