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.

Konfiguracija

Polja

Radnja Dohvati podatke o tržištu sadrži sljedeća polja:

Polja koja se upotrebljavaju u radnjama dohvaćanja podataka.
PoljeOpis
Razvrstaj podatke poObavezno. Parametri prema kojima se razvrstavaju podaci koje vraća upit za pretraživanje.
Maksimalan broj rezultataObavezno. Maksimalan broj rezultata koji može vratiti odabrani upit za pretraživanje. Možete vratiti do 100 rezultata odjednom.
UpitObavezno. 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:ACTIVE

Varijabla 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:

  • Popis dostupnih filtara tržišta

  • 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.