Hent markedsdata

I workflows, der kræver markedsdata, kan du bruge handlingen Hent markedsdata til at hente markedsoplysninger fra din Shopify-butik. Markeder er grupper af områder eller lokationer, som du målretter dit salg mod.

På denne side

Konfiguration

Felter

Handlingen Hent markedsdata indeholder følgende felter:

Felter, der bruges i Hent data-handlingerne.
Felt	Beskrivelse
Sortér data efter	Påkrævet. De parametre, som data, der returneres af søgeforespørgslen, sorteres efter.
Maksimalt antal resultater	Påkrævet. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan få returneret op til 100 ad gangen.
Forespørgsel	Påkrævet. Vælg blandt almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på en forespørgsel, der henter alle aktive markeder:

status:ACTIVE

Variablen status er et filter, der er tilgængeligt i forespørgslen Markets, og den kan bruges flere gange eller kombineres med andre variabler.

Når du forespørger om data, er det nyttigt at vide følgende:

Liste over tilgængelige markedsfiltre
Forespørgsler skal følge en bestemt syntaks
Værdierne i forespørgselsfelterne er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i din administrator, når du filtrerer. For eksempel kan du finde forespørgselsværdier for ordrer ved at filtrere siden Ordrer i din administrator og derefter tjekke webadressen.
Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.
Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. Ofte returnerer API'et alle resultater (i stedet for ingen).

Returnerede data

Alle Hent data-handlinger returnerer en liste på mellem 0 og 100 ressourcer. Afhængigt af dit brugsscenarie kan du bruge disse data på forskellige måder:

Hvis du har brug for at håndtere hvert element på listen individuelt, f.eks. ved at tilføje et tag til hver enkelt, kan du bruge handlingen For hver.
Hvis du har brug for at samle data, f.eks. for at tælle, hvor mange resultater der blev returneret, kan du bruge handlingen Tæl eller Sum.
Hvis listen skal genereres som output, f.eks. for at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

For at få adgang til de returnerede data i de trin, der følger efter denne handling, skal du bruge variablen Hent markedsdata, som er en liste over markeder. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over markeder i handlingen Send intern mail på en måde, der ligner denne:

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

Udløsere

Du kan bruge denne handling i alle workflows, herunder med udløseren Planlagt tidspunkt. I et workflow, der bruger udløseren Planlagt tidspunkt, starter workflowet på et tidspunkt, du har angivet, frem for som et resultat af en hændelse. Da der ikke er en specifik hændelse i din butik eller fra en app, der starter workflowet, inkluderes der ikke automatisk data.

API-reference

Du kan finde flere oplysninger om det API, der bruges i denne handling, under forespørgslen Markets.