Pošlji zahtevo za Admin API

Dejanje Pošlji zahtevo za Admin API lahko za spreminjanje v vaši trgovini uporabi večino mutacij v vmesniku GraphQL Admin API, vključno z mutacijami, ki v aplikaciji Flow še niso na voljo kot dejanja.

Polja

Dejanje Pošlji zahtevo za Admin API vsebuje naslednja polja.

Polja, uporabljena v dejanju Pošlji zahtevo za Admin API.

Polje	Opis
Mutacija	Obvezno. Mutacija za Shopify GraphQL Admin, ki jo želite klicati. Mutacija je API, ki izvede dejanje ali posodobi podatke.
Vnosi mutacije	Obvezno. Podatki (v formatu JSON), ki jih morate poslati kot del zahteve za mutacijo. Vsaka mutacija zahteva različen nabor podatkov, ki so dokumentirani na povezavi, navedeni za posamezno mutacijo. Za ustvarjanje potrebnega JSON-a lahko uporabite Liquid ali dejanje Zaženi kodo.

Sprožilci

Dejanje Pošlji zahtevo za Admin API lahko uporabite v katerem koli poteku dela, s katerim koli sprožilcem, če potek dela zagotavlja podatke, ki so potrebni za ustvarjanje vnosov mutacije.

Primeri

1. primer: Posodobitev predloge, uporabljene za izdelek

V tem primeru bomo uporabili dejanje Pošlji zahtevo za Admin API za klic mutacije productUpdate za posodobitev predloge, uporabljene za izdelek.

Polje id je obvezno in mora biti veljaven GID izdelka. Tukaj ga nastavimo s spremenljivko Liquid {{product.id}}. To predpostavlja, da ima vaš potek dela sprožilec, ki zagotavlja predmet izdelka.

templateSuffix je ime predloge, ki jo želite uporabiti za izdelek. Če želite na primer uporabiti predlogo pre-order, boste vrednost templateSuffix nastavili na pre-order.

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

2. primer: Posodobitev stanja oprostitve davka za stranko

V tem primeru bomo uporabili dejanje Pošlji zahtevo za Admin API za klic mutacije customerUpdate za posodobitev stanja oprostitve davka za stranko.

Polje id je obvezno in mora biti veljaven GID stranke. Tukaj ga nastavimo s spremenljivko Liquid {{order.customer.id}}. To predpostavlja, da ima vaš potek dela sprožilec, ki zagotavlja predmet naročila.

Polje taxExempt je logična vrednost, ki označuje, ali je stranka oproščena plačila davka. V tem primeru ga nastavimo na true.

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

3. primer: Posodobitev območnih nastavitev stranke

V tem primeru bomo uporabili dejanje Pošlji zahtevo za Admin API za klic mutacije customerUpdate za posodobitev območnih nastavitev stranke.

Polje id je obvezno in mora biti veljaven GID stranke. Tukaj ga nastavimo s spremenljivko Liquid {{customer.id}}. To predpostavlja, da ima vaš potek dela sprožilec, ki zagotavlja predmet stranke.

Polje locale je niz, ki predstavlja območne nastavitve stranke. V tem primeru ga nastavimo na en.

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

Nasveti za Liquid

Aplikacija Flow podpira filter Liquid json, ki je lahko uporaben pri ustvarjanju vnosa. Vsi naslednji primeri uporabljajo mutacijo customerUpdate in predpostavljajo, da ima vaš potek dela sprožilec, ki zagotavlja predmet stranke.

Delo z nizi

Naslednji primer posodobi opombo pri stranki:

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

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

Filter json doda ubežne znake nizu, da zagotovi ustrezen zapis JSON. Ko se potek dela zažene, se ustvari naslednji zapis JSON:

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

Delo s seznami

Primer seznama

Filter json pretvori seznam Liquid v seznam JSON. Naslednji primer vrne seznam JSON, ko prejme seznam Liquid:

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

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

Ko se potek dela zažene, se ustvari naslednji zapis JSON:

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

Primer zanke For

Naslednji primer uporablja zanko za izpis elementov seznama, ločenih z vejicami:

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

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

Ko se potek dela zažene, se ustvari naslednji zapis JSON:

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

Primer filtra map

S filtrom map lahko pridobite seznam določene lastnosti iz seznama predmetov. V naslednjem primeru se iz seznama naslovov strank izloči seznam lastnosti city:

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

Ko se potek dela zažene, se ustvari naslednji zapis JSON:

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

Omejitve

Za dejanje Pošlji zahtevo za Admin API veljajo naslednje omejitve:

• Dejanje bo prikazalo seznam mutacij (Mutations) in vnosov mutacije (Mutation inputs) iz različice vmesnika Admin API, ki jo uporablja aplikacija Flow.
• Ko so objavljene nove različice API-ja, dejanje morda ne bo uspelo, če uporablja mutacijo ali polje, ki je bilo spremenjeno ali opuščeno.
• Dejanje ne podpira poizvedb GraphQL, temveč samo mutacije.
• Dejanje ne podpira mutacij, ki so bile opuščene.
• Dejanje ne podpira nekaterih mutacij, ki so specifične za določene aplikacije, vključno z nekaterimi mutacijami za naročnine, trženjske dejavnosti in popuste.
• Dejanje ne podpira asinhronih mutacij ali mutacij, ki vrnejo vrsto Job.
• Dejanje ne podpira mutacij, ki ne izvajajo vmesnika Node.

Predloge

Dodajanje brezplačnega kosa (100-% popust) k novim naročilom

Ta predloga novim naročilom doda brezplačen znižan kos, če je ta na zalogi. Preveri inventar, uveljavi 100-% popust in posodobi naročilo brez obvestila stranki. Ta avtomatizacija je uporabna za (1) izboljšanje zadovoljstva strank z vključitvijo brezplačnega kosa presenečenja v njihovo naročilo, (2) promocijo novih ali manj znanih izdelkov z dodajanjem kot brezplačnih vzorcev v naročila ali (3) poenostavitev promocij z avtomatizacijo vključevanja in znižanja brezplačnih kosov. Ogled predloge

Omogoči naročanje podjetjem, ustvarjenim prek zahtev za račun podjetja

Dodelite dovoljenje za naročanje, ko je podjetje ustvarjeno z zahtevo za račun podjetja. Ogled predloge

Sprememba predloge izdelka, ko različice niso na zalogi ali so spet na zalogi

Posodobite predlogo izdelka glede na inventar za različice izdelka. Potek dela omogoča preklapljanje med predlogami za stanje na zalogi (privzeta predloga trgovine), stanje, ko izdelkov ni na zalogi, in stanje, ko ene ali več različic ni na zalogi. Ogled predloge

Izpolnitev vseh digitalnih kosov v naročilu

Izpolni vse kose, ki ne zahtevajo fizične dostave, kot so digitalni kosi, ali ki se ujemajo s seznamom SKU-jev. Zažene se enkrat za vsako lokacijo izpolnitve (»naročilo za izpolnitev«) za novo naročilo. Ogled predloge