Nouda sijaintitiedot

Sijaintitietoja edellyttävissä työnkuluissa voit käyttää Nouda sijaintitiedot -toimintoa noutaaksesi sijaintitietoja Shopify-kaupastasi. Sijainnit ovat mitä tahansa paikkoja, joissa varastoit, myyt tuotteita tai lähetät tai täytät tilauksia.

Määritys

Kentät

Nouda sijaintitiedot -toiminto sisältää seuraavat kentät.

Nouda tiedot -toiminnoissa käytettävät kentät.
KenttäKuvaus
Tietojen lajitteluPakollinen. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan.
Tulosten enimmäismääräPakollinen. Niiden tulosten enimmäismäärä, jotka valitsemasi hakukysely voi palauttaa. Voit palauttaa enintään 100 kerrallaan.
KyselyPakollinen. Valitse yleisistä kyselyistä tai luo omasi valitsemalla Laajennettu.

Kyselymerkkijono

Tämä on esimerkkikysely sellaisten sijaintien noutamiseksi, joissa nouto myymälästä on käytössä:

pickup_in_store:enabled

pickup_in_store-muuttuja on suodatin, joka on saatavilla Sijainnit-kyselyssä. Sitä voi käyttää useita kertoja tai yhdistää muihin muuttujiin.

Kun teet tietokyselyjä, on hyödyllistä tietää seuraavat asiat:

  • Luettelo käytettävissä olevista sijaintisuodattimista

  • Kyselyiden on noudatettava tiettyä syntaksia

  • Kyselykenttien arvoja ei aina ole dokumentoitu. Joissakin tapauksissa arvot löytyvät API-dokumenteista. Vaihtoehtoisesti kenttien arvot löytyvät usein ohjausnäkymän URL-osoitteista, kun käytät suodatusta. Esimerkiksi joidenkin Tilaus-kyselyn arvojen löytämiseksi suodata Tilaukset-sivu ohjausnäkymässä ja tarkista sitten URL-osoite.

  • Voit suorittaa tai testata kyselyn kaupassasi käyttämällä Shopify GraphiQL -sovellusta.

  • Huomioi, mitä tapahtuu, jos kyselysi epäonnistuu. API palauttaa usein kaikki tulokset (eikä yhtään).

Palautetut tiedot

Kaikki Nouda 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ä jokainen luettelon kohde erikseen, esimerkiksi lisätäksesi tunnisteen jokaiselle, voit käyttää Jokaiselle-toimintoa.
  • Jos sinun on koostettava tietoja, kuten laskettava palautettujen tulosten määrä, voit käyttää Laske- tai Summa-toimintoja.
  • Jos haluat tulostaa luettelon, esimerkiksi lähettää sähköpostiviestin, jossa on kaikki tuotteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.

Jos haluat käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä muuttujaa nimeltä Nouda sijaintitiedot, joka on luettelo sijainneista. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää sijaintiluettelon Lähetä sisäinen sähköposti -toiminnossa näin:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Käynnistimet

Voit käyttää tätä toimintoa missä tahansa työnkulussa, mukaan lukien Ajastettu aika -käynnistimessä. Työnkulussa, jossa käytetään Ajastettu aika -käynnistintä, työnkulku alkaa määrittämänäsi aikana tapahtuman seurauksen sijaan. Koska kaupassasi tai sovelluksessa ei ole työnkulkua käynnistävää tapahtumaa, tietoja ei sisällytetä automaattisesti.

API-viite

Lisätietoja tässä toiminnossa käytetystä APIsta on Sijainnit-kyselyssä.