Piacadatok lekérése
Azokban a munkafolyamatokban, amelyek piacadatokat igényelnek, a Piacadatok lekérése művelettel kérhet le piaci információkat a Shopify-üzletből. A Piacok olyan régiók vagy helyszínek csoportjai, amelyeket értékesítés céljából megcéloz.
Ezen az oldalon
Konfiguráció
Mezők
A Piacadatok lekérése művelet a következő mezőket tartalmazza:
| Mező | Leírás |
|---|---|
| Adatok rendezési szempontja | Kötelező. A paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve vannak. |
| 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-at adhat vissza. |
| Lekérdezés | Kötelező. Válasszon a gyakori lekérdezések közül, vagy a saját lekérdezés létrehozásához válassza a Speciális lehetőséget. |
Lekérdezési karakterlánc
Ez egy példalekérdezés az összes aktív piac lekérésére:
status:ACTIVEA status változó egy elérhető szűrő a Piacok lekérdezésben, amely többször is használható, vagy más változókkal is kombinálható.
Adatok lekérdezésekor hasznos tudni a következőket:
A lekérdezéseknek egy bizonyos szintaxist kell követniük
A lekérdezési mezők értékei nincsenek mindig dokumentálva. Bizonyos esetekben az értékek az API-dokumentációban találhatók meg. Másik megoldásként szűréskor a mezők értékeit gyakran az adminisztrációs felület URL-címeiben is megtalálhatja. Ha például rendeléslekérdezési értékeket szeretne találni, szűrje a Rendelések oldalt az adminisztrációs felületen, majd ellenőrizze az URL-t.
Az üzletében a Shopify GraphiQL alkalmazás segítségével futtathat vagy tesztelhet egy lekérdezést.
Vegye figyelembe, mi történik, ha a lekérdezés sikertelen. Az API gyakran az összes eredményt visszaadja (nem pedig 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 a lista minden elemét külön kell kezelnie, például mindegyikhez egy címkét szeretne hozzáadni, akkor használhatja a Minden egyes műveletet.
- Ha összesítenie kell az adatokat (például meg kell számolnia a visszaadott eredményeket), akkor használhatja a Számlálás vagy az Összegzés műveletet.
- Ha ki kell adnia a listát – például e-mailben el szeretné küldeni az összes tételt –, akkor a visszaadott adatokat közvetlenül is felhasználhatja a későbbi műveletekben.
A visszaadott adatok eléréséhez a műveletet követő lépésekben használja a Piacadatok lekérése nevű változót, amely a piacok listáját tartalmazza. Ezt a változót a feltételekben és a műveletekben egyaránt használhatja. A piacok listáját például elküldheti egy Belső e-mail küldése műveletben, az alábbihoz hasonlóan:
{% for single_market in GetMarketData %}
* {{ single_market.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ó munkafolyamatok a megadott időpontban indulnak el, nem pedig egy esemény bekövetkezésekor. Mivel nincs olyan konkrét esemény az üzletben vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, ezért nincsenek automatikusan továbbított adatok.
API-referencia
A műveletben használt API-val kapcsolatos további információkért tekintse meg a következőt: Piacok lekérdezés.