Bidali Admin API eskaera

Bidali Admin API eskaera ekintzak GraphQL Admin APIko mutazio gehienak erabil ditzake zure dendan aldaketak egiteko, Flow-n ekintza gisa oraindik erabilgarri ez dauden mutazioak barne.

Orri honetan

Eremuak

Bidali Admin API eskaera ekintzak eremu hauek ditu.

Bidali Admin API eskaera ekintzan erabilitako eremuak.
Eremua	Deskribapena
Mutazioa	Derrigorrezkoa. Deitu nahi duzun Shopify-ren GraphQL Admin mutazioa. Mutazio bat ekintzak egiten dituen edo datuak eguneratzen dituen API bat da.
Mutazioaren sarrerak	Derrigorrezkoa. Zure mutazio-eskaeraren zati gisa bidali behar dituzun datuak (JSON formatuan). Mutazio bakoitzak datu-multzo desberdin bat behar du, eta mutazio bakoitzerako emandako estekan daude dokumentatuta datu horiek. Beharrezko JSONa osatzeko, Liquid edo Kodea exekutatu ekintza bat erabil ditzakezu.

Abiarazleak

Bidali Admin API eskaera ekintza edozein lan-fluxutan eta edozein abiarazlerekin erabil daiteke, lan-fluxuak mutazioaren sarrerak osatzeko beharrezko datuak ematen baditu.

Adibideak

1. adibidea: eguneratu produktu baterako erabiltzen den txantiloia

Adibide honetan, Bidali Admin API eskaera ekintza erabiliko dugu productUpdate mutazioari deitzeko, produktu baterako erabiltzen den txantiloia eguneratzeko.

id eremua derrigorrezkoa da, eta baliozko produktu-GID bat izan behar du. Hemen, {{product.id}} Liquid aldagaiarekin ezarriko dugu. Horrek esan nahi du zure lan-fluxuak produktu-objektu bat ematen duen abiarazle bat duela.

templateSuffix produktuari aplikatu nahi diozun txantiloiaren izena da. Adibidez, pre-order txantiloia aplikatu nahi baduzu, templateSuffix eremuan pre-order ezarriko zenuke.

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

2. adibidea: eguneratu bezero baten zerga-salbuespenaren egoera

Adibide honetan, Bidali Admin API eskaera ekintza erabiliko dugu customerUpdate mutazioari deitzeko, bezero baten zerga-salbuespenaren egoera eguneratzeko.

id eremua derrigorrezkoa da, eta baliozko bezero-GID bat izan behar du. Hemen, {{order.customer.id}} Liquid aldagaiarekin ezarriko dugu. Horrek esan nahi du zure lan-fluxuak eskaera-objektu bat ematen duen abiarazle bat duela.

taxExempt eremua balio boolear bat da, eta bezeroak zerga-salbuespena duen ala ez adierazten du. Adibide honetan, true gisa ezarriko dugu.

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

3. adibidea: eguneratu bezero baten eskualdeko ezarpenak

Adibide honetan, Bidali Admin API eskaera ekintza erabiliko dugu customerUpdate mutazioari deitzeko, bezero baten eskualdeko ezarpenak eguneratzeko.

id eremua derrigorrezkoa da, eta baliozko bezero-GID bat izan behar du. Hemen, {{customer.id}} Liquid aldagaiarekin ezarriko dugu. Horrek esan nahi du zure lan-fluxuak bezero-objektu bat ematen duen abiarazle bat duela.

locale eremua bezeroaren eskualdeko ezarpenak adierazten dituen kate bat da. Adibide honetan, en gisa ezarriko dugu.

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

Liquid erabiltzeko aholkuak

Flow-k json Liquid iragazkia onartzen du, eta erabilgarria izan daiteke sarrera osatzeko. Ondorengo adibide guztiek customerUpdate mutazioa erabiltzen dute, eta zure lan-fluxuak bezero-objektu bat ematen duen abiarazle bat duela suposatzen dute.

Kateekin lan egitea

Hurrengo adibideak bezero baten oharra eguneratzen du:

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

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

json iragazkiak ihes-karaktereak gehitzen dizkio kateari JSON egokia dela ziurtatzeko. Horren ondorioz, JSON hau lortzen da lan-fluxua exekutatu ondoren:

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

Array-ekin lan egitea

Array baten adibidea

json iragazkiak Liquid array bat JSON array bihurtzen du. Hurrengo adibideak JSON array bat ematen du irteera gisa Liquid array bat ematen zaionean:

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

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

Horren ondorioz, JSON hau lortzen da lan-fluxua exekutatu ondoren:

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

For begiztaren adibidea

Hurrengo adibideak begizta bat erabiltzen du array bateko elementuak komaz bereizita itzultzeko:

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

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

Horren ondorioz, JSON hau lortzen da lan-fluxua exekutatzean:

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

Map adibidea

map iragazkia erabil daiteke objektu-array batetik propietate zehatz baten array bat lortzeko. Hurrengo adibidean, city propietateen array bat ateratzen da bezeroen helbideen array batetik:

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

Horren ondorioz, JSON hau lortzen da lan-fluxua exekutatu ondoren:

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

Mugak

Bidali Admin API eskaera ekintzak muga hauek ditu:

Ekintzak Flow-k erabiltzen duen Admin API bertsioaren Mutations eta Mutation inputs zerrenda bat bistaratuko du.
API bertsio berriak argitaratzen direnean, ekintza honek huts egin dezake aldatu edo zaharkituta geratu den mutazio edo eremu bat erabiltzen badu.
Ekintzak ez ditu GraphQL kontsultarik onartzen, mutazioak soilik.
Ekintzak ez ditu onartzen zaharkituta geratu diren mutazioak.
Ekintzak ez ditu onartzen aplikazio jakin batzuen mutazio zehatz batzuk, hala nola harpidetza, marketin-jarduera eta deskontu batzuen mutazioak.
Ekintzak ez ditu onartzen mutazio asinkronorik edo Job mota itzultzen duten mutazioak.
Ekintzak ez ditu onartzen Node interfazea inplementatzen ez duten mutazioak.

Txantiloiak

Gehitu doako produktu bat (% 100eko deskontua) eskaera berrietan

Txantiloi honek doako eta deskontudun produktu bat gehitzen die eskaera berriei, produktua inbentarioan badago. Inbentarioa egiaztatzen du, % 100eko deskontua aplikatzen du eta eskaera eguneratzen du bezeroari jakinarazi gabe. Automatizazio hau erabilgarria izan daiteke (1) bezeroaren gogobetetasuna hobetzeko, eskaeran ezusteko produktu bat doan sartuta; (2) produktu berriak edo ezezagunak sustatzeko, eskaeretan doako lagin gisa gehituta; edo (3) promozioak arintzeko, doako produktuen txertaketa eta deskontua automatizatuz. Ikusi txantiloia

Baimendu eskaerak egitea enpresaren kontu-eskaeren bidez sortutako enpresei

Esleitu eskaerak egiteko baimena enpresaren kontu-eskaera baten bidez enpresa bat sortzen denean. Ikusi txantiloia

Aldatu produktu-txantiloia aldaerak agortuta edo berriro erabilgarri daudenean

Eguneratu produktuaren txantiloia, produktuaren aldaeren inbentarioan oinarrituta. Lan-fluxuak aukera ematen dizu inbentarioan daudenerako (dendaren txantiloi lehenetsia), agortuta daudenerako eta aldaera bat edo gehiago agortuta daudenerako txantiloien artean txandakatzeko. Ikusi txantiloia

Osatu eskaera bateko produktu digitalak

Bidalketa fisikorik behar ez duten produktuak osatzen ditu, hala nola produktu digitalak edo SKU zerrenda batekin bat datozenak. Eskaera berri baten eskaeraren osatzearen kokapen bakoitzeko ('fulfillment order') behin exekutatzen da. Ikusi txantiloia