Pomoč
Prijava

Pridobi podatke o trgu

V potekih dela, ki zahtevajo podatke o trgu, lahko uporabite dejanje Pridobi podatke o trgu, da pridobite informacije o trgu iz vaše trgovine Shopify. Trgi so skupine regij ali lokacij, na katere ciljate s prodajo.

Na tej strani

Konfiguracija

Polja

Dejanje Pridobi podatke o trgu vsebuje naslednja polja:

Polja, uporabljena v dejanjih »Pridobi podatke«.
PoljeOpis
Razvrsti podatke poObvezno. Parametri, po katerih se razvrščajo podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatovObvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Hkrati lahko vrne do 100 rezultatov.
PoizvedbaObvezno. Izberite eno od pogostih poizvedb ali pa izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje vseh aktivnih trgov:

status:ACTIVE

Spremenljivka status je filter, ki je na voljo v poizvedbi za trge in se lahko uporabi večkrat ali v kombinaciji z drugimi spremenljivkami.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

  • Seznam razpoložljivih filtrov trga

  • Poizvedbe morajo upoštevati določeno sintakso

  • Vrednosti polj za poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti poiščete v dokumentaciji za API. Pogosto pa lahko vrednosti polj poiščete tudi v URL-naslovih v skrbniški plošči pri filtriranju. Če želite na primer poiskati nekatere vrednosti za poizvedbe za naročila, filtrirajte stran »Naročila« v skrbniški plošči in nato preverite URL-naslov.

  • Poizvedbo lahko v svoji trgovini zaženete ali preizkusite z aplikacijo Shopify GraphiQL.

  • Bodite pozorni na to, kaj se zgodi, če je poizvedba neuspešna. Pogosto bo API vrnil vse rezultate (namesto nobenega).

Vrnjeni podatki

Vsa dejanja Pridobi podatke vrnejo seznam z od 0 do 100 viri. Glede na vaš primer uporabe boste morda te podatke želeli uporabiti na različne načine:

  • Če morate posamezno obravnavati vsak element seznama, na primer za dodajanje oznake posameznemu elementu, lahko uporabite dejanje Za vsakega.
  • Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanji Štetje ali Vsota.
  • Če želite izvoziti seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v nadaljnjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke o trgu, ki je seznam trgov. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam trgov lahko na primer pošljete z dejanjem Pošlji interno e-pošto na naslednji način:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Sprožilci

To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovani čas. V poteku dela, ki uporablja sprožilec Načrtovani čas, se potek dela začne ob določenem času in ne kot posledica dogodka. Ker v vaši trgovini ali iz aplikacije ni nobenega določenega dogodka, ki bi zagnal potek dela, podatki niso samodejno vključeni.

Referenca za API

Za več informacij o API-ju, uporabljenem v tem dejanju, si oglejte poizvedbo za trge.