Ajándékkártya-adatok lekérése
Azokban a munkafolyamatokban, amelyek ajándékkártya-adatokat igényelnek, az Ajándékkártya-adatok lekérése művelettel kérhet le ajándékkártya-információkat az üzletéből.
Fontos, hogy az üzletében léteznek ajándékkártya-termékek, amelyek ajándékkártyák létrehozására szolgálnak, és maguk az ajándékkártyák is, amelyeket a vásárlók vásárlásra használhatnak. Az Ajándékkártya-adatok lekérése művelet magukról az ajándékkártyákról kér le információkat. Az ajándékkártya-termékekkel kapcsolatos információk lekéréséhez használja a Termékadatok lekérése vagy a Termékváltozat-adatok lekérése műveleteket.
Ezen az oldalon
Konfiguráció
Mezők
Az Ajándékkártya-adatok lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés létrehozásához használhatók:
| Mező | Leírás |
|---|---|
| Adatok rendezése | Kötelező. A paraméterek, amelyek alapján a keresési lekérdezés a visszaadott adatokat rendezi. |
| Találatok maximális száma | Kötelező. A kiválasztott keresési lekérdezés által visszaadható találatok maximális száma. Egyszerre legfeljebb 100 találatot adhat vissza. |
| Lekérdezés | Kö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ó az elmúlt napon frissített ajándékkártyák lekérdezésére:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'A created_at változó az ajándékkártyákra vonatkozó lekérdezésben elérhető szűrő, és többször is használható, vagy más változókkal kombinálható. A scheduledAt Liquid változó az Ütemezett időpont kiváltót használó munkafolyamatokban érhető el. A date_minus Liquid címke egy speciális Flow-címke, amely lehetővé teszi, hogy időt vonjon le egy dátumból.
Az adatok lekérdezésekor hasznos tudni a következőket:
A lekérdezéseknek egy adott szintaxist kell követniük
A lekérdezési mezők értékei nincsenek mindig dokumentálva. Bizonyos esetekben az értékek megtalálhatók az API-dokumentációban. Másik lehetőségként a mezőértékeket gyakran megtalálhatja az URL-ekben az adminisztrációs felületen történő szűréskor. Ha például rendeléslekérdezési értékeket szeretne keresni, szűrjön a Rendelések oldalon az adminisztrációs felületen, majd ellenőrizze az URL-t.
A Shopify GraphiQL alkalmazás használatával lefuttathat vagy tesztelhet egy lekérdezést az üzletében.
Figyeljen arra, hogy mi történik, ha a lekérdezés sikertelen. Az API gyakran az összes eredményt adja vissza (ahelyett, hogy egyet sem).
Visszaadott adatok
Minden 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 kell kezelnie, például mindegyikhez címkét kell hozzáadnia, akkor használhatja a „Minden elemre” műveletet.
- Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt kapott, akkor használhatja a „Számlálás” vagy a „Összegzés” műveletet.
- Ha ki kell adnia a listát, például hogy e-mailt küldjön az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.
Ahhoz, hogy a műveletet követő lépésekben hozzáférjen a visszaadott adatokhoz, használja az Ajándékkártya-adatok lekérése nevű változót, amely egy ajándékkártyákból álló lista. Ezt a változót feltételekben és műveletekben is használhatja. Például az ajándékkártyák listáját a következőképpen küldheti el a Belső e-mail küldése műveletben:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}Kiváltók
Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett időpont kiváltót is. Az Ütemezett időpont kiváltót használó munkafolyamat az Ön által megadott időpontban indul el, nem pedig egy esemény hatására. Mivel nincs olyan konkrét esemény az üzletében vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, ezért nincsenek automatikusan belefoglalt adatok.