Hjelp
Logg på

Hent markedsdata

I arbeidsflyter som krever markedsdata, kan du bruke handlingen Hent markedsdata for å hente markedsinformasjon fra Shopify-butikken. Markeder er grupper av områder eller steder som du målretter mot for salg.

På denne siden

Konfigurasjon

Felt

Handlingen Hent markedsdata inneholder følgende felt:

Felt som brukes i Hent data-handlingene.
FeltBeskrivelse
Sorter data etterObligatorisk. Parameterne som dataene som returneres av søket, blir sortert etter.
Maksimalt antall resultaterObligatorisk. Det maksimale antallet resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
SpørringObligatorisk. Velg blant vanlige spørringer, eller velg Avansert for å opprette din egen.

Spørringsstreng

Dette er et eksempel på en spørring for å hente alle aktive markeder:

status:ACTIVE

Variabelen status er et filter som er tilgjengelig i Markets-spørringen, og kan brukes flere ganger eller kombineres med andre variabler.

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

  • Liste over tilgjengelige markedsfiltre

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

  • Feltverdier for spørringer er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne for eksempel noen verdier for bestillingsspørringer, kan du 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. API-et returnerer ofte alle resultater (i stedet for ingen).

Returnerte data

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

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

For å få tilgang til de returnerte dataene i trinnene som følger denne handlingen, bruker du variabelen som heter Hent markedsdata, som er en liste over markeder. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over markeder i en Send intern e-post-handling, omtrent slik:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Utløsere

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

API-referanse

For mer informasjon om API-et som brukes i denne handlingen, kan du se Markets-spørringen.