Hae markkina-alueen tiedot

Työnkuluissa, jotka edellyttävät markkina-alueen tietoja, voit noutaa tiedot Shopify-kaupastasi Hae markkina-alueen tiedot -toiminnolla. Markkina-alueet ovat ryhmiä alueita tai sijainteja, joihin kohdistat myyntiä.

Tällä sivulla

Määritys

Kentät

Hae markkina-alueen tiedot -toiminto sisältää seuraavat kentät:

Hae tiedot -toiminnoissa käytettävät kentät.
Kenttä	Kuvaus
Tietojen lajitteluperuste	Pakollinen. Parametrit, joiden perusteella hakukyselyn palauttamat tiedot lajitellaan.
Tulosten enimmäismäärä	Pakollinen. Valitsemasi hakukyselyn palauttamien tulosten enimmäismäärä. Voit palauttaa enintään 100 tulosta kerrallaan.
Kysely	Pakollinen. Valitse yleisistä kyselyistä tai luo omasi valitsemalla Edistynyt.

Kyselyn merkkijono

Tämä on esimerkkikysely kaikkien aktiivisten markkina-alueiden hakemiseksi:

status:ACTIVE

Muuttuja status on suodatin, joka on käytettävissä Markets-kyselyssä. Sitä voidaan käyttää useita kertoja tai yhdistää muihin muuttujiin.

Tietoja haettaessa on hyvä tietää seuraavaa:

Luettelo käytettävissä olevista markkina-alueiden suodattimista
Kyselyjen on noudatettava tiettyä syntaksia
Kyselyn kenttien arvoja ei aina ole dokumentoitu. Joissakin tapauksissa arvot löytyvät API-dokumentaatiosta. Vaihtoehtoisesti voit usein löytää kenttien arvot ohjausnäkymän URL-osoitteista, kun käytät suodatusta. Jos haluat esimerkiksi löytää joitakin tilauskyselyn arvoja, suodata ohjausnäkymän Tilaukset-sivu ja tarkista sitten URL-osoite.
Voit suorittaa tai testata kyselyn kaupassasi käyttämällä Shopify GraphiQL -sovellusta.
Ota huomioon, mitä tapahtuu, jos kyselysi epäonnistuu. Usein API palauttaa kaikki tulokset (sen sijaan, ettei se palauttaisi mitään).

Palautetut tiedot

Kaikki Hae tiedot -toiminnot palauttavat luettelon, jossa on 0–100 resurssia. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoin:

Jos sinun on käsiteltävä jokaista luettelon kohdetta erikseen, esimerkiksi lisättävä tunniste jokaiselle, voit käyttää Jokaista kohden -toimintoa.
Jos sinun on koottava tietoja, kuten laskettava palautettujen tulosten määrä, voit käyttää Määrä- tai Summa-toimintoja.
Jos sinun on tulostettava luettelo, kuten lähetettävä sähköposti, joka sisältää kaikki kohteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.

Jos haluat käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä muuttujaa nimeltä Hae markkina-alueen tiedot, joka on markkina-alueiden luettelo. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää markkina-alueiden luettelon Lähetä sisäinen sähköposti -toiminnossa tähän tapaan:

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

Käynnistimet

Voit käyttää tätä toimintoa missä tahansa työnkulussa, myös Ajoitettu aika -käynnistimen yhteydessä. Työnkulussa, jossa käytetään Ajoitettu aika -käynnistintä, työnkulku alkaa määrittämänäsi ajankohtana eikä tapahtuman seurauksena. Koska työnkulkua ei käynnistä mikään tietty kaupassasi tai sovelluksessa tapahtuva tapahtuma, tietoja ei sisällytetä automaattisesti.

API-viite

Lisätietoja tässä toiminnossa käytetystä API-rajapinnasta on kohdassa Markets-kysely.