Marktgegevens ophalen

In workflows waarvoor marktgegevens nodig zijn, kun je de actie Marktgegevens ophalen gebruiken om marktinformatie uit je Shopify-winkel op te halen. Markten zijn groepen met regio's of locaties waarop je je richt voor de verkoop.

Configuratie

Velden

De actie Marktgegevens ophalen bevat de volgende velden:

Query-tekenreeks

Dit is een voorbeeld van een query om alle actieve markten op te halen:

status:ACTIVE

De variabele status is een filter dat beschikbaar is voor de Markets-query en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Bij het opvragen van gegevens is het handig om het volgende te weten:

• Lijst met beschikbare marktfilters

• Query's moeten een bepaalde syntaxis volgen

• Waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen zijn de waarden te vinden in de API-documentatie. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheer wanneer je filtert. Om bijvoorbeeld bepaalde querywaarden voor bestellingen te vinden, filter je de pagina Bestellingen in het beheer en controleer je vervolgens de URL.

• Je kunt een query uitvoeren of testen in je winkel met behulp van de Shopify GraphiQL-app.

• Houd er rekening mee wat er gebeurt als je query mislukt. Vaak retourneert de API dan alle resultaten (in plaats van geen enkele).

Geretourneerde gegevens

Alle Gegevens ophalen-acties retourneren een lijst van 0 tot 100 bronnen. Afhankelijk van de use case kun je deze gegevens op verschillende manieren gebruiken:

• Als je elk item in de lijst afzonderlijk wilt verwerken, bijvoorbeeld om aan elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
• Als je gegevens wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Som gebruiken.
• Als je de lijst als uitvoer nodig hebt, bijvoorbeeld om een e-mail met alle items te verzenden, kun je de geretourneerde gegevens rechtstreeks in daaropvolgende acties gebruiken.

Als je toegang wilt tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele Marktgegevens ophalen, die een lijst met markten bevat. Je kunt deze variabele in zowel voorwaarden als acties gebruiken. Je kunt de lijst met markten bijvoorbeeld als volgt verzenden met de actie Interne e-mail verzenden:

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

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief bij de trigger Geplande tijd. In een workflow die de trigger Geplande tijd gebruikt, start de workflow op een door jou opgegeven tijdstip in plaats van als gevolg van een gebeurtenis. Omdat er geen specifieke gebeurtenis is in je winkel of van een app die de workflow start, worden er niet automatisch gegevens bijgevoegd.

API-referentie

Zie de Markets-query voor meer informatie over de API die in deze actie wordt gebruikt.