Pomocník
Prihlásiť sa

Získať údaje o darčekovej karte

V pracovných postupoch vyžadujúcich údaje o darčekových kartách môžete použiť akciu Získať údaje o darčekovej karte na načítanie informácií o darčekových kartách z vášho obchodu.

Dôležité je vedieť, že vo vašom obchode sú produkty darčekových kariet, ktoré slúžia na generovanie darčekových kariet, ako aj samotné darčekové karty, čo sú reálne darčekové karty, ktoré môžu zákazníci použiť na nákupy. Akcia Získať údaje o darčekovej karte načítava informácie o samotných darčekových kartách. Ak chcete získať informácie o produktoch darčekových kariet, použite akciu Získať údaje o produkte alebo Získať údaje o variante produktu.

Na tejto stránke

Konfigurácia

Polia

Akcia Získať údaje o darčekovej karte obsahuje nasledujúce polia, ktoré sa používajú na vytvorenie dopytu:

Polia použité v akciách Získať údaje.
PolePopis
Zoradiť údaje podľaPovinné. Parametre, podľa ktorých sa zoraďujú údaje vrátené vyhľadávacím dopytom.
Maximálny počet výsledkovPovinné. Maximálny počet výsledkov, ktoré môže vrátiť vybratý vyhľadávací dopyt. Naraz môžete vrátiť až 100 výsledkov.
DopytPovinné. Vyberte si z bežných dopytov alebo výberom možnosti Rozšírené vytvorte vlastný.

Reťazec dopytu

Toto je vzorový dopyt na získanie darčekových kariet, ktoré boli aktualizované za posledný deň:

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

Premenná created_at je filter dostupný v dopyte na darčekové karty a možno ho použiť viackrát alebo kombinovať s inými premennými. Premenná Liquid scheduledAt je dostupná v pracovných postupoch, ktoré použili spúšťač Plánovaný čas. Značka Liquid date_minus je špeciálna značka aplikácie Flow, ktorá umožňuje odčítať čas od dátumu.

Pri dopytovaní údajov je užitočné vedieť:

  • Zoznam dostupných filtrov darčekových kariet

  • Dopyty musia dodržiavať určitú syntax

  • Hodnoty polí dopytov nie sú vždy zdokumentované. V niektorých prípadoch možno hodnoty nájsť v dokumentácii API. Prípadne môžete hodnoty polí často nájsť v adresách URL v administrátorskom paneli, keď filtrujete. Ak chcete napríklad nájsť niektoré hodnoty dopytov pre objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.

  • Dopyt vo svojom obchode môžete spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.

  • Pamätajte na to, čo sa stane, ak váš dopyt zlyhá. Rozhranie API často vráti všetky výsledky (namiesto žiadnych).

Vrátené údaje

Všetky akcie Získať údaje vracajú zoznam s 0 až 100 zdrojmi. Podľa konkrétneho prípadu použitia môžete tieto údaje využiť rôznymi spôsobmi:

  • Ak potrebujete pracovať s každou položkou zoznamu samostatne, napríklad každej pridať štítok, môžete použiť akciu Pre každý.
  • Ak potrebujete údaje agregovať, napríklad zistiť počet vrátených výsledkov, môžete použiť akciu Počet alebo Súčet.
  • Ak potrebujete zoznam zobraziť na výstupe, napríklad odoslať e-mail so všetkými položkami, môžete vrátené údaje použiť priamo v nasledujúcich akciách.

Ak chcete získať prístup k vráteným údajom v krokoch nasledujúcich po tejto akcii, použite premennú s názvom Získať údaje o darčekovej karte, ktorá predstavuje zoznam darčekových kariet. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam darčekových kariet môžete napríklad odoslať v akcii Odoslať interný e-mail takto:

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

Spúšťače

Túto akciu môžete použiť v akomkoľvek pracovnom postupe vrátane spúšťača Naplánovaný čas. V pracovnom postupe, ktorý používa spúšťač Naplánovaný čas, sa pracovný postup spustí vo vami určenom čase, nie v dôsledku udalosti. Keďže neexistuje žiadna konkrétna udalosť vo vašom obchode alebo z aplikácie, ktorá by pracovný postup spustila, automaticky sa nezahrnú žiadne údaje.

Podrobnosti o API