Saada Admin API päring

Tegevus Saada Admin API päring saab kasutada enamikku GraphQL Admin API mutatsioone sinu poes muudatuste tegemiseks, sealhulgas mutatsioone, mis pole Flow's tegevustena veel saadaval.

Väljad

Tegevus Saada Admin API päring sisaldab järgmisi välju.

Väljad, mida kasutatakse tegevuses Saada Admin API päring.

Väli	Kirjeldus
Mutatsioon	Nõutav. Shopify GraphQL Admini mutatsioon, mida soovid välja kutsuda. Mutatsioon on API, mis teeb toimingu või uuendab andmeid.
Mutatsiooni sisendid	Nõutav. Andmed (JSON-vormingus), mis tuleb saata mutatsioonipäringu osana. Iga mutatsioon nõuab erinevaid andmeid, mis on dokumenteeritud iga mutatsiooni juurde kuuluval lingil. Vajaliku JSON-i koostamiseks võid kasutada Liquidit või koodi käivitamise toimingut.

Käivitajad

Toimingut Saada Admin API päring saab kasutada igas töövoos koos mis tahes käivitajaga, eeldusel, et töövoog pakub mutatsiooni sisendite koostamiseks vajalikke andmeid.

Näited

1. näide: toote jaoks kasutatava malli uuendamine

Selles näites kasutame toimingut Saada Admin API päring, et kutsuda välja mutatsioon productUpdate, mis uuendab toote jaoks kasutatavat malli.

Väli id on nõutav ja see peab olema kehtiv toote GID. Siin määrame selle Liquidi muutujaga {{product.id}}. See eeldab, et sinu töövoos on käivitaja, mis pakub tooteobjekti.

templateSuffix on tootele rakendatava malli nimi. Näiteks kui soovid rakendada malli pre-order, pead määrama väljale templateSuffix väärtuse pre-order.

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

2. näide: kliendi maksuvabastuse oleku uuendamine

Selles näites kasutame toimingut Saada Admin API päring, et kutsuda välja mutatsioon customerUpdate, mis uuendab kliendi maksuvabastuse olekut.

Väli id on nõutav ja see peab olema kehtiv kliendi GID. Siin määrame selle Liquidi muutujaga {{order.customer.id}}. See eeldab, et sinu töövoos on käivitaja, mis pakub tellimuseobjekti.

Väli taxExempt on tõeväärtus, mis näitab, kas kliendile kehtib maksuvabastus. Selles näites määrame selleks true.

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

3. näide: kliendi lokaadi uuendamine

Selles näites kasutame toimingut Saada Admin API päring, et kutsuda välja mutatsioon customerUpdate, mis uuendab kliendi lokaati.

Väli id on nõutav ja see peab olema kehtiv kliendi GID. Siin määrame selle Liquidi muutujaga {{customer.id}}. See eeldab, et sinu töövoos on käivitaja, mis pakub kliendiobjekti.

Väli locale on sõne, mis tähistab kliendi lokaati. Selles näites määrame selleks en.

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

Liquidi näpunäited

Flow toetab Liquidi filtrit json, millest on abi sisendi koostamisel. Järgmised näited kasutavad mutatsiooni customerUpdate ja eeldavad, et sinu töövoos on käivitaja, mis pakub kliendiobjekti.

Töötamine sõnedega

Järgmine näide uuendab kliendi märkust:

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

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

Filter json varjestab sõne, et tagada korrektne JSON. See annab töövoo käivitamise järel järgmise JSON-i:

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

Töötamine massiividega

Massiivi näide

Filter json teisendab Liquidi massiivi JSON-i massiiviks. Järgmine näide väljastab JSON-i massiivi, kui sellele antakse Liquidi massiiv:

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

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

Selle tulemusena on töövoo käivitamise järel JSON järgmine:

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

Tsükli for näide

Järgmine näide kasutab tsüklit massiivi elementide komadega eraldatult väljastamiseks:

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

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

Selle tulemusena on töövoo käivitamise järel JSON järgmine:

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

Map-filtri näide

Filtrit map saab kasutada selleks, et saada objektide massiivist konkreetse atribuudi massiiv. Järgmises näites eraldatakse kliendi aadresside massiivist atribuutide city massiiv:

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

Selle tulemusena on töövoo käivitamise järel JSON järgmine:

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

Piirangud

Toimingul Saada Admin API päring on järgmised piirangud:

• Toiming kuvab Flow's kasutatavast Admin API versioonist loendid Mutations ja Mutation inputs.
• Kui välja antakse uued API versioonid, võib see toiming nurjuda, kui see kasutab mutatsiooni või välja, mida on muudetud või mis on iganenud.
• Toiming ei toeta GraphQL-i päringuid, ainult mutatsioone.
• Toiming ei toeta iganenud mutatsioone.
• Toiming ei toeta osasid teatud rakendustele spetsiifilisi mutatsioone, sealhulgas mõningaid tellimuste, turundustegevuste ja allahindluste mutatsioone.
• Toiming ei toeta asünkroonseid mutatsioone ega mutatsioone, mis tagastavad tüübi Job.
• Toiming ei toeta mutatsioone, mis ei rakenda liidest Node.

Mallid

Lisa uutele tellimustele tasuta (100% allahindlusega) üksus

See mall lisab uutele tellimustele tasuta, allahinnatud üksuse, kui see üksus on laos. See kontrollib laoseisu, rakendab 100% allahindluse ja uuendab tellimust ilma klienti teavitamata. See automatiseerimine on kasulik, et (1) suurendada kliendirahulolu, lisades nende tellimusele üllatusena tasuta üksuse, (2) edendada uusi või vähem tuntud tooteid, lisades need tellimustesse tasuta proovidena, või (3) lihtsustada kampaaniate haldamist, automatiseerides tasuta üksuste lisamist ja allahindamist. Vaata malli

Luba tellimine ettevõtetele, mis on loodud ettevõttekonto taotluste kaudu

Määra tellimisõigus, kui ettevõte luuakse ettevõttekonto taotluse kaudu. Vaata malli

Muuda toote malli, kui variandid on laost otsas või uuesti laos

Uuenda toote malli, võttes aluseks toote variantide laoseisu. Töövoog võimaldab vahetada malle olukordade jaoks, kus toode on laos (poe vaikemall), laost otsas ning kui üks või mitu varianti on laost otsas. Vaata malli

Täida tellimuses olevad digitaalsed üksused

Täidab kõik üksused, mis ei nõua füüsilist tarnet, näiteks digitaalsed üksused või üksused, mis vastavad SKU-de loendile. Käivitub ühe korra uue tellimuse iga täitmise asukoha („täitmistellimus“) kohta. Vaata malli