Kedvezményadatok lekérése

A kedvezményadatokat igénylő munkafolyamatokban a Kedvezményadatok lekérése művelettel kérhet le kedvezményinformációkat az üzletéből.

Konfiguráció

Mezők

A Kedvezményadatok lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés összeállítására szolgálnak:

Az Adatok lekérése műveletekben használt mezők.
MezőLeírás
Rendezési szempontKötelező. Azok a paraméterek, amelyek szerint a keresési lekérdezés által visszaadott adatokat rendezi a rendszer.
Eredmények maximális számaKötelező. A kiválasztott keresési lekérdezés által visszaadható eredmények maximális száma. Egyszerre legfeljebb 100 adható vissza.
LekérdezésKötelező. Válasszon a gyakori lekérdezések közül, vagy válassza a Speciális lehetőséget saját lekérdezés létrehozásához.

Lekérdezési karakterlánc

Az alábbiakban egy példa látható egy olyan lekérdezésre, amely a kódot használó aktív kedvezményeket kéri le:

method:code AND status:active

A method és a status változók a Kedvezmény csomópont lekérdezésében elérhető szűrők, amelyek többször is használhatók vagy más változókkal kombinálhatók.

Adatok lekérdezésekor hasznos tudni a következőket:

  • Az elérhető kedvezményszűrők listája.
  • A lekérdezéseknek egy bizonyos szintaxist kell követniük
  • A lekérdezési mezőértékek nem mindig dokumentáltak. Egyes esetekben az értékek az API-dokumentációban is megtalálhatók. Alternatívaként a mezőértékeket gyakran megtalálhatja az adminisztrációs felület URL-jeiben, amikor szűr. Ha például rendelésekre vonatkozó lekérdezési értékeket szeretne találni, szűrjön a Rendelések oldalon az adminisztrációs felületen, majd ellenőrizze az URL-t.
  • A lekérdezéseket a Shopify GraphiQL alkalmazás segítségével futtathatja vagy tesztelheti az üzletében.
  • Figyeljen arra, mi történik, ha a lekérdezése sikertelen. Az API gyakran az összes eredményt adja vissza (ahelyett, hogy egyet se).

Visszaadott adatok

Az összes Adatok lekérése művelet egy 0 és 100 közötti erőforrást tartalmazó listát ad vissza. A felhasználási esettől függően ezeket az adatokat többféleképpen is felhasználhatja:

  • Ha minden listaelemet egyenként szeretne kezelni, például mindegyikhez címkét adni, akkor használhatja a Minden elemre műveletet.
  • Ha összesíteni szeretné az adatokat, például megszámolni, hogy hány eredmény érkezett, akkor a Darabszám vagy a Összeg műveletet használhatja.
  • Ha a teljes listát szeretné kimenetként használni, például e-mailt küldeni az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.

A műveletet követő lépésekben a visszaadott adatok eléréséhez használja a Get discount data nevű változót, amely egy kedvezménylista. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti az automatikus alkalmazáskedvezmények listáját egy Belső e-mail küldése műveletben az alábbiak szerint:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Kiváltók

Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Időzített kiváltót is. Az Időzített kiváltót használó munkafolyamat egy Ön által megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel a munkafolyamatot nem egy konkrét esemény indítja el az üzletében vagy egy alkalmazásban, így az automatikusan nem tartalmaz adatokat.

API-részletek

Sablonok

Heti összefoglaló e-mail a kódos, aktív kedvezményekről

Összefoglalót küld e-mailben a kódot használó aktív kedvezményekről. A munkafolyamat ütemezés szerint fut minden hétfőn reggel 9 órakor. A munkafolyamat testreszabható, így módosíthatja az időzítést, az összefoglaló fogadásának módját, a belefoglalandó kedvezmények típusát és az üzemmódot. Sablon megtekintése