Hanki lahjakorttien tiedot

Hae lahjakorttien tiedot ‑toiminnolla voit noutaa lahjakorttien tiedot kaupastasi lahjakorttien tietoja käyttäviin työnkulkuihin.

Tärkeää on, että kaupassasi on sekä lahjakorttituotteita, joita käytetään lahjakorttien luomiseen, että itse lahjakortteja, jotka ovat varsinaisia lahjakortteja, joilla asiakkaat voivat tehdä ostoksia. Hanki lahjakorttien tiedot ‑toiminto noutaa tietoja itse lahjakorteista. Saat tietoja lahjakorttituotteista käyttämällä Hae tuotetiedot- tai Hanki tuoteversiotiedot ‑toimintoa.

Tällä sivulla

Määrittäminen

Kentät

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

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

Kyselyn merkkijono

Tällä esimerkkikyselyllä saadaan 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 käytettävissä lahjakortin kyselyssä ja jota voidaan käyttää useita kertoja tai joka voidaan yhdistää muihin muuttujiin. Esimerkin Liquid-muuttuja scheduledAt on käytettävissä työnkuluissa, joissa on käytetty Asetettu aika ‑käynnistintä. Liquid-tunniste date_minus Flow-erikoistunniste, jolla voit vähentää aikaa päivämäärästä.

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

Lista käytettävistä lahjakorttisuodattimista
Kyselyjen on noudatettava tiettyä syntaksia
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 lahjakorttien tiedot ‑muuttujaa, joka on lahjakorttien luettelo. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää lahjakorttien luettelon Lähetä sisäinen sähköposti ‑toiminnossa näin:

{% for single_gift_card in GetGiftCardData %}
- {{ single_gift_card.name }}
{% 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.