Помощ
Влизане

Достъп до подробни данни във Вашия администраторски панел на Shopify с помощта на JSON

JSON, съкращение от JavaScript Object Notation, е формат за съхранение и пренасяне на данни, който често се използва при изпращане на данни от сървъри към уеб страници. В повечето страници с ресурси в администраторския панел на Shopify, като например страниците Поръчки, Продукти или Клиенти, можете да получите достъп до по-подробни данни с помощта на JSON.

Въпреки че не се изисква да извършвате сложни задачи за разработка с помощта на JSON, достъпът до JSON файла за даден ресурс в администраторския Ви панел на Shopify може да Ви помогне да съберете по-подробна информация или сами да отстранявате или проучвате проблеми. Например можете да прегледате JSON файла на продукт, за да намерите идентификатора на неговия вариант, което може да е необходимо за определени задачи по мигриране на данни или персонализиране на кода на темата. Като друг пример можете да проверите JSON файла на дадена поръчка, за да потвърдите променливата с данни, която искате да използвате при изграждането на автоматизиран работен процес в Shopify Flow.

JSON се използва най-често от разработчици, но дори потребители с ограничени познания по кодиране могат да се възползват, като се научат как да намират и интерпретират често срещана JSON информация в своя администраторски панел на Shopify.

На тази страница

Преформатиране на JSON файл

Необработените JSON данни се показват като дълга поредица от вложени променливи и скоби, което е трудно за четене от потребител.

За да направите JSON форматирането по-четливо, разгледайте някоя от следните опции:

  • Инсталирайте разширение за преглед на JSON във Вашия браузър.
  • Използвайте функционалността за „красив печат“ (pretty-print), която повечето съвременни уеб браузъри имат по подразбиране:

Скрийншот на JSON файл на продукт с показана примерна информация за продукта. Настройката в квадратчето за отметка „красив печат“ е активна и маркирана в горния ляв ъгъл на страницата.

Достъп до JSON файлове във Вашия администраторски панел на Shopify

Администраторският панел на Shopify е централният хъб за управление на всички аспекти на Вашия бизнес и е проектиран по подразбиране да показва само най-полезната и подходяща информация. Допълнителната информация, която се събира при всяко извършване на действия във Вашия администраторски панел, се съхранява в .json файловете на различни страници с ресурси. Тези допълнителни подробности не Ви се показват по подразбиране, тъй като този обем информация би бил прекомерен и безполезен и би затруднил използването на Вашия администраторски панел.

За повечето бизнес задачи можете да използвате съществуващите инструменти на Shopify за достъп и интерпретиране на информацията за Вашия магазин. Понякога обаче може да е полезно да прегледате конкретната информация за определени ресурси, като продукти или поръчки, когато отстранявате неизправности, за да разберете защо или кога се е случило нещо.

Пример: Достъп до JSON файла на поръчка

В този пример ще получите достъп до JSON файла на поръчка във Вашия администраторски панел на Shopify.

Стъпки:

  1. От Вашия администраторски панел на Shopify отидете на Поръчки.

  2. Кликнете върху която и да е поръчка в списъка „Поръчки“.

  3. В адресната лента на браузъра добавете .json в края на URL адреса. Той ще бъде подобен на този пример:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. Натиснете Enter, за да презаредите страницата в JSON формат.
  2. По избор: Ако нямате инсталирано разширение за преглед на JSON в браузъра си, активирайте настройката Pretty-print, за да направите JSON файла по-лесен за четене. Научете повече за преформатирането на JSON файл.

Ще забележите, че се показва много очаквана информация за поръчката, като например „currency“ и „line_items“, свързани с нея, но е включена и много друга подробна информация, като „client_details“ от сесията на браузъра на клиента, когато е направил поръчката. Този вид информация е полезна за цялостно проследяване на сесиите и за анализ на маркетингови платформи, но не е необходима, за да обработите и изпълните поръчката.

Показване на конкретни полета в JSON файл

Можете да накарате JSON файловете да показват само конкретни полета, което може да улесни интерпретирането на информацията, когато знаете конкретните свойства, които искате да включите. В края на всеки URL на JSON файл в адресната лента на браузъра добавете ?fields= и след това включете имената на свойствата, които искате да се показват, в произволен ред, разделени със запетая.

Например, за да се покажат идентификаторът на поръчката, информацията за клиента, общата цена и таговете, добавете ?fields=id,customer,total_price,tags в края на URL адреса на JSON файла, както в следния пример:

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

Използване на други JSON ресурси

Можете да използвате следните JSON ресурси, за да покажете конкретна информация във Вашия администраторски панел на Shopify:

https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • Транзакции: Добавете /transactions.json в края на URL адреса на страницата на дадена поръчка, за да се покаже само информацията за транзакциите по нея. Научете повече за ресурса „Транзакции“.
  • Обработки и доставки: Добавете /fulfillments.json в края на URL адреса на страницата на дадена поръчка, за да се покаже само информацията за обработката и доставката ѝ. Научете повече за ресурса „Обработка и доставка“.
  • Незавършени процеси на поръчка: Добавете .json в края на URL адреса на незавършен процес на поръчка, за да се покаже подробна информация за него. Научете повече за ресурса „Незавършен процес на поръчка“.

Често срещани JSON свойства за отстраняване на неизправности

В следващата таблица са изброени JSON свойства, към които може да се обърнете за помощ при отстраняване на неизправности с различни типове ресурси. Например, ако искате да потвърдите кога е публикуван даден продукт, тогава можете да прегледате JSON файла на продукта за свойството published_at, което показва датата и часа във формат ISO 8601.

Тази таблица не включва всички възможни JSON ресурси или свойства, съхранявани в администраторския панел на Shopify, така че направете справка с документацията за разработчици на Shopify за дефиниции на ресурси или свойства, които не са включени тук.

Изброява някои примерни администраторски ресурси и често срещани свойства, свързани с тях, включително дефиниции за това как могат да се използват при отстраняване на неизправности.
РесурсJSON свойствоДефиниция
Продукт
"product": {
  "created_at"
Времето и датата, на които продуктът е бил създаден първоначално.
"product": {
  "published_at"
Времето и датата, на които статусът на продукта е зададен като Активен.
"product": {
  "updated_at"
Последното време и дата, на които продуктът е бил актуализиран. Това може да включва промени в описанието на продукта, заглавието или SEO информацията, както и автоматични актуализации като промени в наличността, когато даден продукт бъде закупен.
Вариант
"product": {
  "variants": [
    {
    "created_at"
Времето и датата, на които вариантът е бил създаден първоначално. Те могат да се различават от датата и часа, на които е създаден целият продукт.
"product": {
  "variants": [
    {
    "updated_at"
Последното време и дата, на които вариантът е бил актуализиран. Те могат да се различават от датата и часа, на които целият продукт е бил актуализиран за последен път.
"product": {
  "variants": [
    {
    "inventory_quantity"
Текущата стойност в базата данни и това, което е достъпно за клиентите за покупка. Това може да е отрицателна стойност, ако наличността на варианта не се проследява или ако е настроен за продаване над наличността.
"product": {
  "variants": [
    {
    "old_inventory_quantity"
Стойността в базата данни преди последната дата на updated_at на варианта.
Поръчка
"order": {
   "line_items": [
    {
    "requires_shipping"
Показва се като true или false. Това показва настройките за доставка на продукта или варианта към момента на извършване на поръчката.
"order": {
   "line_items": [
    {
    "taxable"
Показва се като true или false. Това показва как продуктът или вариантът е бил настроен да начислява данъци към момента на извършване на поръчката.
"order": {
   "line_items": [
    {
    "variant_inventory_management"
Показва се като shopify, amazon_marketplace_web, null или стойност от трета страна в зависимост от това кой fulfillment service е настроен да проследява наличността на продукта. Стойност null означава, че продуктът не е бил проследяван към момента на поръчката.
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
Показва колко наличност все още е запазена от системата, за да бъде завършена поръчката. Това не е равно на текущата наличност на варианта.
"order": {
   "line_items": [
    {
    "quantity"
Броят на закупените продукти или варианти.
"order": {
   "line_items": [
    {
    "tax_lines"
В Съединените щати това показва стойности за щат, окръг и община. Ако не се показват редове за данъци, но е начислен данък върху поръчката, това означава, че данъкът е начислен върху разходите за доставка.
Клиент
"customer": {
  "created_at"
Времето и датата, на които клиентът е бил създаден първоначално.
"customer": {
  "updated_at"
Последното време и дата, на които профилът на клиента е бил актуализиран.

Метаполета в JSON

Метаполетата са гъвкав начин за прикачване на допълнителна персонализирана информация към ресурс на Shopify, като например продукти или колекции. Някои примери за данни, съхранявани с помощта на метаполета, включват продуктови спецификации, таблици с размери, документи за изтегляне, дати на издаване, изображения или номера на части. Научете повече за използването на метаполета.

Можете да добавите /metafields.json в края на URL адреса на страница на поддържан ресурс, за да се покажат метаполетата, свързани с този ресурс. Вижте следната таблица за някои примери на ресурси и URL формати, които да използвате за показване на информация за метаполета с помощта на JSON.

Списък с някои примерни администраторски ресурси заедно с примерен URL адрес на JSON файл с метаполета.
Примерен тип ресурсПримерен URL
Интелигентна колекцияhttps://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json
Клиентhttps://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json
Поръчкаhttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json
Страницаhttps://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json
Продуктhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json
Вариантhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json
Изображение на продуктаhttps://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image

Забележка: Метаполетата за изображения на продукти могат да се добавят само чрез API. Заменете {id} и другите заместващи текстове в URL адреса с действителните стойности от Вашите API заявки.


Магазинhttps://admin.shopify.com/store/{your-store-name}/metafields.json

За пълен списък на ресурсите, които могат да имат метаполета, и специфичните типове свойства, които се съхраняват за всеки тип ресурс, направете справка с JSON ресурса за метаполета в документацията за разработчици на Shopify.

Събития в JSON

Събитията се генерират от някои ресурси на Shopify, когато се изпълнят определени действия, като например създаването на публикация в блога, обработката и доставката на поръчка или добавянето на продукт.

Можете да добавите /events.json в края на URL адреса на страница на поддържан ресурс, за да се покажат събитията, свързани с този ресурс. Вижте следната таблица за някои примери на ресурси и URL формати, които да използвате за показване на информация за събития с помощта на JSON.

Списък с някои примерни администраторски ресурси заедно с примерен URL адрес на JSON файл със събития.
Примерен тип ресурсПримерен URL
Поръчкаhttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

Този файл изброява author на събитията, като Ви информира кои потребители са извършили определени действия, като например кой или какво е публикувало даден продукт.


Продуктhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

Този файл изброява author на събитията, като Ви информира кои потребители са извършили определени действия, като например кой или какво е маркирало дадено плащане като платено.


Магазинhttps://admin.shopify.com/store/{your-store-name}/events.json?limit=250

Този URL формат показва 250-те най-скорошни събития, които са се случили във Вашия магазин. Събитията могат да включват, но не се ограничават до създаване или актуализиране на продукти, изтриване на страници и актуализации на варианти.


За пълен списък на ресурсите, които могат да създават събития, и специфичните събития, които се създават за всеки тип ресурс, направете справка с JSON ресурса за събития в документацията за разработчици на Shopify.