Nouda lahjakortin tiedot
Työnkuluissa, jotka edellyttävät lahjakorttitietoja, voit käyttää Nouda lahjakortin tiedot -toimintoa lahjakorttitietojen noutamiseen kaupastasi.
On tärkeää huomata, että kaupassasi on sekä lahjakorttituotteita, joilla luodaan lahjakortteja, että itse lahjakortteja, joita asiakkaat voivat käyttää ostosten tekemiseen. Nouda lahjakortin tiedot -toiminto noutaa tietoja itse lahjakorteista. Jos haluat saada tietoja lahjakorttituotteista, käytä Nouda tuotetiedot- tai Nouda tuoteversiotiedot -toimintoja.
Tällä sivulla
Määritys
Kentät
Nouda lahjakortin tiedot -toiminto sisältää seuraavat kentät, joita käytetään kyselyn muodostamiseen:
| Kenttä | Kuvaus |
|---|---|
| Järjestä tiedot | Pakollinen. Parametrit, joiden mukaan 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 Laajennettu. |
Kyselymerkkijono
Tämä on esimerkkikysely, jolla noudetaan viimeisen päivän aikana päivitetyt lahjakortit:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'Muuttuja created_at on suodatin, joka on saatavilla lahjakorttikyselyssä, ja sitä voidaan käyttää useita kertoja tai yhdistää muihin muuttujiin. scheduledAt-Liquid-muuttuja on käytettävissä työnkuluissa, jotka käyttävät Ajoitettu aika -käynnistintä. date_minus-Liquid-tunniste on erityinen Flow-tunniste, jonka avulla voit vähentää aikaa päivämäärästä.
Kun teet datakyselyitä, on hyödyllistä tietää seuraavat asiat:
Kyselyjen on noudatettava tiettyä syntaksia
Kyselykenttien arvoja ei ole aina dokumentoitu. Joissakin tapauksissa arvot löytyvät API-dokumentaatiosta. Vaihtoehtoisesti voit usein löytää kenttien arvot ohjausnäkymän URL-osoitteista, kun suodatat. Jos haluat esimerkiksi löytää tilauskyselyjen arvoja, suodata Tilaukset-sivu ohjausnäkymässä 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 (eikä yhtää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ätäksesi tunnisteen jokaiseen, voit käyttää Jokaiselle-toimintoa.
- Jos sinun tarvitsee koota tietoja, esimerkiksi laskea palautettujen tulosten määrä, voit käyttää Lukumäärä- tai Summa-toimintoja.
- Jos haluat käyttää koko luetteloa, esimerkiksi lähettääksesi sähköpostiviestin, joka sisältää kaikki tuotteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.
Voit käsitellä palautettuja tietoja tätä toimintoa seuraavissa vaiheissa käyttämällä muuttujaa nimeltä Hae lahjakortin tiedot, joka on luettelo lahjakorteista. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää lahjakorttiluettelon Lähetä sisäinen sähköposti -toiminnolla seuraavasti:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}Käynnistimet
Voit käyttää tätä toimintoa missä tahansa työnkulussa, myös Ajoitettu aika -käynnistimessä. Kun työnkulussa käytetään Ajoitettu aika -käynnistintä, se käynnistyy määrittämänäsi aikana eikä tietyn tapahtuman seurauksena. Koska mikään kauppasi tai sovelluksen tapahtuma ei käynnistä työnkulkua, siihen ei sisällytetä tietoja automaattisesti.