Acceso aos datos detallados no teu administrador de Shopify mediante JSON

JSON, que son as siglas de JavaScript Object Notation, é un formato que se usa para almacenar e transportar datos, normalmente ao envialos desde os servidores ás páxinas web. Na maioría das páxinas de recursos do administrador de Shopify, como Pedidos, Produtos ou Clientes, podes acceder a datos máis detallados mediante JSON.

Aínda que non é preciso que realices tarefas de desenvolvemento avanzado con JSON, poder acceder ao ficheiro JSON dun recurso específico no teu administrador de Shopify pode axudarche a recompilar información máis detallada ou a investigar e solucionar problemas pola túa conta. Por exemplo, podes revisar o ficheiro JSON dun produto para buscar o seu ID de variante, o cal pode ser necesario para determinadas tarefas de migración de datos ou para a personalización do código do tema. Outro exemplo é que podes consultar o ficheiro JSON dun pedido para confirmar a variable de datos que queres usar ao crear un fluxo de traballo automatizado en Shopify Flow.

As persoas que se dedican ao desenvolvemento son as que adoitan usar JSON. Non obstante, as persoas usuarias con poucos coñecementos de programación tamén poden beneficiarse se aprenden a buscar e interpretar información común en formato JSON no seu administrador de Shopify.

Nesta páxina

Reformatear un ficheiro JSON

Os datos JSON sen procesar móstranse como unha longa secuencia de variables aniñadas e parénteses ou chaves, algo que resulta difícil de ler para os humanos.

Para facer que o formato JSON sexa máis lexible, considera calquera destas opcións:

Instala unha extensión para ver ficheiros JSON no navegador.
Usa a capacidade pretty-print que a maioría dos navegadores web teñen dispoñible por defecto:

Captura de pantalla dun ficheiro de produto JSON na que se mostra información de exemplo dun produto. A configuración da caixa de verificación 'pretty-print' está activa, destacada na parte superior esquerda da páxina.

Acceder aos ficheiros JSON no teu administrador de Shopify

O administrador de Shopify é o centro principal para xestionar todos os aspectos do teu negocio e está deseñado para mostrar por defecto só a información máis útil e relevante. A información adicional que se recompila cando se realizan accións no teu administrador almacénase nos ficheiros .json das diferentes páxinas de recursos. Estes detalles adicionais non se mostran por defecto porque esa cantidade de información resultaría abrumadora e inútil e dificultaría o uso do teu administrador.

Para a maioría das tarefas da túa empresa, podes usar as ferramentas existentes de Shopify para acceder á información da túa tenda e interpretala. Porén, en ocasións pode resultar útil revisar a información específica de determinados recursos, como produtos ou pedidos, á hora de solucionar problemas sobre por que ou cando sucedeu algo.

Exemplo: acceder ao ficheiro JSON dun pedido

Neste exemplo, accederás ao ficheiro JSON dun pedido no teu administrador de Shopify.

Pasos:

Desde o teu administrador de Shopify, vai a Pedidos.
Fai clic en calquera pedido da lista de Pedidos.
Na barra de enderezos do navegador, engade .json ao final do enderezo URL. Será parecido a este exemplo:

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

Preme Intro para recargar a páxina en formato JSON.
Opcional: se non tes ningunha extensión para ver ficheiros JSON instalada no teu navegador, activa a configuración Pretty-print deste para que o ficheiro JSON sexa máis fácil de usar. Obtén máis información sobre como reformatear un ficheiro JSON.

Verás que se mostra moita da información esperada sobre o pedido, como a moeda ("currency") e os artigos de liña ("line_items") asociados a este. Ademais, tamén se inclúe outra información detallada, como os detalles do cliente ("client_details") da sesión do navegador cando se realizou o pedido. Este tipo de información é útil para o seguimento xeral das sesións e da analítica das plataformas de mercadotecnia, pero non a necesitas para tramitar e preparar o pedido.

Mostrar campos específicos nun ficheiro JSON

Podes forzar aos ficheiros JSON para que mostren só campos específicos, o que pode facilitar a interpretación da información cando coñeces as propiedades en concreto que queres incluír. Ao final do URL de calquera ficheiro JSON na barra de enderezos do navegador, engade ?fields= e, a continuación, inclúe os nomes das propiedades que queres que se mostren, en calquera orde e separados por unha coma.

Por exemplo, para mostrar o ID, a información do cliente, o prezo total e as etiquetas dun pedido, engade ?fields=id,customer,total_price,tags ao final do URL do ficheiro JSON, como no seguinte exemplo:

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

Uso doutros recursos JSON

Podes usar os seguintes recursos JSON para mostrar información específica no teu administrador de Shopify:

Reconto de produtos: engade /count.json ao final do URL da lista de Produtos para mostrar o número total de produtos. O URL completo debería ser:

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

Transaccións: engade /transactions.json ao final do URL dunha páxina de pedido para mostrar só a información das transaccións do mesmo. Obtén máis información sobre o recurso Transaccións.
Preparacións de pedidos: engade /fulfillments.json ao final do URL dunha páxina de pedido para mostrar só a información da preparación deste. Obtén máis información sobre o recurso Preparación de pedidos.
Pagamentos abandonados: engade .json ao final do URL dun paso por caixa abandonado para mostrar información detallada sobre este. Obtén máis información sobre o recurso Paso por caixa abandonado.

Propiedades comúns de JSON para a resolución de problemas

Na seguinte táboa indícanse as propiedades de JSON que podes consultar para obter axuda sobre a resolución de problemas con diferentes tipos de recursos. Por exemplo, se queres confirmar cando se publicou un produto en concreto, podes revisar o ficheiro JSON do produto e buscar a propiedade published_at, que mostra a data e a hora en formato ISO 8601.

Esta táboa non inclúe todos os recursos nin todas as propiedades de JSON posibles que se almacenan no administrador de Shopify, polo que che recomendamos que consultes a documentación para desenvolvedores de Shopify a fin de atopar as definicións de calquera recurso ou propiedade que non figure aquí.

Enumera algúns exemplos de recursos do panel de administración e as propiedades comúns asociadas a eles, incluídas as definicións de para que se poden usar na resolución de problemas.
Recurso	Propiedade JSON	Definición
Produto	`"product": { "created_at"`	A hora e data na que se creou o produto inicialmente.
	`"product": { "published_at"`	A hora e data na que o estado do produto se definiu como Activo.
	`"product": { "updated_at"`	A hora e a data máis recentes en que se actualizou o produto. Isto pode incluír cambios na descrición do produto, no título ou na información de SEO, así como actualizacións automáticas como cambios no inventario cando se merca un produto.
Variante	`"product": { "variants": [ { "created_at"`	A hora e data na que se creou a variante inicialmente. Pode ser diferente da data e a hora nas que se creou o produto xeral.
	`"product": { "variants": [ { "updated_at"`	A hora e data máis recentes nas que se actualizou a variante. Pode ser diferente da data e a hora nas que se actualizou o produto xeral por última vez.
	`"product": { "variants": [ { "inventory_quantity"`	O valor actual da base de datos e o que está accesible aos clientes para a compra. Podería ser un valor negativo se non se está a rastrexar o inventario da variante ou se se configurou para sobrevender.
	`"product": { "variants": [ { "old_inventory_quantity"`	O valor da base de datos antes da última data de `updated_at` da variante.
Pedido	`"order": { "line_items": [ { "requires_shipping"`	Móstrase como `true` ou `false`. Indica a configuración de envío do produto ou da variante cando se fixo o pedido.
	`"order": { "line_items": [ { "taxable"`	Móstrase como `true` ou `false`. Indica como se configurou o produto ou a variante para cobrar impostos cando se fixo o pedido.
	`"order": { "line_items": [ { "variant_inventory_management"`	Móstrase como `shopify`, `amazon_marketplace_web`, `null` ou un valor de terceiros dependendo do servizo de preparación de pedidos configurado para rastrexar o inventario do produto. Un valor `null` significa que non se rastrexaba o produto cando se fixo o pedido.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Mostra canto inventario reserva aínda o sistema para poder completar o pedido. Non equivale ao inventario actual da variante.
	`"order": { "line_items": [ { "quantity"`	O número de produtos ou variantes comprados.
	`"order": { "line_items": [ { "tax_lines"`	Nos Estados Unidos, mostra valores estatais, do condado e municipais. Se non se mostran liñas de impostos, pero se cobraron impostos no pedido, significa que o imposto se cobrou sobre o custo de envío.
Cliente	`"customer": { "created_at"`	A hora e data na que se creou o cliente inicialmente.
Cliente	`"customer": { "updated_at"`	A hora e data máis recentes nas que se actualizou o perfil de cliente.

Metacampos en JSON

Os metacampos son un xeito flexible de achegar información personalizada adicional a un recurso de Shopify, como produtos ou coleccións. Algúns exemplos de datos almacenados usando metacampos inclúen especificacións de produtos, táboas de tamaños, documentos descargables, datas de lanzamento, imaxes ou números de pezas. Máis información sobre como usar os metacampos.

Podes engadir /metafields.json ao final do URL dunha páxina de recursos compatible para mostrar os metacampos asociados a ese recurso. Consulta a seguinte táboa para ver algúns exemplos de recursos e formatos de URL que se usan para mostrar a información dos metacampos mediante JSON.

Enumera algúns exemplos de recursos do panel de administración xunto co URL dun ficheiro de metacampos JSON de exemplo.
Tipo de recurso de exemplo	URL de exemplo
Colección	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Cliente	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Pedido	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Páxina	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produto	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variante	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Imaxe do produto	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Nota: os metacampos de imaxes dos produtos só se poden engadir a través da API. Substitúe os `{id}` e outros marcadores de posición do URL polos valores reais das túas consultas á API.
Tenda	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Para ver unha lista completa dos recursos que poden ter metacampos e dos tipos específicos de propiedades que se almacenan para cada tipo de recurso, consulta o recurso Metafield JSON na documentación para desenvolvedores de Shopify.

Eventos en JSON

Algúns recursos de Shopify xeran eventos cando se completan certas accións, como a creación dunha publicación do blog, a preparación dun pedido ou a adición dun produto.

Podes engadir /events.json ao final do URL dunha páxina de recursos compatible para mostrar os eventos asociados a ese recurso. Consulta a seguinte táboa para ver algúns exemplos de recursos e formatos de URL que se usan para mostrar a información dos eventos mediante JSON.

Enumera algúns exemplos de recursos do panel de administración xunto co URL dun ficheiro de eventos JSON de exemplo.
Tipo de recurso de exemplo	URL de exemplo
Pedido	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Este ficheiro enumera o `author` dos eventos para informar de que usuarios completaron certas accións, por exemplo, quen ou que publicou un produto.
Produto	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Este ficheiro enumera o `author` dos eventos para informar de que usuarios completaron certas accións, por exemplo, quen ou que marcou un pagamento como pagado.
Tenda	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Este formato de URL mostra os 250 eventos máis recentes que tiveron lugar na túa tenda. Os eventos poden incluír, entre outros, a creación ou actualización de produtos, a eliminación de páxinas e a actualización de variantes.

Para ver unha lista completa dos recursos que poden crear eventos e os eventos específicos que se crean para cada tipo de recurso, consulta o recurso Event JSON na documentación para desenvolvedores de Shopify.