Dohvati podatke o poklon kartici

U tijekovima rada koji zahtijevaju podatke o poklon kartici možete upotrijebiti radnju Dohvati podatke o poklon kartici za dohvaćanje informacija o poklon kartici iz svoje trgovine.

Važno je napomenuti da vaša trgovina sadrži proizvode u obliku poklon kartica koji se upotrebljavaju za generiranje poklon kartica, te same poklon kartice koje korisnici mogu upotrijebiti za kupnju. Radnja Dohvati podatke o poklon kartici dohvaća informacije o samim poklon karticama. Da biste dobili informacije o proizvodima u obliku poklon kartica, upotrijebite radnje Dohvati podatke o proizvodu ili Dohvati podatke o varijanti proizvoda.

Na ovoj stranici

Konfiguracija

Polja

Radnja Dohvati podatke o poklon kartici sadrži sljedeća polja koja se upotrebljavaju za izradu upita:

Polja koja se upotrebljavaju u radnjama Dohvati podatke.
Polje	Opis
Razvrstaj podatke po	Obavezno. Parametri prema kojima se razvrstavaju podaci koje vraća upit za pretraživanje.
Maksimalan broj rezultata	Obavezno. Maksimalan broj rezultata koji može vratiti odabrani upit za pretraživanje. Možete vratiti do 100 odjednom.
Upit	Obavezno. Odaberite među uobičajenim upitima ili odaberite Napredno da biste izradili vlastiti.

Niz upita

Ovo je primjer upita za dohvaćanje poklon kartica koje su ažurirane tijekom prošlog dana:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Varijabla created_at je filtar dostupan u upitu za poklon kartice i može se upotrijebiti više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada koji su upotrebljavali pokretač Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka za Flow koja vam omogućuje oduzimanje vremena od datuma.

Prilikom postavljanja upita za podatke korisno je znati sljedeće:

Popis dostupnih filtara za poklon kartice
Upiti moraju slijediti određenu sintaksu
Vrijednosti polja upita nisu uvijek dokumentirane. U nekim slučajevima te se vrijednosti mogu pronaći pregledom dokumentacije za API. Vrijednosti polja možete često pronaći i u URL-ovima u administratorskoj ploči prilikom filtriranja. Na primjer, da biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe u administratorskoj ploči, a zatim provjerite URL.
Možete pokrenuti ili testirati upit u svojoj trgovini pomoću aplikacije Shopify GraphiQL.
Imajte na umu što se događa ako vaš upit ne uspije. Često će API vratiti sve rezultate (umjesto nijednog).

Vraćeni podaci

Sve radnje Dohvati podatke vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možete upotrijebiti na razne načine:

Ako trebate obraditi svaku stavku popisa pojedinačno, na primjer dodati oznaku za svaku, možete upotrijebiti radnju Za svaki.
Ako trebate agregirati podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnje Prebroji ili Zbroji.
Ako trebate ispisati popis, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete upotrijebiti izravno u sljedećim radnjama.

Da biste pristupili vraćenim podacima u koracima koji slijede nakon ove radnje, upotrijebite varijablu pod nazivom Dohvati podatke o poklon kartici, koja je popis poklon kartica. Tu varijablu možete upotrijebiti u uvjetima i radnjama. Na primjer, popis poklon kartica možete poslati u radnji Pošalji internu e-poruku na sljedeći način:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Pokretači

Ovu radnju možete upotrijebiti u bilo kojem tijeku rada, uključujući pokretač Zakazano vrijeme. U tijeku rada koji upotrebljava pokretač Zakazano vrijeme, tijek rada započinje u vrijeme koje ste odredili, a ne kao rezultat događaja. Budući da ne postoji određeni događaj u vašoj trgovini ili iz aplikacije koji pokreće tijek rada, podaci se ne uključuju automatski.