Hanki alennustiedot

Alennustietoja vaativissa työnkuluissa voit käyttää Hanki alennustiedot -toimintoa tietojen noutamiseen kaupastasi.

Määrittäminen

Kentät

Hanki alennustietoja ‑toiminto sisältää seuraavat kentät, joita käytetään kyselyn luomiseen:

Hae tietoja -toiminnoissa käytetyt kentät.
Kenttä Oikeuksien kuvaus
Tietojen lajitteluperuste Vaaditaan. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan.
Tulosten enimmäismäärä Tarvitaan. Hakukyselyn palauttamien tulosten suurin mahdollinen määrä. Voit palauttaa kerrallaan enintään 100.
Kysely Tarvitaan. Valitse yleisistä kyselyistä tai valitse Lisäasetukset luodaksesi oman.

Kyselyn merkkijono

Seuraavalla koodia käyttävällä esimerkkikyselyllä voit noutaa aktiiviset alennukset:

method:code AND status:active

Koodin method- ja status-muuttuja ovat Alennussolmukyselyssä olevia suodattimia, ja niitä voi käyttää useita kertoja tai yhdistää muihin muuttujiin.

Seuraavat asiat on hyvä tietää tietokyselyä luotaessa:

  • Luettelo käytettävissä olevista alennussuodattimista. - Kyselyjen on noudatettava tiettyä syntaksia
  • Kaikkien kyselyjen kenttien nimet löytyvät QueryRoot objects -kehittäjädokumentaatiosta.
  • Kyselykenttien arvoja ei ole aina dokumentoitu. Joissain tapauksissa arvot löytyvät API-dokumenteista. Vaihtoehtoisesti voit usein löytää kentän arvot Adminin URL-osoitteista, kun suodatat. Jos esimerkiksi haluat löytää tilauskyselyn arvoja, suodata Tilaukset-sivu ylläpitäjässä ja tarkista sitten URL-osoite.
  • Voit suorittaa tai testata kyselyä kaupassasi Shopify GraphiQL -sovelluksen avulla.
  • Ole tietoinen siitä, mitä tapahtuu, jos kysely epäonnistuu. Usein API palauttaa kaikki tulokset (sen sijaan, että se ei palauttaisi yhtään).

Palautetut tiedot

Kaikki Hae tietoja -toiminnot palauttavat luettelon, jonka koko on 0-100 resurssia. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoilla:

  • Jos sinun täytyy käsitellä kutakin luettelon kohtaa erikseen, kuten lisätä kullekin tunnisteen, voit käyttää For each-toimintoa.
  • Jos sinun täytyy yhdistellä tietoja, kuten laskea, kuinka monta tulosta palautettiin, voit käyttää Laske- tai Summa-toimintoja.
  • Jos sinun täytyy tulostaa luettelo, kuten lähettää kaikki kohdat sisältävä sähköpostiviesti, voit käyttää palautettuja tietoja suoraan tätä toimintoa seuraavissa toiminnoissa.

Jotta voit käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä Hanki alennustietoja ‑muuttujaa, joka on alennusten luettelo. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää sovellusten alennusten automaattisen luettelon Lähetä sisäinen sähköposti ‑toiminnossa näin:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
- {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Käynnistimet

Voit käyttää tätä toimintoa kaikissa työnkuluissa, myös Asetettu aika -käynnistimessä. Työnkulussa, jossa käytetään Asetettu aika -käynnistintä, työnkulku käynnistyy määrittämänäsi aikana eikä jonkin tapahtuman seurauksena. Koska työnkulkua ei käynnistä tietty kaupan tai sovelluksen tapahtuma, siihen ei automaattisesti sisälly tietoja.

Esimerkki

Esimerkki työnkulusta, joka toistuu kerran viikossa, etsii koodia käyttäviä aktiivisia alennuksia ja lähettää sähköpostiraportin.

Tässä esimerkissä työnkulku on ajastettu suoritettavaksi joka maanantai klo 9.00. Hae alennustiedot -toiminnolla voit kerätä tietoja koodia käyttäville aktiivisille alennuksille. Toiminto laskee alennusten lukumäärän. Jos toiminto palauttaa yhden tai useamman alennuksen, se lähettää tiedot sähköpostitse.

API-viite

Valmiina aloittamaan Shopifyssa?

Kokeile ilmaiseksi