Pridobi podatke darilne kartice
V potekih dela, ki zahtevajo podatke darilne kartice, lahko uporabite dejanje Pridobi podatke darilne kartice za pridobitev informacij o darilni kartici iz vaše trgovine.
Pomembno je poudariti, da ima vaša trgovina tako izdelke za darilne kartice, ki se uporabljajo za ustvarjanje darilnih kartic, kot tudi same darilne kartice, ki so dejanske darilne kartice, s katerimi lahko stranke opravijo nakupe. Dejanje Pridobi podatke darilne kartice pridobi informacije o samih darilnih karticah. Če želite pridobiti informacije o izdelkih za darilne kartice, uporabite dejanja Pridobi podatke izdelka ali Pridobi podatke različice izdelka.
Konfiguracija
Polja
Dejanje Pridobi podatke darilne kartice vsebuje naslednja polja, ki se uporabljajo za ustvarjanje poizvedbe:
| Polje | Opis |
|---|---|
| Razvrsti podatke po | Obvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba. |
| Največje število rezultatov | Obvezno. Največje število rezultatov, ki jih lahko vrne iskalna poizvedba, ki jo izberete. Vrniti je mogoče do 100 rezultatov hkrati. |
| Poizvedba | Obvezno. Izbirajte med pogostimi poizvedbami ali izberite Napredno, da ustvarite lastno. |
Niz poizvedbe
To je primer poizvedbe za pridobivanje darilnih kartic, ki so bile posodobljene v zadnjem dnevu:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'Spremenljivka created_at je filter, ki je na voljo v poizvedbi za darilne kartice in ga je mogoče uporabiti večkrat ali kombinirati z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo v potekih dela, ki so uporabili sprožilec Načrtovan čas. Oznaka Liquid date_minus je posebna oznaka Flow, ki vam omogoča odštevanje časa od datuma.
Pri poizvedovanju podatkov je koristno vedeti:
Poizvedbe morajo slediti določeni sintaksi
Vrednosti polj za poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete s pregledom dokumentacije API-ja. Vrednosti polj pogosto najdete tudi v URL-naslovih v skrbniški plošči med filtriranjem. Če želite na primer poiskati nekatere vrednosti poizvedbe za naročilo, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.
Poizvedbo v svoji trgovini lahko zaženete ali preizkusite z uporabo aplikacije Shopify GraphiQL.
Bodite pozorni na to, kaj se zgodi, če je vaša poizvedba neuspešna. API bo pogosto vrnil vse rezultate (namesto nobenega).
Vrnjeni podatki
Vsa dejanja Pridobi podatke vrnejo seznam od 0 do 100 virov. Glede na vaš primer uporabe boste morda te podatke želeli uporabiti na različne načine:
- Če morate vsak element na seznamu obravnavati posamezno, na primer tako, da vsakemu dodate oznako, lahko uporabite dejanje Za vsakega.
- Če morate združiti podatke, na primer prešteti vrnjene rezultate, lahko uporabite dejanji Štetje ali Vsota.
- Če morate izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko uporabite vrnjene podatke neposredno v nadaljnjih dejanjih.
Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke darilne kartice, ki je seznam darilnih kartic. To spremenljivko lahko uporabite v pogojih in dejanjih. Seznam darilnih kartic lahko na primer pošljete v dejanju Pošlji interno e-pošto takole:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}Sprožilci
To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovan čas. V poteku dela, ki uporablja sprožilec Načrtovan čas, se potek dela začne ob času, ki ga določite, in ne kot rezultat dogodka. Ker v vaši trgovini ali iz aplikacije ni določenega dogodka, ki bi zagnal potek dela, podatki niso samodejno vključeni.