Hjelp
Logg på

Hent data om gavekort

I arbeidsflyter som krever data om gavekort, kan du bruke handlingen Hent data om gavekort for å hente gavekortinformasjon fra butikken.

Det er viktig å merke seg at butikken har både gavekortprodukter, som brukes til å generere gavekort, og selve gavekortene, som er de faktiske gavekortene kundene kan bruke til å foreta kjøp. Handlingen Hent data om gavekort henter informasjon om selve gavekortene. For å hente informasjon om gavekortprodukter, kan du bruke handlingene Hent produktdata eller Hent produktvariantdata.

På denne siden

Konfigurasjon

Felt

Handlingen Hent data om gavekort inneholder følgende felt, som brukes til å bygge spørringen:

Felt som brukes i Hent data-handlingene.
FeltBeskrivelse
Sorter data etterPåkrevd. Parametrene dataene fra søket sorteres etter.
Maksimalt antall resultaterPåkrevd. Det maksimale antallet resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
SpørringPåkrevd. Velg blant vanlige spørringer, eller velg Avansert for å opprette din egen.

Spørringsstreng

Dette er et eksempel på en spørring for å hente gavekort som ble oppdatert i løpet av den siste dagen:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variabelen created_at er et filter som er tilgjengelig i gavekortspørringen, og kan brukes flere ganger eller kombineres med andre variabler. Liquid-variabelen scheduledAt er tilgjengelig i arbeidsflyter som bruker utløseren Planlagt tidspunkt. Liquid-taggen date_minus er en spesiell Flow-tagg som lar deg trekke tid fra en dato.

Når du spør etter data, er det nyttig å vite:

  • Liste over tilgjengelige gavekortfiltre

  • Spørringer må følge en bestemt syntaks

  • Feltverdier for spørringer er ikke alltid dokumentert. I noen tilfeller kan verdiene finnes ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen spørringsverdier for bestillinger kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.

  • Du kan kjøre eller teste en spørring i butikken ved å bruke Shopify GraphiQL-appen.

  • Vær oppmerksom på hva som skjer hvis spørringen mislykkes. Ofte vil API-et returnere alle resultater (i stedet for ingen).

Returnerte data

Alle Hent data-handlinger returnerer en liste med alt fra 0 til 100 ressurser. Avhengig av bruksområdet kan det hende du vil bruke disse dataene på ulike måter:

  • Hvis du trenger å håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hvert av dem, kan du bruke For hver-handlingen.
  • Hvis du trenger å aggregere data, for eksempel for å telle hvor mange resultater som ble returnert, kan du bruke Tell- eller Summer-handlingene.
  • Hvis du trenger å sende listen som utdata, for eksempel sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i etterfølgende handlinger.

For å få tilgang til de returnerte dataene i trinn som følger etter denne handlingen, bruker du variabelen kalt Hent data om gavekort, som er en liste over gavekort. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over gavekort i en Send intern e-post-handling slik som dette:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Utløsere

Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert Planlagt tidspunkt-utløseren. I en arbeidsflyt som bruker Planlagt tidspunkt-utløseren, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Siden det ikke er noen spesifikk hendelse i butikken eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.

API-detaljer