Ajuda
Inicia la sessió

Accés a dades detallades al panell d'administració de Shopify mitjançant JSON

JSON, l'acrònim de JavaScript Object Notation, és un format per emmagatzemar i transportar dades, i s'utilitza sovint quan s'envien dades des de servidors cap a pàgines web. A la majoria de pàgines de recursos del panell d'administració de Shopify, com ara les pàgines de Comandes, Productes o Clients, pots accedir a dades més detallades mitjançant JSON.

Tot i que no cal que duguis a terme tasques de desenvolupament avançades amb JSON, poder accedir al fitxer JSON d'un recurs concret del teu panell d'administració de Shopify et pot ajudar a recopilar informació més detallada o a investigar o resoldre problemes de manera autònoma. Per exemple, pots revisar el fitxer JSON d'un producte per trobar-ne l'ID de la variant, la qual cosa pot ser necessària per a determinades tasques de migració de dades o personalitzacions del codi del tema. Un altre exemple és que pots consultar el fitxer JSON d'una comanda per confirmar la variable de dades que vols utilitzar a l'hora de crear un flux de treball automatitzat a Shopify Flow.

Generalment, els desenvolupadors són els qui més utilitzen JSON, però els usuaris amb pocs coneixements de programació també poden treure profit d'aprendre a trobar i interpretar informació comuna de JSON al seu panell d'administració de Shopify.

En aquesta pàgina

Canviar el format d'un fitxer JSON

Les dades de JSON sense processar es mostren com una seqüència llarga de variables i claudàtors imbricats, cosa que fa que siguin difícils de llegir per a un usuari humà.

Per fer que el format de JSON sigui més llegible, considera alguna de les opcions següents:

  • Instal·la una extensió de visor de JSON al teu navegador.
  • Utilitza la capacitat pretty-print que la majoria de navegadors web moderns tenen disponible per defecte:

Screenshot of a JSON product file with example product information displayed. The

Accés a fitxers JSON al panell d'administració de Shopify

El panell d'administració de Shopify és el centre principal per gestionar tots els aspectes del teu negoci i està dissenyat per mostrar només la informació més útil i rellevant per defecte. La informació addicional que es recopila cada cop que es duen a terme accions al panell d'administració s'emmagatzema als fitxers .json de diferents pàgines de recursos. Aquests detalls addicionals no se't mostren per defecte, ja que aquesta quantitat d'informació seria excessiva i inútil, i faria que el teu panell d'administració fos difícil d'utilitzar.

Per a la majoria de tasques comercials, pots utilitzar les eines existents de Shopify per accedir a la informació de la teva botiga i interpretar-la. Tanmateix, de vegades pot ser útil revisar informació específica sobre recursos concrets, com ara productes o comandes, durant la resolució de problemes per entendre per què o quan ha passat una cosa concreta.

Exemple: Accés al fitxer JSON d'una comanda

En aquest exemple, accediràs al fitxer JSON d'una comanda al teu panell d'administració de Shopify.

Passos:

  1. Al teu panell d'administració de Shopify, ves a Comandes.

  2. Fes clic a qualsevol comanda de la llista Comandes.

  3. A la barra d'adreces del navegador, afegeix .json al final de l'adreça URL. El resultat serà semblant a aquest exemple:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. Prem Retorn per tornar a carregar la pàgina en format JSON.
  2. Opcional: Si no tens instal·lada cap extensió de visor de JSON al navegador, activa la configuració Pretty-print al navegador perquè el fitxer JSON sigui més fàcil d'utilitzar. Obtén més informació sobre com canviar el format d'un fitxer JSON.

Veuràs que es mostra molta informació previsible sobre la comanda, com ara la "currency" i els "line_items" associats a la comanda, però també s'inclou molta altra informació detallada, com ara els "client_details" de la sessió del navegador del client quan va fer la comanda. Aquest tipus d'informació és útil per fer un seguiment general de la sessió i de l'anàlisi de dades de la plataforma de màrqueting, però no et cal per processar i preparar la comanda.

Mostrar camps específics en un fitxer JSON

Pots forçar els fitxers JSON a mostrar només camps específics, la qual cosa pot facilitar la interpretació de la informació quan saps les propietats concretes que hi vols incloure. Al final de l'URL de qualsevol fitxer JSON a la barra d'adreces del navegador, afegeix ?fields= i després inclou els noms de les propietats que vols mostrar, en qualsevol ordre i separades per una coma.

Per exemple, per mostrar l'ID d'una comanda, la informació del client, el preu total i les etiquetes, afegeix ?fields=id,customer,total_price,tags al final de l'URL del fitxer JSON, com es veu a l'exemple següent:

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

Ús d'altres recursos JSON

Pots utilitzar els recursos JSON següents per mostrar informació específica al teu panell d'administració de Shopify:

  • Recompte de productes: Afegeix /count.json al final de l'URL de la llista de Productes per mostrar el nombre total de productes. L'URL complet hauria de ser:
https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • Pagaments: Afegeix /transactions.json al final de l'URL d'una pàgina de comanda per mostrar només la informació de pagament de la comanda. Obtén més informació sobre el recurs Pagament.
  • Preparacions de comandes: Afegeix /fulfillments.json al final de l'URL d'una pàgina de comanda per mostrar només la informació de preparació de la comanda. Obtén més informació sobre el recurs Preparació de comandes.
  • Pagaments abandonats: Afegeix .json al final de l'URL d'una compra abandonada per mostrar informació detallada sobre la compra abandonada. Obtén més informació sobre el recurs Compra abandonada.

Propietats de JSON comunes per a la resolució de problemes

A la taula següent es detallen les propietats de JSON que potser vols consultar per obtenir assistència en la resolució de problemes amb diferents tipus de recursos. Per exemple, si vols confirmar quan s'ha publicat un producte concret, pots revisar el fitxer JSON del producte i buscar la propietat published_at, que mostra la data i l'hora en format ISO 8601.

Aquesta taula no inclou tots els recursos o propietats de JSON possibles que s'emmagatzemen al panell d'administració de Shopify; per tant, consulta la documentació per a desenvolupadors de Shopify per veure les definicions de qualsevol recurs o propietat que no s'hi inclogui.

S'hi enumeren alguns exemples de recursos del panell d'administració i les propietats comunes que s'hi associen, així com definicions sobre com es poden utilitzar per a la resolució de problemes.
RecursPropietat JSONDefinició
Producte
"product": {
  "created_at"
La data i l'hora en què es va crear el producte inicialment.
"product": {
  "published_at"
La data i l'hora en què l'estat del producte es va establir a Actiu.
"product": {
  "updated_at"
La data i l'hora més recents en què es va actualitzar el producte. Això pot incloure canvis a la descripció del producte, al títol o a la informació de SEO, així com actualitzacions automàtiques, com ara canvis a l'estoc quan es compra un producte.
Variant
"product": {
  "variants": [
    {
    "created_at"
La data i l'hora en què es va crear la variant inicialment. Pot ser diferent de la data i l'hora en què es va crear el producte en conjunt.
"product": {
  "variants": [
    {
    "updated_at"
La data i l'hora més recents en què es va actualitzar la variant. Pot ser diferent de la data i l'hora en què es va actualitzar el producte en conjunt per darrera vegada.
"product": {
  "variants": [
    {
    "inventory_quantity"
El valor actual de la base de dades i allò que és accessible per tal que els clients ho puguin comprar. Aquest valor pot ser negatiu si no es fa el seguiment de l'estoc de la variant, o bé si s'ha configurat per vendre per sobre de l'estoc.
"product": {
  "variants": [
    {
    "old_inventory_quantity"
El valor de la base de dades abans de la darrera data updated_at de la variant.
Comanda
"order": {
   "line_items": [
    {
    "requires_shipping"
Es mostra com a true o false. Indica la configuració d'enviament del producte o de la variant en el moment en què es va fer la comanda.
"order": {
   "line_items": [
    {
    "taxable"
Es mostra com a true o false. Indica com estava configurat el producte o la variant per cobrar impostos en el moment en què es va fer la comanda.
"order": {
   "line_items": [
    {
    "variant_inventory_management"
Es mostra com a shopify, amazon_marketplace_web, null o com a un valor de tercers segons quin servei de preparació de comandes s'hagi configurat per fer el seguiment de l'estoc del producte. Un valor null significa que no es feia el seguiment del producte en el moment de la comanda.
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
Mostra quant d'estoc encara reserva el sistema per poder completar la comanda. Això no equival a l'estoc actual de la variant.
"order": {
   "line_items": [
    {
    "quantity"
El nombre de productes o de variants que s'han comprat.
"order": {
   "line_items": [
    {
    "tax_lines"
Als Estats Units, això mostra els valors estatals, comarcals i municipals. Si no es mostra cap línia d'impostos, però s'ha cobrat algun impost a la comanda, vol dir que l'impost s'ha cobrat sobre el cost d'enviament.
Client
"customer": {
  "created_at"
La data i l'hora en què es va crear el client inicialment.
"customer": {
  "updated_at"
La data i l'hora més recents en què es va actualitzar el perfil de client.

Metacamps en JSON

Els metacamps són una manera flexible d'adjuntar informació personalitzada addicional a un recurs de Shopify, com ara als productes o a les col·leccions. Alguns exemples de dades emmagatzemades mitjançant metacamps són les especificacions dels productes, les guies de talles, els documents descarregables, les dates de llançament, les imatges o els números de peça. Pots saber-ne més sobre com utilitzar els metacamps.

Pots afegir /metafields.json al final de l'URL d'una pàgina de recursos compatible per mostrar els metacamps associats amb aquell recurs. Consulta la taula següent per veure alguns exemples de recursos i formats d'URL que s'utilitzen per mostrar la informació dels metacamps mitjançant JSON.

S'hi enumeren alguns exemples de recursos del panell d'administració, juntament amb un URL d'exemple d'un fitxer de metacamps en JSON.
Tipus de recurs d'exempleURL d'exemple
Col·leccióhttps://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json
Clienthttps://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json
Comandahttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json
Pàginahttps://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json
Productehttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json
Varianthttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json
Imatge del productehttps://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image

Nota: Els metacamps d'imatge del producte només es poden afegir a través de l'API. Substitueix l'{id} i altres textos d'exemple a l'URL pels valors reals de les teves consultes d'API.

Botigahttps://admin.shopify.com/store/{your-store-name}/metafields.json

Per obtenir una llista completa dels recursos que poden tenir metacamps i els tipus específics de propietats que s'emmagatzemen per a cada tipus de recurs, consulta el recurs Metafield JSON a la documentació per a desenvolupadors de Shopify.

Events en JSON

Els Events els generen alguns recursos de Shopify en completar-se certes accions, com ara crear una entrada del blog, preparar una comanda o afegir un producte.

Pots afegir /events.json al final de l'URL d'una pàgina de recursos compatible per mostrar els Events associats a aquest recurs. Consulta la taula següent per veure alguns exemples de recursos i els formats d'URL que s'utilitzen per mostrar informació dels Events mitjançant JSON.

S'hi enumeren alguns exemples de recursos del panell d'administració, juntament amb un URL d'exemple d'un fitxer d'Events en JSON.
Tipus de recurs d'exempleURL d'exemple
Comandahttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

Aquest fitxer inclou l'author dels Events, per informar-te de quins usuaris han completat certes accions, com ara qui o què ha publicat un producte.

Productehttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

Aquest fitxer inclou l'author dels Events, per informar-te de quins usuaris han completat certes accions, com ara qui o què ha marcat un pagament com a pagat.

Botigahttps://admin.shopify.com/store/{your-store-name}/events.json?limit=250

Aquest format d'URL mostra els darrers 250 Events que s'han produït a la botiga. Els Events poden incloure, entre d'altres, la creació o les actualitzacions de productes, l'eliminació de pàgines i les actualitzacions de variants.

Per obtenir una llista completa dels recursos que poden crear Events i dels Events específics que es creen per a cada tipus de recurs, consulta el recurs Event JSON a la documentació per a desenvolupadors de Shopify.