Dohvati podatke o tržištu
U tijekovima rada koji zahtijevaju podatke o tržištu možete upotrijebiti radnju Dohvati podatke o tržištu za dohvaćanje informacija o tržištu iz vaše trgovine Shopify. Tržišta su grupe regija ili lokacija koje ciljate za prodaju.
Na ovoj stranici
Konfiguracija
Polja
Radnja Dohvati podatke o tržištu sadrži sljedeća polja:
| 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 rezultata 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 svih aktivnih tržišta:
status:ACTIVEVarijabla status jest filtar dostupan u upitu za tržišta i može se upotrebljavati više puta ili u kombinaciji s drugim varijablama.
Prilikom slanja upita za podatke korisno je znati sljedeće:
Upiti moraju slijediti određenu sintaksu
Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći u API dokumentaciji. Također, vrijednosti polja često možete pronaći u URL-ovima u administratorskoj ploči prilikom filtriranja. Na primjer, kako biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe u administratorskoj ploči, a zatim provjerite URL.
Upit možete pokrenuti ili testirati u svojoj trgovini pomoću aplikacije Shopify GraphiQL.
Imajte na umu što se događa ako 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žda ćete htjeti upotrijebiti na različite načine:
- Ako trebate pojedinačno obraditi svaku stavku s popisa, primjerice, kako biste svakoj dodali oznaku, možete upotrijebiti radnju Za svaku.
- Ako trebate zbrojiti podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnju Brojanje ili Zbroj.
- Ako trebate ispisati popis, primjerice, poslati e-poruku sa svim stavkama, vraćene podatke možete izravno upotrijebiti u sljedećim radnjama.
Da biste pristupili vraćenim podacima u koracima koji slijede ovu radnju, upotrijebite varijablu pod nazivom Dohvati podatke o tržištu koja predstavlja popis tržišta. Ovu varijablu možete upotrijebiti u uvjetima i radnjama. Na primjer, popis tržišta možete poslati u radnji Slanje interne e-poruke slično ovome:
{% for single_market in GetMarketData %}
* {{ single_market.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 nekog događaja. Budući da ne postoji određeni događaj u vašoj trgovini ili iz aplikacije koji započinje tijek rada, nema automatski uključenih podataka.
Referenca za API
Za više informacija o API-ju koji se upotrebljava u ovoj radnji, pogledajte upit za tržišta.