Shopifyn komentosarja-API -viite

Tämä sivu on tulostettu 2023年6月11日。尼基宁语版osoitteessa https://help.shopify.com/fi/manual/checkout-settings/script-editor/shopify-scripts。

Komentosarjat on kirjoitettu Ruby-API -kielellä， mikä lisää hallittavuutta ja joustavuutta huomattavasti。

Komentosarjatyyppejä上的erilaisia。Kun luot komentosarjan脚本编辑器-sovelluksessa, komentosarjalle määritetään typppi sen perusteella, minkä komentosarjamallin valitset:

Rivikohdan komentosarjat

Rivikohdan komentosarjat vaikuttavat ostoskorissa oliviin rivihin ja voivat muuttaa hintoja sekä myöntää alennuksia。Nämä komentosarjat suoritetaan, kun koriin tehdään muutos。

Rivikohdan komentosarjoja, jotka alentavat tilauksen hintaa, sovelletaan vain tilauksen ensimmäiseen maksuun。Komentosarja ei alena myöhempiä maksuja。

Joitakin menetelmiaVoidaan käyttää徒劳的rivikohdan komentosarjoissa．

Toimituskomentosarjat

Toimituskomentosarjat ovorovaikutuksessatoimituksenKanssa, ja ne voivat muutaa to imitusstapoja sekä myöntää alennuksia toimitushinnoista。Nämä komentosarjat suoritetaan, kun kassalla päädytään toimitusvaihtoehtojen sivulle。

Toimituskomentosarjoja, jotka alentavat tilauksen toimitusmaksua, sovelletaan and vain tilauksen ensimmäiseen maksuun。Komentosarja ei alena myöhempiä maksuja。

Joitakin menetelmiaVoidaan käyttää徒劳的toimituskomentosarjoissa．

Maksukomentosarjat

Maksukomentosarjat toimivat yhdessämaksujen堪萨斯州，ja niillä voidaan nimetä uudelleen maksuportaaleja, piilotaa niitä ja järjestää niitä uudelleen。Huomaa, että maksukomentosarjat eivät toimi vuorovaikutuksessa enenkassan näyttöä näytettävien maksupportaalien kuten Apple payn kansan。Nämä komomtosarjat suoritetaan, kun kassalla päädytään maksusivulle。

Joitakin menetelmia虚空虚空käyttää虚空maksukomentosarjoissa．

要这种sivulla

Yleiset menetelmat

Seuraavat menetelmät ovat käytettävissä missä tahansa komentosarjassa:

Syottaa

Komentosarjan syotetavat
树皮布 Palautustyyppi Kuvaus
.cart Ostoskori Palauttaa muutettavan ostoskorin kohten。
.locale merkkijono 帕劳塔亚·阿卡坎·西加宁。Esimerkiksi在fr大pt-BR．

Ostoskori

Ostoskorin kohde on käytettävissä vain verkkokaupassa。Joissakin hylätyissä ostoskoreissa在pääsy ostoskorin kohteeseen。Jos maksu on kuitenkin suljettu ja asiakas vierailee hylätyssä ostoskorissa, hänet lähetetään esitäytettyyn maksuvaiheeseen eikä ostoskorin kohdetta enää ole。Tämä johtuu siitä， että myyntipaikka on ohitettu sähköpostilla hylätystä ostoskorista。

Komentosarjamenetelmät, joissa käytetään ostoskorin kohdetta
树皮布 Palautustyyppi Kuvaus
.customer Asiakas Palauttaa ostoskorin omistajan (jos sellainen on)。
.shipping_address Toimitusosoite Palauttaa ostoskorin omistajan (jos sellainen)限制了这一趋势。
.discount_code Vaihtelee Palautukset:

discount_code在käytössä上，jos ostoskoriin在sovellettu alennusta上。Tämä ei välttämättä tarkoita sitä， että ostoskorin hinta muuttuu。Jos alennus koskee esimerkiksi yli $50 ostoskoreja, ja komentosarja laskee ostoskorin hinnan $50，discount_code在edelleen olemassa上，mutta ostoskorin的意思是muutu。

Katso esimerkki:discount_code．
.line_items Luettelo< LineItem > Palauttaa luettelon, joka sisältää ostoskorissa olevat rivikohdat。
.presentment_currency Luettelo<字符串> (一)价值;(二)价值ISO 4217-muodossa)。Esimerkiksi美元。
.subtotal_price Raha Palauttaa ostoskorin välisumman hinnan, kun rivikohdan alennukset on sovellettu, mutta enenen kuin alenuskoodeja sovelletaan。
.total_weight 单单 帕劳塔塔kaikkien ostoskorissa olevikohtien kokonaispainon。

CartDiscount: FixedAmount

Komentosarjamenetelmät, joissa käytetään CartDiscount::FixedAmount -kohdetta
树皮布 Palautustyyppi Kuvaus
.code Merkkijono 帕劳塔·阿伦纳斯库丁，乔拉·阿伦纳斯·索维勒塔。
.amount Raha 帕劳塔·阿伦努克森·拉哈苏曼。
.reject({message: String}) 零 Hylkää ostoskoriin sovellettavan alennuskoodin。消息vaaditaan。
.rejected吗? Totuusarvo Palauttaa, josko alennuskoodi在hylätty。

CartDiscount:百分比

Komentosarjamenetelmät, joissa käytetään折扣:百分比-kohdetta
树皮布 Palautustyyppi Kuvaus
.code Merkkijono 帕劳塔·阿伦纳斯库丁，乔拉·阿伦纳斯·索维勒塔。
.prosentuaalinen总结 Desimaali Palauttaa alennuksen prosenttimäärän。
.reject({message: String}) 零 Hylkää ostoskoriin sovellettavan alennuskoodin。消息vaaditaan。
.rejected吗? Totuusarvo Palauttaa, josko alennuskoodi在hylätty。

CartDiscount:航运

Komentosarjamenetelmät, joissa käytetään CartDiscount::送货对象
树皮布 Palautustyyppi Kuvaus
.code Merkkijono 帕劳塔·阿伦纳斯库丁，乔拉·阿伦纳斯·索维勒塔。
.reject({message: String}) 零 Hylkää ostoskoriin sovellettavan alennuskoodin。消息vaaditaan。
.rejected吗? Totuusarvo Palauttaa, josko alennuskoodi在hylätty。

Asiakas

Komentosarjamenetelmät Asiakasobjektin avulla
树皮布 Palautustyyppi Kuvaus
.id Kokonaisluku Palauttaa asiakkaan隧道数。
.email Merkkijono Palauttaa asiakkaan sähköpostiosoitteen。
.tags Luettelo<标记> Palauttaa luettelon merkkijonoista, jotka edustavat kaikkia asiakkaan tunnisteita。
.orders_count Kokonaisluku Palauttaa asiakkaan tekemän tilauksen kokonaismäärän。
.total_spent Raha Palauttaa kokonaissumman, jonka asiakas在käyttänyt kaikille tilauksille。
ob欧宝娱乐app下载地址营销? Totuusarvo Palauttaa, hyväksyykö asiakas markkininin。

LineItem-objekti

单单 < td< td>Palauttaa rivikohdan kokonaispainon。
Komentosarjamenetelmät, joissa käytetään LineItem-objektia
树皮布 Palautustyyppi Kuvaus
.grams
.line_price Raha Rivikohdan hinta。
tujen吗? Totuusarvo Tämä palauttaa tiedon, onko rivikohdan hintaa alennettu komentosarjalla vai manuaalisesti käytetyllä alennuksella。alenuskoodien käyttäminen ei vaikuta palautusarvoon。
. properties 哈希 Palauttaa tämän rivin nimikkeille määritetyt ominaisudet。
.variant 版本; 帕劳塔塔的两个版本，jota rivikohta edustaa。
.quantity Kokonaisluku Palauttaa tämän rivikohdan määrän
.selling_plan_id Kokonaisluku Palauttaa rivikohdan myyntisopimuksen tunnuksen。Tämä menetelmä on hyödyllinen, kun kauppa myy tuotetilauksia ja haluat, että komentosarja havaitsee, kun tuoteversiomyydaan tilauksena．

Luettelo

Komentosarjamenetelmät Luetteloobjektin avulla
树皮布 Palautustyyppi Kuvaus
格式 Luettelo 洛乌登反对，洛乌登反对，洛乌登反对。
[]。 元素，我很好

Palauttaa määritetyn索引元素。
．＆ Luettelo

Palauttaa uuden luettelon, joka sisältää kahta luetteloa varten samat element, joissa ei ole kaksoiskappaleita。
.delete_if Luettelo Poista elementtejä käyttämällä valinnaista koodilohkoa。KatsoRubyndelete_if-menetelman asiakirjat．
是吗? Totuusarvo

Palauttaa真正的， jos luettelossa ei ole elementtejä。
中国当代 元素，我很好

Palauttaa ensimmäisen元素泰零Jos luettelo在tyhjä。
.index (* args， & lohko) 英泰?

Palauttaa luettelon ensimmäisen元素索引。Jos argumentin sijasta annetaan lohko, funktio palauttaa sen ensimmäisen elementin indeksin, jonka lohko on tosi。
.rindex (* args,室) 英泰?

帕劳塔(Palauttaa luettellonvimeisen)元素索引。Jos argumentin sijasta annetaan lohko, funktio palauttaa sen ensimmäisen elementin indeksin, jonka lohko on tosi。
.last 元素，我很好

Palauttaa vimeisen elementin tai零Jos luettelo在tyhjä。
长处 Int。

Palauttaa luettelelementtien määrän。
.size Int。

Pituuden别名。
each (* args,室) Luettelo

Kutista kunkin luettelon elementin jälkeen lohkon, joka välittää elementin lohkon参数。

Toimitusosoite

Komentosarjamenetelmät käyttämällä shippingaddress - object
树皮布 Palautustyyppi Kuvaus
. name merkkijono 帕劳塔(Palauttaa)试图限制人们在henkilön nimen看到的生活。
.address1 merkkijono 帕劳塔(Palauttaa):我想要限制我的生活。
.address2 merkkijono Palauttaa toimitusosoitteen kadunosoiteosan valinnaisen lisäkentän。
.phone merkkijono 帕劳塔(Palauttaa):这是一种限制。
.city merkkijono Palauttaa to imitusosoitten kaupungin。
. zip merkkijono Palauttaa Toimitusosoitteen postinumero。
.province merkkijono Palauttaa to imitussosoiten maakunta/ osavalation。
.province_code merkkijono Palauttaa to imitussosoitten maakunta/ osavalation lyhenidon arvon。
.country_code merkkijono Palauttaa to imitussoitten maan lyhenidon arvon。

Raha

Komentosarjamenetelmät käyttämällä Rahankohdetta
树皮布 Palautustyyppi Kuvaus
．derived_from_presentment (customer_cents:X） Raha Muuntaa summan (senttiä) asiakkaan paikallisesta (esitys-) valuutasta kaupan valuuttaan。Tämä menetelmä hyväksyycustomer_cents参数，joka hyväksyy luvun senttejä。EsimerkiksiMoney.derived_from_presentment (customer_cents: 500)．
格式 Raha 洛乌登反对，洛乌登反对，洛乌登反对。
.zero Raha

洛乌登反对，琼卡暗示对诺拉。
+ Raha Lisaa kaksi钱objektia。
- Raha Vahentaa yhden钱反对意见:反对意见:反对意见:反对意见。
* Raha Kertaa钱objektin numerolla。

Esimerkkeja rahankaytosta

钱．新（分:1000）

罗钱对象，joka edustaa 1000 senttiä tai $10。

钱．新（分:One hundred.）*50

罗钱对象，joka edustaa $1, ja sitten kertoo, että汇总到50。Palauttaa钱对象，joka edustaa $50。

版本;

Komentosarjamenetelmät, joissa käytetään versiobjektia
树皮布 Palautustyyppi Kuvaus
.id Kokonaisluku 帕劳塔版本隧道编号。
.price Raha Palauttaa版本yksikköhinnan。
. product Tuote Palauttaa tuoteversion liittyvän tuotteen。
.SKUs Luettelo<字符串> Palauttaa toteversion SKU-koodit, joita käytetään在varaston seurannassa中使用。
.title Merkkijono 帕劳塔版本尼曼。

Tuote

Komentosarjamenetelmät tuoteobjektin avulla
树皮布 Palautustyyppi Kuvaus
.id Kokonaisluku 帕劳塔，十二隧道数。
.gift_card吗? Totuusarvo 帕劳塔塔，我知道你的名字。
.tags Luettelo<标记> Palauttaa luettelon merkkijonoista, jotka edustavat tälle tuotteelle asetettuja tunnisteita。
.product_type Merkkijono Luokittelus, john tuote voidaan merkitä， ja sitä käytetään yleisesti suodatus-ja hakutuloksissa。
.myyja Merkkijono 帕劳塔tämän 1920 myyjän。

Ytimen

内核关于ruby - modululi, joka sisältyy jokaiseen luokkaan。Tämän takia sen metodit ovat saatavilla jokaiseen kohteseen。Ne käyttäytyvät samoin kuin globaalit funktiot musissa kielissä。

Komentosarjamenetelmät, joissa käytetään ydinobjektia
树皮布 Palautustyyppi Kuvaus
.exit Mikaan Lopettaa senhetkisen komentosarjan suorituksen ilman virhettä。Jos tämä susuitetaan enenen kuin在määritetty上加入Output.cart， komomentojonolla ei ole vaikutusta。Tämä在hyödyllinen tapa poistua komentosarjasta, esimerkiksi工作在亚洲的工作，像suorittamaand komentosarjaa。

Ytimen esimerkki

客户=输入．车．客户如果客户& &客户．电子邮件．end_with吗?（“@mycompany.com”）员工没有资格获得这次晋升。退出结束

Rivikohtaiset menetelmat

Seuraavat menetelmät ovat käytettävissä vainRivikohtien komentosarjoissa：

Ostoskori

Komentosarjaobjekti käyttämällä rivikohdan komentosarjoja Ostoskorisesoluissa
树皮布 Palautustyyppi Kuvaus
.subtotal_price_was Raha Palauttaa kaupan välisumman, enenen kuin alennuksia on sovellettu。
.subtotal_price_changed吗? Totuusarvo Palauttaa, onko välisumhinta muutunut。

LineItem-objekti

Komentosarjamenetelmät, joissa käytetään linekohde - objjektia Rivikohtien komentosarjoissa
树皮布 Palautustyyppi Kuvaus
.change_line_price (钱New_price，{消息:字符串}） Raha Muuta rivikohdan hintaa määritettyyn summaan。一个消息pakollinen。在new_priceOltava alhaisempi kuin nykyisellä hinnalla。
.original_line_price Raha Palauttaa rivikohdan alkuperäisen hinnan, enenkuin komentosarjat ja alennukset otetitin käyttöön。
.line_price_was Raha Palauttaa rivikohdan hinnan, enenkuin senhetkinen komentosarja关于käyttänyt muutoksia。
.line_price_changed吗? Totuusarvo 帕劳塔，onko rivikohan hinta muttunut。
.change_properties (哈希New_properties，{消息:字符串}） 哈希 assetta rivikohtaa varten uusia ominsuuksia。Alkuperäisten ominaisuuksien hajautus tallennetaanproperties_wasKohteeseen, ja menetelmään siirrellä ominaisuuksien hajautus muuttuu rivikohdan uusiksi ominaisuuksisi。
.properties_was 哈希 Palauttaa rivikohdan alkuperäisten ominaisuuksien hajautuksen enenen mutosten soveltamista。
.properties_changed吗? Totuusarvo Palauttaa, onko rivikohan ominaissuuksia muutettu。
.split ({:整数}） LineItem-objekti Jaot rivikohdan kahteen rivikohtaan。取Määrittää， mitä määrä poistetaan alkuperäisestä rivikohdasta uuden rivikohdan luomiseksi。

.split-esimerkki

Tämä esimerkkijono jakaa rivikohdan nimeltäoriginal_line_item变成kahteen rivikohtaan。Uuden rivikohdan määrä 1 (带:1) maarittamalla。Komentosarja käyttää sitten alennettua hintaa uudelle rivikohtaan, jossa on viesti“kolmas hattu 5美元”。

如果original_line_item．数量＞=3.new_line_item=original_line_item．分裂（花:1）new_line_item．change_line_price（钱．新（分:500)，信息:“第三顶帽子5美元”）车．line_items<<new_line_item结束

版本;

Komentosarjamenetelmät, joissa käytetään versiokohdetta Rivikohtien komentosarjoissa
树皮布 Palautustyyppi Kuvaus
.compare_at_price Raha Palauttaa版本vertailuhinnan。帕劳提图来了nolla他说:“我认为这是一个很好的例子。”

Toimitustavat

Seuraavat menetelmät ovat käytettävissätoimituskomentosarjoissa：

Syottaa

Komentojonotavat Syöttöobjektin käyttäminen lähetyskomentosarjoissa
树皮布 Palautustyyppi Kuvaus
.shipping_rates ShippingRateList Palauttaa luettelon kaikista toimitushinnoista。

ShippingRateList

Komentosarjamenetelmät, joissa käytetään shippingratelist - objecktia lähetyskomentosarjoissa
树皮布 Palautustyyppi Kuvaus
.delete_if ShippingRateList Poista toimitusmaksut käyttämällä valinnaista koodilohkoa。Katso鲁比（人名）delete_if-menetelmandokumentaatio。
lajitella ! ShippingRateList Lajittele toimituskulut vertailuoperaattorin käyttämällä tai käytä valinnaista koodilohkoa。Katso鲁比（人名）排序!-menetelmandokumentaatio。
.sort_by ! ShippingRateList Lajittele toimitusmaksut käyttämällä valinnaista koodilohkoa。Katso鲁比（人名）sort_by !-menetelmandokumentaatio。

ShippingRate

Komentosarjamenetelmät, jotka käyttävät Lähetyskomentosarjat ShippingRate-objektia
树皮布 Palautustyyppi Kuvaus
.code Merkkijono 帕劳塔塔去限制我们的行为。
.markup Raha Palauttaa to imititusmaksun marginalin, jos mahdollista。
. name Merkkijono Palauttaa toimituskulun nimen。空田武多käyttämällächange_name-toimintoa。
.price Raha 帕劳塔塔，让我们一起去做吧。
.lahde Merkkijono Palauttaa toimitushintaan liittyvän lähteen (kuljetuspalvelun)， jos sellainen on。Sitä ei voi muokata。
.change_name (字符串new_name) Merkkijono Muuttaa toimituskulujen nimeä (enintään 255 merkkiä)。Lähteen muttaminen, poistaminen tai pililottaminen ei ole mahdollista。
.apply_discount (钱折扣，{消息:字符串}) Raha 渥太华käyttöön määritetyn kiinteän summan alennuksen。中国南方的中国大陆是中国大陆，中国大陆是中国大陆。看一看包亚麻。
.phone_required吗? Totuusarvo Palauttaa真正的他说:“我是说，我是说，我是说，我是说，我是说，我是说，我是说，我是说，我是说假乔斯·普赫里亚的许多人都是如此。

Maksutavat

Seuraavat menetelmät ovat käytettävissämaksukomentosarjoissa：

Syottaa

Komentojonomenetelmät Syöttöobjektin käyttäminen maksukomentosarjoissa
树皮布 Palautustyyppi Kuvaus
.payment_gateways PaymentGatewaysList Palauttaa luettelon kaikista kaupan maksuportaaleja。

PaymentGatewayList

脚本方法-maksukomentosarja-objektin käyttäminen maksukomentosarjoissa
树皮布 Palautustyyppi Kuvaus
.delete_if PaymentGatewayList Poista maksuportaaleja käyttämällä valinnaista koodilohkoa。Katso鲁比（人名）delete_if-menetelmandokumentaatio。
lajitella ! PaymentGatewayList Lajittele maksupportaaleja vertailuoperaattoria käyttäen tai käytä valinnaista koodilohkoa。Katso鲁比（人名）排序!-menetelmandokumentaatio。
.sort_by ! PaymentGatewayList Voit lajitella maksuportaaleja käyttämällä valinnaista koodilohkoa。Katso鲁比（人名）sort_by !-menetelmandokumentaatio。

Maksuportaalia

树皮布 Palautustyyppi Kuvaus
. name Merkkijono Palauttaa mak支持在nimen。
.enabled_card_brands Luettelo<字符串>

Jos maksuportaalissa tuetaan luottokortteja, se palauttaa luettelon luottokortyypeistä， jotka kauppa hyväksyy。Jos makitportalali是一个很好的例子，他是一个很好的例子，他是一个很好的例子。
.change_name (字符串new_name) Merkkijono muutta makutta makutta支持一个人。Logoilla varustettuja maksuportaaleja ei voi nimetä uudelleen。

Esimerkkeja

Kun asiakas tilaa seuraavasta komentorivikomentosarjasta esimerkin, joka ei ole lahjakortti, 15 hintaa alenenetan， $9 mennessä。Näkyvillä在myös kokonaissumma, jonka asiakas在käyttänyt kaikkien kauppasi käyntien aikana;

Asiakas = syötteet。Asiakassyote line_items。Jokainen do | Line | Tuote = Line seuraava，是否有礼品卡?line_change_line_price (Line line_price-raha)usi (senti -900)， viesti: asiakas。total_spent) Lopeta lähtö。购物车= syöttö。

Lisatietoja

Lisatietoja aiheesta:

Valmiina aloittamaan Shopifyssa?

Kokeile ilmaiseksi