Admin API-kérelem küldése

Az Admin API-kérelem küldése művelet a GraphQL Admin API legtöbb mutációját képes használni az üzlet módosításához, beleértve azokat a mutációkat is, amelyek még nem érhetők el műveletként a Flow-ban.

Mezők

Az Admin API-kérelem küldése művelet a következő mezőket tartalmazza.

Kiváltók

Az Admin API-kérelem küldése művelet bármely munkafolyamatban, bármely kiváltóval használható, feltéve, hogy a munkafolyamat biztosítja a mutáció bemeneteinek létrehozásához szükséges adatokat.

Példák

1. példa: Egy termékhez használt sablon frissítése

Ebben a példában az Admin API-kérelem küldése műveletet használjuk a productUpdate mutáció meghívására, hogy frissítsük a termékhez használt sablont.

Az id mező kötelező, és érvényes termék GID-nek kell lennie. Itt a {{product.id}} Liquid-változóval állítjuk be. Ez feltételezi, hogy a munkafolyamatnak van egy olyan kiváltója, amely egy termékobjektumot biztosít.

A templateSuffix annak a sablonnak a neve, amelyet a termékre szeretne alkalmazni. Ha például a pre-order sablont szeretné alkalmazni, akkor a templateSuffix értékét pre-order-re kell állítania.

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

2. példa: Egy vásárló adómentességi állapotának frissítése

Ebben a példában az Admin API-kérelem küldése műveletet használjuk a customerUpdate mutáció meghívására, hogy frissítsük egy vásárló adómentességi állapotát.

Az id mező kötelező, és érvényes vásárlói GID-nek kell lennie. Itt a {{order.customer.id}} Liquid-változóval állítjuk be. Ez feltételezi, hogy a munkafolyamatnak van egy olyan kiváltója, amely egy rendelési objektumot biztosít.

A taxExempt mező egy logikai érték, amely azt jelzi, hogy a vásárló adómentes-e. Ebben a példában az értékét true-ra állítjuk.

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

3. példa: Egy vásárló területi beállításának frissítése

Ebben a példában az Admin API-kérelem küldése műveletet használjuk a customerUpdate mutáció meghívására, hogy frissítsük egy vásárló területi beállítását.

Az id mező kötelező, és érvényes vásárlói GID-nek kell lennie. Itt a {{customer.id}} Liquid-változóval állítjuk be. Ez feltételezi, hogy a munkafolyamatnak van egy olyan kiváltója, amely egy vásárlói objektumot biztosít.

A locale mező egy karakterlánc, amely a vásárló területi beállítását jelöli. Ebben a példában az értékét en-re állítjuk.

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

Liquid-tippek

A Flow támogat egy json liquid szűrőt, amely hasznos lehet a bemenet létrehozásában. A következő példák mind a customerUpdate mutációt használják, és feltételezik, hogy a munkafolyamatnak van egy olyan kiváltója, amely egy vásárlói objektumot biztosít.

Karakterláncokkal való munka

A következő példa frissíti a vásárlóhoz tartozó megjegyzést:

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

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

A json szűrő feloldójelekkel látja el a karakterláncot a megfelelő JSON-formátum biztosítása érdekében. Ennek eredménye a következő JSON a munkafolyamat lefutása után:

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

Tömbökkel való munka

Példa tömbre

A json szűrő egy liquid tömböt JSON tömbbé alakít. A következő példa egy liquid tömböt kapva JSON tömböt ad ki kimenetként:

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

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

Ennek eredménye a következő JSON a munkafolyamat lefutása után:

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

Példa for ciklusra

A következő példa egy ciklus segítségével adja ki egy tömb elemeit, vesszővel elválasztva:

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

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

Ennek eredménye a következő JSON a munkafolyamat lefutásakor:

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

Példa mapre

A map szűrővel egy adott tulajdonság tömbjét lehet lekérni egy objektumtömbből. A következő példában a vásárlói címek tömbjéből a city tulajdonságok tömbjét vonjuk ki:

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

Ennek eredménye a következő JSON a munkafolyamat lefutása után:

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

Korlátozások

Az Admin API-kérelem küldése műveletre a következő korlátozások vonatkoznak:

• A művelet a Flow által használt Admin API-verzióból származó Mutációk és Mutáció bemenetei listáját jeleníti meg.
• Amikor új API-verziók jelennek meg, ez a művelet sikertelen lehet, ha olyan mutációt vagy mezőt használ, amelyet megváltoztattak vagy elavulttá tettek.
• A művelet nem támogatja a GraphQL-lekérdezéseket, csak a mutációkat.
• A művelet nem támogatja az elavulttá tett mutációkat.
• A művelet nem támogat néhány, bizonyos alkalmazásokra jellemző mutációt, beleértve néhány előfizetési, marketingtevékenységi és kedvezménymutációt.
• A művelet nem támogatja az aszinkron mutációkat, illetve azokat a mutációkat, amelyek Job típust adnak vissza.
• A művelet nem támogatja azokat a mutációkat, amelyek nem valósítják meg a Node interfészt.

Sablonok

Ingyenes (100%-os kedvezménnyel ellátott) tétel hozzáadása új rendelésekhez

Ez a sablon egy ingyenes, kedvezményes tételt ad az új rendelésekhez, ha a tétel raktáron van. Ellenőrzi a készletet, 100%-os kedvezményt alkalmaz, és a vásárló értesítése nélkül frissíti a rendelést. Ez az automatizálás hasznos lehet (1) a vásárlói elégedettség növelésére azáltal, hogy egy meglepetés ingyenes tételt ad a rendelésükhöz, (2) új vagy kevésbé ismert termékek népszerűsítésére azáltal, hogy ingyenes mintaként adja hozzá őket a rendelésekhez, vagy (3) a promóciók egyszerűsítésére azáltal, hogy automatizálja az ingyenes tételek hozzáadását és kedvezményezését. Sablon megtekintése

Rendelés engedélyezése a céges fiókkérelmek által létrehozott cégek számára

Rendelési jogosultság hozzárendelése, amikor egy cég vállalati fiókkérelem alapján jön létre. Sablon megtekintése

Terméksablon módosítása, amikor a változatok nincsenek készleten vagy újra készleten vannak.

Frissíti a terméksablont a termék változatainak készlete alapján. A munkafolyamat lehetővé teszi a váltást a sablonok között, ha a termék készleten van (az üzlet alapértelmezett sablonja), nincs készleten, vagy ha egy vagy több változat nincs készleten. Sablon megtekintése

A rendelésben lévő digitális tételek teljesítése.

Teljesít minden olyan tételt, amely nem igényel fizikai kiszállítást, például a digitális tételeket, vagy amely megfelel egy cikkszám-listának. Egy új rendelés esetén minden teljesítési helyszínre (az úgynevezett „teljesítési rendelésre”) egyszer fut le. Sablon megtekintése