Sūtīt Admin API pieprasījumu

Darbība Sūtīt Admin API pieprasījumu var izmantot lielāko daļu mutāciju GraphQL Admin API, lai veiktu izmaiņas tavā veikalā, tostarp mutācijas, kas vēl nav pieejamas kā darbības risinājumā Flow.

Šajā lapā

Lauki

Darbībā Sūtīt Admin API pieprasījumu ir ietverti tālāk norādītie lauki.

Lauki, kas izmantoti darbībā Sūtīt Admin API pieprasījumu.
Lauks	Apraksts
Mutācija	Obligāts lauks. Shopify GraphQL Admin mutācija, kuru vēlies izsaukt. Mutācija ir API, kas veic darbību vai atjaunina datus.
Mutācijas ievades dati	Obligāts lauks. Dati (JSON formātā), kas jānosūta kā daļa no mutācijas pieprasījuma. Katrai mutācijai ir nepieciešama atšķirīga datu kopa, kas ir dokumentēta katrai mutācijai norādītajā saitē. Lai izveidotu nepieciešamo JSON, vari izmantot Liquid vai koda izpildes darbību.

Trigeri

Darbību Nosūtīt Admin API pieprasījumu var izmantot jebkurā darbplūsmā ar jebkuru trigeri, ja vien darbplūsma nodrošina datus, kas nepieciešami mutācijas ievades datu izveidei.

Piemēri

1. piemērs: atjaunināt produktam izmantoto veidni

Šajā piemērā mēs izmantosim darbību Nosūtīt Admin API pieprasījumu, lai izsauktu mutāciju productUpdate un atjauninātu produktam izmantoto veidni.

Lauks id ir obligāts, un tam jābūt derīgam produkta GID. Šeit mēs to iestatām, izmantojot Liquid mainīgo {{product.id}}. Tiek pieņemts, ka tavā darbplūsmā ir trigeris, kas nodrošina produkta objektu.

Lauks templateSuffix ir tās veidnes nosaukums, kuru vēlies lietot produktam. Piemēram, ja vēlies lietot veidni pre-order, laukam templateSuffix iestati vērtību pre-order.

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

2. piemērs: atjaunināt klienta nodokļu atbrīvojuma statusu

Šajā piemērā mēs izmantosim darbību Nosūtīt Admin API pieprasījumu, lai izsauktu mutāciju customerUpdate un atjauninātu klienta nodokļu atbrīvojuma statusu.

Lauks id ir obligāts, un tam jābūt derīgam klienta GID. Šeit mēs to iestatām ar Liquid mainīgo {{order.customer.id}}. Tiek pieņemts, ka tavā darbplūsmā ir trigeris, kas nodrošina pasūtījuma objektu.

Lauks taxExempt ir būla vērtība, kas norāda, vai klientam ir nodokļu atbrīvojums. Šajā piemērā mēs tai iestatām vērtību true.

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

3. piemērs: atjaunināt klienta lokāli

Šajā piemērā mēs izmantosim darbību Nosūtīt Admin API pieprasījumu, lai izsauktu mutāciju customerUpdate un atjauninātu klienta lokāli.

Lauks id ir obligāts, un tam jābūt derīgam klienta GID. Šeit mēs to iestatām ar Liquid mainīgo {{customer.id}}. Tiek pieņemts, ka tavā darbplūsmā ir trigeris, kas nodrošina klienta objektu.

Lauks locale ir virkne, kas atspoguļo klienta lokāli. Šajā piemērā mēs tai iestatām vērtību en.

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

Liquid padomi

Flow atbalsta Liquid filtru json, kas var būt noderīgs ievades datu izveidē. Visos tālāk minētajos piemēros ir izmantota mutācija customerUpdate, un tiek pieņemts, ka tavā darbplūsmā ir trigeris, kas nodrošina klienta objektu.

Darbs ar virknēm

Tālāk minētajā piemērā tiek atjaunināta klienta piezīme:

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

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

Filtrs json atsoļo virkni, lai nodrošinātu pareizu JSON formātu. Pēc darbplūsmas izpildes tiek iegūts šāds JSON:

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

Darbs ar masīviem

Masīva piemērs

Filtrs json pārveido Liquid masīvu par JSON masīvu. Tālāk norādītais piemērs izvada JSON masīvu, kad tam tiek nodrošināts Liquid masīvs:

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

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

Pēc darbplūsmas izpildes tiek iegūts šāds JSON:

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

Cikla for piemērs

Tālāk minētajā piemērā tiek izmantots cikls, lai izvadītu masīva elementus, atdalītus ar komatiem:

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

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

Kad darbplūsma tiek izpildīta, tiek iegūts šāds JSON:

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

Filtra map piemērs

map filtru var izmantot, lai iegūtu noteikta rekvizīta masīvu no objektu masīva. Tālāk minētajā piemērā no klientu adrešu masīva tiek izvilkts city rekvizītu masīvs:

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

Pēc darbplūsmas izpildes tiek iegūts šāds JSON:

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

Ierobežojumi

Darbībai Nosūtīt Admin API pieprasījumu ir šādi ierobežojumi:

Darbība parādīs Mutations un Mutation inputs sarakstu no Flow izmantotās Admin API versijas.
Kad tiek izlaistas jaunas API versijas, šī darbība var neizdoties, ja tā izmanto mutāciju vai lauku, kas ir mainīts vai atzīmēts kā novecojis.
Darbība neatbalsta GraphQL vaicājumus, tikai mutācijas.
Darbība neatbalsta mutācijas, kas atzīmētas kā novecojušas.
Darbība neatbalsta dažas noteiktām lietotnēm specifiskas mutācijas, tostarp dažas abonēšanas, mārketinga aktivitāšu un atlaižu mutācijas.
Darbība neatbalsta asinhronas mutācijas vai mutācijas, kas atgriež tipu Job.
Darbība neatbalsta mutācijas, kas neīsteno Node saskarni.

Veidnes

Pievienot bezmaksas (ar 100% atlaidi) vienumu jauniem pasūtījumiem

Šī veidne jauniem pasūtījumiem pievieno bezmaksas vienumu ar atlaidi, ja šis vienums ir noliktavā. Tā pārbauda krājumus, piemēro 100% atlaidi un atjaunina pasūtījumu, neinformējot klientu. Šī automatizācija būtu noderīga, lai (1) uzlabotu klientu apmierinātību, pasūtījumam pievienojot bezmaksas pārsteiguma vienumu, (2) reklamētu jaunus vai mazāk zināmus produktus, pievienojot tos pasūtījumiem kā bezmaksas paraugus, vai (3) vienkāršotu akcijas, automatizējot bezmaksas vienumu pievienošanu un atlaižu piemērošanu tiem. Skatīt veidni

Atļaut pasūtīt uzņēmumiem, kas izveidoti no uzņēmuma konta pieprasījumiem

Piešķir pasūtīšanas atļauju, kad uzņēmums tiek izveidots no uzņēmuma konta pieprasījuma. Skatīt veidni

Mainīt produkta veidni, kad varianti vairs nav noliktavā vai atkal ir pieejami

Atjaunini produkta veidni, pamatojoties uz produkta variantu krājumiem. Darbplūsma ļauj pārslēgties starp veidnēm statusam "pieejams noliktavā" (veikala noklusējuma veidne), "nav noliktavā" un situācijām, kad noliktavā nav viena vai vairāku variantu. Skatīt veidni

Izpildīt jebkurus digitālos vienumus pasūtījumā

Izpilda visus vienumus, kuriem nav nepieciešama fiziska piegāde, piemēram, digitālos vienumus, vai kuri atbilst SKU sarakstam. Tiek izpildīta vienreiz katrai jaunā pasūtījuma izpildes vietai ("izpildes pasūtījumam"). Skatīt veidni