Odoslať požiadavku do rozhrania Admin API

Akcia Odoslať požiadavku do rozhrania Admin API môže použiť väčšinu mutácií v rozhraní GraphQL Admin API na vykonanie zmien vo vašom obchode, a to vrátane mutácií, ktoré zatiaľ nie sú v aplikácii Flow k dispozícii ako akcie.

Polia

Akcia Odoslať požiadavku na Admin API obsahuje nasledujúce polia.

Spúšťače

Akciu Odoslať požiadavku na Admin API je možné použiť v akomkoľvek pracovnom postupe a s akýmkoľvek spúšťačom, ak pracovný postup poskytuje údaje potrebné na vytvorenie vstupov mutácie.

Príklady

Príklad 1: Aktualizácia šablóny použitej pre produkt

V tomto príklade pomocou akcie Odoslať požiadavku na Admin API zavoláme mutáciu productUpdate na aktualizáciu šablóny použitej pre produkt.

Pole id je povinné a musí to byť platné GID produktu. Tu ho nastavujeme pomocou premennej Liquid {{product.id}}. Predpokladá sa, že váš pracovný postup obsahuje spúšťač, ktorý poskytuje objekt produktu.

templateSuffix je názov šablóny, ktorú chcete použiť pre produkt. Ak chcete použiť napríklad šablónu pre-order, vlastnosť templateSuffix nastavíte na pre-order.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

Príklad 2: Aktualizácia stavu oslobodenia od dane zákazníka

V tomto príklade pomocou akcie Odoslať požiadavku na Admin API zavoláme mutáciu customerUpdate na aktualizáciu stavu oslobodenia od dane zákazníka.

Pole id je povinné a musí to byť platné GID zákazníka. Tu ho nastavujeme pomocou premennej Liquid {{order.customer.id}}. Predpokladá sa, že váš pracovný postup obsahuje spúšťač, ktorý poskytuje objekt objednávky.

Pole taxExempt má logickú hodnotu (boolean), ktorá udáva, či je zákazník oslobodený od dane. V tomto príklade ho nastavíme na true.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

Príklad 3: Aktualizácia jazyka a regiónu zákazníka

V tomto príklade pomocou akcie Odoslať požiadavku na Admin API zavoláme mutáciu customerUpdate na aktualizáciu jazyka a regiónu zákazníka.

Pole id je povinné a musí to byť platné GID zákazníka. Tu ho nastavujeme pomocou premennej Liquid {{customer.id}}. Predpokladá sa, že váš pracovný postup obsahuje spúšťač, ktorý poskytuje objekt zákazníka.

Pole locale je reťazec, ktorý predstavuje jazyk a región zákazníka. V tomto príklade ho nastavíme na en.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Tipy k jazyku Liquid

Nástroj Flow podporuje filter json v jazyku Liquid, ktorý môže byť užitočný pri vytváraní vstupu. Vo všetkých nasledujúcich príkladoch sa používa mutácia customerUpdate a predpokladá sa, že váš pracovný postup obsahuje spúšťač poskytujúci objekt zákazníka.

Práca s reťazcami

V nasledujúcom príklade sa aktualizuje poznámka zákazníka:

{% assign revisedNote = customer.note | append: " Hello from Flow!" %}

{
  "input": {
    "id": "{{ customer.id }}",
    "note": {{ revisedNote | json }},
  }
}

Filter json ošetrí reťazec, aby sa zaistil správny formát JSON. Po spustení pracovného postupu bude výsledkom nasledujúci JSON:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "note": "Had a \"great experience\" with their latest order. Hello from Flow!",
  }
}

Práca s poľami

Príklad poľa

Filter json skonvertuje pole v jazyku Liquid na pole vo formáte JSON. Z nasledujúceho príkladu vzíde po poskytnutí poľa v jazyku Liquid pole vo formáte JSON:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ tags | json }}
  }
}

Po spustení pracovného postupu bude výsledkom nasledujúci formát JSON:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["tag1","tag2","tag3"]
  }
}

Príklad cyklu for

V nasledujúcom príklade sa pomocou cyklu vypisujú prvky poľa oddelené čiarkami:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": [
      {% for tag in tags %}
        "{{ tag }}"{% unless forloop.last %},{% endunless %}
      {% endfor %}
    ]
  }
}

Keď sa pracovný postup spustí, výsledkom bude nasledujúci formát JSON:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": [
        "tag1",
        "tag2",
        "tag3"
    ]
  }
}

Príklad mapovania

Pomocou filtra map je možné získať z poľa objektov pole konkrétnej vlastnosti. V nasledujúcom príklade sa z poľa adries zákazníkov extrahuje pole vlastností city:

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ customer.addresses | map: "city" | json }}
  }
}

Po spustení pracovného postupu bude výsledkom nasledujúci formát JSON:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["Ottawa","Toronto"]
  }
}

Obmedzenia

Akcia Odoslať požiadavku na Admin API má nasledujúce obmedzenia:

• Pri akcii sa zobrazí zoznam položiek Mutations a Mutation inputs z verzie Admin API, ktorú používa nástroj Flow.
• Pri vydaní nových verzií rozhrania API môže táto akcia zlyhať, ak využíva mutáciu alebo pole, ktoré sa zmenili alebo označili ako zastarané.
• Táto akcia nepodporuje dopyty GraphQL, iba mutácie.
• Akcia nepodporuje mutácie, ktoré sú označené ako zastarané.
• Akcia nepodporuje určité mutácie, ktoré sú špecifické pre konkrétne aplikácie, vrátane niektorých mutácií odberov, marketingových aktivít a zliav.
• Akcia nepodporuje asynchrónne mutácie ani mutácie, ktoré vracajú typ Job.
• Akcia nepodporuje mutácie, ktoré neimplementujú rozhranie Node.

Šablóny

Pridanie bezplatnej položky (so 100 % zľavou) k novým objednávkam

Táto šablóna pridá bezplatnú, zľavnenú položku k novým objednávkam, ak je položka na sklade. Skontroluje inventár, uplatní 100 % zľavu a aktualizuje objednávku bez upozornenia zákazníka. Táto automatizácia môže byť užitočná (1) na zvýšenie spokojnosti zákazníkov tým, že do objednávky zahrnie bezplatnú položku ako prekvapenie, (2) na propagáciu nových alebo menej známych produktov ich pridaním vo forme bezplatných vzoriek v objednávkach alebo (3) na zjednodušenie propagačných akcií automatizáciou pridávania a zľavňovania bezplatných položiek. Zobraziť šablónu

Povolenie objednávania pre spoločnosti vytvorené žiadosťami o účet spoločnosti

Pridelenie povolenia na objednávanie pri vytvorení spoločnosti na základe žiadosti o účet spoločnosti. Zobraziť šablónu

Zmena šablóny produktu, keď sú varianty vypredané alebo opäť na sklade

Aktualizujte šablónu produktu na základe inventára variantov produktu. Pracovný postup vám umožňuje prepínať medzi šablónami pre tovar na sklade (predvolená šablóna obchodu), vypredaný tovar a stav, keď je vypredaný jeden alebo viaceré varianty. Zobraziť šablónu

Vybavenie všetkých digitálnych položiek v objednávke

Vybaví všetky položky, ktoré si nevyžadujú fyzické doručenie, napríklad digitálne položky, alebo ktoré zodpovedajú zoznamu jednotiek SKU. Spustí sa raz pre každé miesto plnenia („objednávku na plnenie“) v prípade novej objednávky. Zobraziť šablónu