Datu zehatzak JSON bidez atzitzea Shopify-ko administratzailean

JSON izena JavaScript Object Notation esapidearen laburdura da, datuak gordetzeko eta garraiatzeko formatu bat. Askotan, zerbitzarietatik web-orrietara datuak bidaltzeko erabiltzen da. Shopify-ko administratzaileko baliabide-orri gehienetan, hala nola Eskaerak, Produktuak edo Bezeroak orrietan, datu zehatzagoak atzitu ditzakezu JSON formatua erabiliz.

JSON erabiliz garapen aurreratuko lanak egin behar ez dituzun arren, Shopify-ko administratzailean baliabide jakin baten JSON fitxategia atzitu ahal izateak informazio zehatzagoa biltzen edota arazoak zeure kabuz ikertzen eta konpontzen lagun zaitzake. Adibidez, produktu baten JSON fitxategia berrikusi dezakezu haren aldaeraren IDa aurkitzeko, zenbait datu-migrazio lanetarako edo gaien kodearen pertsonalizazioetarako beharrezkoa izan daitekeena. Beste adibide gisa, eskaera baten JSON fitxategia kontsultatu dezakezu erabili nahi duzun datu-aldagaia berresteko, Shopify Flow aplikazioan lan-fluxu automatizatu bat sortzean.

Nagusiki garatzaileek erabiltzen dute JSON formatua, baina programazio-ezagutza txikiak dituzten erabiltzaileentzat ere oso erabilgarria izan daiteke euren Shopify-ko administratzailean ohiko JSON informazioa nola bilatu eta nola interpretatu ikastea.

Orri honetan

JSON fitxategi baten formatua aldatzea

JSON datu gordinak habiaratutako aldagaien eta parentesien sekuentzia luze gisa bistaratzen dira, eta pertsonentzat zaila izaten da horiek irakurtzea.

JSON formatua irakurgarriagoa izateko, kontuan hartu aukera hauek:

Instalatu JSON bisore baten luzapena nabigatzailean.
Erabili web-nabigatzaile moderno gehienek modu lehenetsian duten pretty-print funtzioa:

Adibidezko produktu-informazioa erakusten duen JSON produktu-fitxategi baten pantaila-argazkia.

JSON fitxategiak atzitzea Shopify-ko administratzailean

Shopify-ko administratzailea zure negozioaren alderdi guztiak kudeatzeko gune nagusia da, eta modu lehenetsian informazio erabilgarriena eta garrantzitsuena soilik bistaratzeko diseinatuta dago. Zure administratzailean ekintzak gauzatzen diren bakoitzean biltzen den informazio gehigarria baliabide-orri desberdinetako .json fitxategietan gordetzen da. Xehetasun gehigarri horiek ez zaizkizu modu lehenetsian erakusten; izan ere, informazio-kopuru hori gehiegizkoa eta alferrikakoa litzateke, eta zaildu egingo luke administratzailearen erabilera.

Negozioko zeregin gehienetarako, Shopify-ren dauden tresnak erabil ditzakezu zure dendaren informazioa atzitzeko eta interpretatzeko. Hala ere, noizean behin lagungarria izan daiteke baliabide jakin batzuei (hala nola produktu edo eskaerei) buruzko informazio zehatza berrikustea, zerbait zergatik edo noiz gertatu den argitzeko eta arazoak konpontzeko.

Adibidea: Eskaera baten JSON fitxategia atzitzea

Adibide honetan, eskaera baten JSON fitxategia atzituko duzu Shopify-ko administratzailean.

Urratsak:

Zure Shopify-ko administratzailetik, joan Eskaerak atalera.
Sakatu edozein eskaera Eskaerak zerrendan.
Nabigatzailearen helbide-barran, gehitu .json URL helbidearen amaieran. Adibide honen antzekoa izango da:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

Sakatu Sartu orria JSON formatuan berriro kargatzeko.
Aukerakoa: Zure nabigatzailean JSON bisore baten luzapenik instalatuta ez baduzu, aktibatu Pretty-print ezarpena nabigatzailean, JSON fitxategia errazago erabiltzeko modukoa izan dadin. Lortu informazio gehiago JSON fitxategi baten formatua aldatzeari buruz.

Ikusiko duzu eskaerari buruz espero den informazio asko agertzen dela, hala nola eskaerari lotutako "currency" eta "line_items", baina bestelako informazio zehatz asko ere barne hartzen dela, adibidez, bezeroak eskaera egiteko erabilitako nabigatzaile-saioko "client_details". Mota horretako informazioa erabilgarria da saioen jarraipen orokorra egiteko eta marketin-plataformetako estatistiketarako, baina ez duzu beharrezkoa eskaera prozesatu eta osatzeko.

JSON fitxategi batean eremu zehatzak bistaratzea

JSON fitxategiek eremu zehatz batzuk soilik bistaratzea behartu dezakezu. Horrek informazioa errazago interpretatzen lagun dezake, sartu nahi dituzun propietate jakinak ezagutzen dituzunean. Nabigatzailearen helbide-barran, edozein JSON fitxategiren URLaren amaieran, gehitu ?fields= eta sartu bistaratu nahi dituzun propietateen izenak, edozein ordenatan, komaz bereizita.

Adibidez, eskaera baten IDa, bezeroaren informazioa, prezio osoa eta etiketak bistaratzeko, gehitu ?fields=id,customer,total_price,tags JSON fitxategiaren URLaren amaieran; adibidez:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

Beste JSON baliabide batzuk erabiltzea

Hurrengo JSON baliabideak erabil ditzakezu Shopify-ko administratzailean informazio zehatza bistaratzeko:

Produktuen kopurua: Gehitu /count.json Produktuak zerrendaren URLaren amaieran produktu kopuru osoa bistaratzeko. URL osoak hurrengoa izan beharko luke:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

Transakzioak: Gehitu /transactions.json eskaera-orri baten URLaren amaieran, eskaeraren transakzio-informazioa soilik bistaratzeko. Lortu informazio gehiago Transakzioak baliabideari buruz.
Eskaera osatzeak: Gehitu /fulfillments.json eskaera-orri baten URLaren amaieran, eskaera osatzeari buruzko informazioa soilik bistaratzeko. Lortu informazio gehiago Eskaera osatzea baliabideari buruz.
Bertan behera utzitako ordainketa-prozesuak: Gehitu .json bertan behera utzitako ordainketa-prozesu baten URLaren amaieran, ordainketa-prozesu horri buruzko informazio zehatza bistaratzeko. Lortu informazio gehiago Bertan behera utzitako ordainketa-prozesua baliabideari buruz.

Ohiko JSON propietateak arazoak konpontzeko

Hurrengo taulan zenbait JSON propietate zerrendatzen dira, baliabide mota desberdinetan arazoak konpontzen laguntzeko kontsulta ditzakezunak. Adibidez, produktu jakin bat noiz argitaratu zen berretsi nahi baduzu, produktuaren JSON fitxategian published_at propietatea berrikusi dezakezu; honek data eta ordua erakusten ditu ISO 8601 formatuan.

Taula honek ez ditu barne hartzen Shopify-ko administratzailean gordetako JSON baliabide edo propietate guzti-guztiak; beraz, kontsultatu Shopify-ren garatzaileentzako dokumentazioa hemen sartu ez den edozein baliabide edo propietateren definizioak aurkitzeko.

Administrazio-panelaren zenbait baliabide-adibide eta horiei lotutako propietate arruntak zerrendatzen ditu, baita arazoak konpontzean zertarako erabil daitezkeen zehazten duten definizioak ere.
Baliabidea	JSON propietatea	Definizioa
Produktua	`"product": { "created_at"`	Produktua lehenengo aldiz sortu zeneko data eta ordua.
	`"product": { "published_at"`	Produktuaren egoera Aktibo gisa ezarri zeneko data eta ordua.
	`"product": { "updated_at"`	Produktua azkenengo aldiz eguneratu zeneko data eta ordua. Horrek barne har ditzake produktuaren deskribapenean, izenburuan edo SEO informazioan egindako aldaketak, baita eguneratze automatikoak ere, esaterako produktua erosten denean inbentarioan egiten diren aldaketak.
Aldaera	`"product": { "variants": [ { "created_at"`	Aldaera lehenengo aldiz sortu zeneko data eta ordua. Hori produktu orokorra sortu zeneko data eta orduaren desberdina izan daiteke.
	`"product": { "variants": [ { "updated_at"`	Aldaera azkenengo aldiz eguneratu zeneko data eta ordua. Hori produktu orokorra azkenengoz eguneratu zeneko data eta orduaren desberdina izan daiteke.
	`"product": { "variants": [ { "inventory_quantity"`	Datu-baseko uneko balioa eta bezeroek erosi ahal dutena. Hori balio negatiboa izan liteke aldaeraren inbentarioari jarraipenik egiten ez bazaio edo gehiegi saltzeko ezarrita badago.
	`"product": { "variants": [ { "old_inventory_quantity"`	Datu-baseko balioa, aldaeraren azken `updated_at` dataren aurrekoa.
Eskaera	`"order": { "line_items": [ { "requires_shipping"`	`true` edo `false` gisa bistaratzen da. Horrek adierazten ditu produktuaren edo aldaeraren bidalketa-ezarpenak eskaera egin zen unean.
	`"order": { "line_items": [ { "taxable"`	`true` edo `false` gisa bistaratzen da. Horrek adierazten du nola zegoen ezarrita produktuak edo aldaerak zergak kobratzea eskaera egin zen unean.
	`"order": { "line_items": [ { "variant_inventory_management"`	`shopify`, `amazon_marketplace_web`, `null` edo hirugarrenen balio gisa bistaratzen da, zein eskaerak osatzeko zerbitzu dagoen ezarrita produktuaren inbentarioari jarraipena egiteko. `null` balioak esan nahi du eskaera egitean produktuaren inbentarioari ez zitzaiola jarraipenik egiten.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Sistemak eskaera osatu ahal izateko zenbat inbentario daukan gordeta oraindik bistaratzen du. Hori ez da aldaeraren uneko inbentarioaren berdina.
	`"order": { "line_items": [ { "quantity"`	Erosi diren produktuen edo aldaeren kopurua.
	`"order": { "line_items": [ { "tax_lines"`	Ameriketako Estatu Batuetan, honek estatuaren, konderriaren eta udalerriaren balioak bistaratzen ditu. Zerga-lerrorik bistaratzen ez bada, baina eskaeran zerga kobratu bazen, horrek esan nahi du zerga bidalketa-kostuan kobratu zela.
Bezeroa	`"customer": { "created_at"`	Bezeroa lehenengo aldiz sortu zeneko data eta ordua.
Bezeroa	`"customer": { "updated_at"`	Bezero-profila azkenengo aldiz eguneratu zeneko data eta ordua.

Metaeremuak JSON formatuan

Metaeremuak aukera malgua dira Shopify-ren baliabide bati (adibidez, produktu edo bildumei) informazio pertsonalizatu gehigarria eransteko. Metaeremuak erabiliz gordetako datuen zenbait adibide dira produktuaren zehaztapenak, tamainen taulak, deskarga daitezkeen agiriak, argitaratze-datak, irudiak edo piezen zenbakiak. Lortu informazio gehiago metaeremuen erabilerari buruz.

Onartutako baliabide baten orriaren URLaren amaieran /metafields.json gehi dezakezu baliabide horri lotutako metaeremuak bistaratzeko. Kontsultatu hurrengo taula JSON erabiliz metaeremuen informazioa bistaratzeko erabil ditzakezun baliabide- eta URL-formatuen zenbait adibide ikusteko.

Administrazio-panelaren baliabide-adibide batzuk zerrendatzen ditu, baita JSON metaeremuen fitxategiaren URLaren adibide bat ere.
Baliabide-motaren adibidea	URL adibidea
Bilduma	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Bezeroa	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Eskaera	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Orria	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produktua	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Aldaera	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Produktuaren irudia	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Oharra: Produktuaren irudien metaeremuak API bidez soilik gehi daitezke. Ordeztu URLko `{id}` eta gainerako leku-markak zure APIko kontsultetako benetako balioekin.
Denda	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Metaeremuak izan ditzaketen baliabideen zerrenda osoa eta baliabide-mota bakoitzerako gordetzen diren propietate-mota zehatzak ikusteko, kontsultatu Metaeremuen JSON baliabidea Shopify-ren garatzaileentzako dokumentazioan.

Gertaerak JSON formatuan

Shopify-ren zenbait baliabidek gertaerak sortzen dituzte ekintza batzuk amaitzen direnean, adibidez, blog-argitalpen bat sortzean, eskaera bat osatzean edo produktu bat gehitzean.

Onartutako baliabide baten orriaren URLaren amaieran /events.json gehi dezakezu baliabide horri lotutako gertaerak bistaratzeko. Kontsultatu hurrengo taula JSON erabiliz gertaeren informazioa bistaratzeko erabil ditzakezun baliabide- eta URL-formatuen zenbait adibide ikusteko.

Administrazio-panelaren baliabide-adibide batzuk zerrendatzen ditu, baita JSON gertaeren fitxategien URLaren adibide bat ere.
Baliabide-motaren adibidea	URL adibidea
Eskaera	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Fitxategi honek gertaeren `author` (egilea) zerrendatzen du, eta ekintza jakin batzuk zein erabiltzailek burutu dituen jakinarazten du, hala nola produktu bat nork edo zerk argitaratu duen.
Produktua	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Fitxategi honek gertaeren `author` (egilea) zerrendatzen du, eta ekintza jakin batzuk zein erabiltzailek burutu dituen jakinarazten du, hala nola ordainketa bat ordainduta gisa nork edo zerk markatu duen.
Denda	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` URL formatu honek zure dendan gertatutako 250 gertaera berrienak bistaratzen ditu. Gertaerek honako hauek har ditzakete barne (besteak beste): produktuak sortzea edo eguneratzea, orriak ezabatzea eta aldaerak eguneratzea.

Gertaerak sor ditzaketen baliabideen zerrenda osoa eta baliabide-mota bakoitzerako sortzen diren gertaera zehatzak ikusteko, kontsultatu Gertaeren JSON baliabidea Shopify-ren garatzaileentzako dokumentazioan.