मदद
लॉग इन करें

JSON का उपयोग करके अपने Shopify एडमिन में विस्तृत डेटा एक्सेस करना

JSON, जिसका पूरा नाम JavaScript Object Notation है, डेटा को स्टोर करने और भेजने का एक फ़ॉर्मेट है, जिसका इस्तेमाल अक्सर सर्वर से वेबपेज पर डेटा भेजे जाने पर किया जाता है। Shopify एडमिन के ज़्यादातर रिसोर्स पेज में, जैसे कि ऑर्डर, प्रोडक्ट या ग्राहक पेज पर, आप JSON का उपयोग करके ज़्यादा विस्तृत डेटा एक्सेस कर सकते हैं।

हालांकि, आपको JSON का उपयोग करके उन्नत डेवलपमेंट टास्क करने की ज़रूरत नहीं है, लेकिन अपने Shopify एडमिन में किसी खास रिसोर्स के लिए JSON फ़ाइल को एक्सेस कर पाने से आपको ज़्यादा विस्तृत जानकारी इकट्ठा करने या समस्याओं का खुद निवारण करने या जांच करने में मदद मिल सकती है। उदाहरण के लिए, आप प्रोडक्ट की प्रकार ID खोजने के लिए उसकी JSON फ़ाइल की समीक्षा कर सकते हैं, जिसकी ज़रूरत कुछ डेटा माइग्रेशन टास्क या थीम कोड अनुकूलन के लिए हो सकती है। एक और उदाहरण के लिए, आप Shopify Flow में ऑटोमेटेड वर्कफ़्लो बनाते समय उपयोग किए जाने वाले डेटा वेरिएबल की पुष्टि करने के लिए किसी ऑर्डर की JSON फ़ाइल देख सकते हैं।

JSON का उपयोग अक्सर डेवलपर करते हैं, लेकिन सीमित कोडिंग ज्ञान वाले उपयोगकर्ता भी अपने Shopify एडमिन में कुछ सामान्य JSON जानकारी को खोजने और उसकी व्याख्या करने का तरीका सीखकर लाभ उठा सकते हैं।

इस पेज पर

JSON फ़ाइल को रीफ़ॉर्मैट करना

रॉ JSON डेटा, नेस्टेड वैरिएबल और ब्रैकेट के एक लंबे क्रम के रूप में दिखाई देता है, जिसे किसी इंसान के लिए पढ़ना मुश्किल होता है।

JSON फ़ॉर्मैटिंग को आसानी से पढ़ने लायक बनाने के लिए, नीचे दिए गए किसी भी विकल्प पर विचार करें:

  • अपने ब्राउज़र में JSON व्यूअर एक्सटेंशन इंस्टॉल करें।
  • ज़्यादातर आधुनिक वेब ब्राउज़र में डिफ़ॉल्ट रूप से उपलब्ध प्रीटी-प्रिंट क्षमता का उपयोग करें:

उदाहरण के तौर पर प्रोडक्ट की जानकारी के साथ JSON प्रोडक्ट फ़ाइल का स्क्रीनशॉट. पेज के ऊपरी-बाएं कोने पर

अपने Shopify एडमिन में JSON फ़ाइल एक्सेस करना

Shopify एडमिन आपके व्यवसाय के सभी पहलुओं को मैनेज करने का केंद्रीय हब है और इसे डिफ़ॉल्ट रूप से केवल सबसे उपयोगी और प्रासंगिक जानकारी दिखाने के लिए डिज़ाइन किया गया है। आपके एडमिन में जब भी कोई कार्रवाई की जाती है, तो इकट्ठा की गई अतिरिक्त जानकारी अलग-अलग रिसोर्स पेज की .json फ़ाइल में स्टोर हो जाती है। यह अतिरिक्त विवरण आपको डिफ़ॉल्ट रूप से नहीं दिखाया जाता है, क्योंकि इतनी सारी जानकारी बहुत ज़्यादा और अनुपयोगी होगी और इससे आपके एडमिन का उपयोग करना मुश्किल हो जाएगा।

ज़्यादातर व्यावसायिक कामों के लिए, आप अपने स्टोर की जानकारी को एक्सेस करने और उसकी व्याख्या करने के लिए Shopify के मौजूदा टूल का उपयोग कर सकते हैं। हालांकि, कोई चीज़ क्यों या कब हुई, इसकी समस्या हल करते समय कभी-कभी खास रिसोर्स, जैसे प्रोडक्ट या ऑर्डर के बारे में खास जानकारी की समीक्षा करना मददगार हो सकता है।

उदाहरण: किसी ऑर्डर की JSON फ़ाइल एक्सेस करें

इस उदाहरण में, आप अपने Shopify एडमिन में किसी ऑर्डर की JSON फ़ाइल एक्सेस करेंगे।

चरण:

  1. अपने Shopify एडमिन से, ऑर्डर पर जाएं।

  2. ऑर्डर सूची में किसी भी ऑर्डर पर क्लिक करें।

  3. ब्राउज़र के एड्रेस बार में, URL एड्रेस के आखिर में .json जोड़ें। यह इस उदाहरण के जैसा होगा:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. पेज को JSON फ़ॉर्मैटिंग में रीलोड करने के लिए Enter दबाएं।
  2. वैकल्पिक: अगर आपके ब्राउज़र में JSON व्यूअर एक्सटेंशन इंस्टॉल नहीं है, तो JSON फ़ाइल को ज़्यादा यूज़र-फ़्रेंडली बनाने के लिए अपने ब्राउज़र में Pretty-print सेटिंग को सक्रिय करें। JSON फ़ाइल को फिर से फ़ॉर्मेट करने के बारे में ज़्यादा जानें।

आप देखेंगे कि ऑर्डर के बारे में बहुत सारी अपेक्षित जानकारी दिखाई देती है, जैसे कि ऑर्डर से जुड़ी "currency" और "line_items", लेकिन बहुत सी अन्य विस्तृत जानकारी भी शामिल है, जैसे कि ग्राहक के ब्राउज़र सत्र से "client_details", जब उन्होंने ऑर्डर दिया था। इस तरह की जानकारी समग्र सत्र ट्रैकिंग और मार्केटिंग प्लेटफ़ॉर्म के आंकड़ों के लिए उपयोगी है, लेकिन आपके लिए ऑर्डर को प्रोसेस करने और भेजने के लिए यह ज़रूरी नहीं है।

JSON फ़ाइल में खास फ़ील्ड दिखाना

आप JSON फ़ाइल को केवल खास फ़ील्ड दिखाने के लिए फ़ोर्स कर सकते हैं, जिससे जानकारी की व्याख्या करना तब आसान हो सकता है जब आप जानते हैं कि आप कौन सी खास प्रॉपर्टी शामिल करना चाहते हैं। ब्राउज़र एड्रेस बार में किसी भी JSON फ़ाइल URL के आखिर में, ?fields= जोड़ें और फिर उन प्रॉपर्टी के नाम शामिल करें जिन्हें आप किसी भी क्रम में दिखाना चाहते हैं, कॉमा से अलग करके।

उदाहरण के लिए, किसी ऑर्डर की आईडी, ग्राहक की जानकारी, कुल कीमत और टैग दिखाने के लिए, JSON फ़ाइल URL के आखिर में ?fields=id,customer,total_price,tags जोड़ें, जैसा कि नीचे दिए गए उदाहरण में है:

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

दूसरे JSON रिसोर्स का उपयोग करना

आप अपने Shopify एडमिन में खास जानकारी दिखाने के लिए, नीचे दिए गए JSON रिसोर्स का उपयोग कर सकते हैं:

  • प्रोडक्ट की संख्या: प्रोडक्ट की कुल संख्या दिखाने के लिए प्रोडक्ट सूची URL के आखिर में /count.json जोड़ें। पूरा URL यह होना चाहिए:
https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • लेन-देन: सिर्फ़ ऑर्डर के लेन-देन की जानकारी दिखाने के लिए ऑर्डर पेज के URL के आखिर में /transactions.json जोड़ें। लेन-देन रिसोर्स के बारे में ज़्यादा जानें।
  • फ़ुलफ़िलमेंट: सिर्फ़ ऑर्डर के फ़ुलफ़िलमेंट की जानकारी दिखाने के लिए ऑर्डर पेज के URL के आखिर में /fulfillments.json जोड़ें। फ़ुलफ़िलमेंट रिसोर्स के बारे में ज़्यादा जानें।
  • अधूरी खरीद प्रक्रिया: अधूरी खरीद प्रक्रिया के बारे में विस्तृत जानकारी दिखाने के लिए अधूरी खरीद प्रक्रिया वाले URL के आखिर में .json जोड़ें। अधूरी खरीद प्रक्रिया रिसोर्स के बारे में ज़्यादा जानें।

समस्या हल करने के लिए सामान्य JSON प्रॉपर्टी

नीचे दी गई तालिका में JSON प्रॉपर्टी की सूची दी गई है, जिन्हें आप अलग-अलग रिसोर्स प्रकारों से जुड़ी समस्या को हल करने में मदद पाने के लिए देख सकते हैं। उदाहरण के लिए, अगर आप यह पुष्टि करना चाहते हैं कि कोई खास प्रोडक्ट कब प्रकाशित हुआ था, तो आप published_at प्रॉपर्टी के लिए प्रोडक्ट की JSON फ़ाइल की समीक्षा कर सकते हैं, जो ISO 8601 फ़ॉर्मैट में तारीख और समय दिखाती है।

इस तालिका में Shopify एडमिन में स्टोर किए गए हर संभव JSON रिसोर्स या प्रॉपर्टी शामिल नहीं है, इसलिए यहां शामिल नहीं किए गए किसी भी रिसोर्स या प्रॉपर्टी की परिभाषा के लिए 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 या थर्ड-पार्टी वैल्यू के रूप में दिखाई देता है कि प्रोडक्ट की इन्वेंटरी को ट्रैक करने के लिए कौन सी पूर्ति सेवा सेट की गई है। null वैल्यू का मतलब है कि ऑर्डर के समय प्रोडक्ट को ट्रैक नहीं किया जा रहा था।
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
यह दिखाता है कि ऑर्डर पूरा करने के लिए सिस्टम द्वारा अभी भी कितनी इन्वेंटरी आरक्षित है। यह मौजूदा प्रकार की इन्वेंटरी के बराबर नहीं है।
"order": {
   "line_items": [
    {
    "quantity"
खरीदे गए प्रोडक्ट या प्रकार की संख्या।
"order": {
   "line_items": [
    {
    "tax_lines"
संयुक्त राज्य अमेरिका में, यह राज्य, काउंटी और नगरपालिका की वैल्यू दिखाता है। अगर कोई टैक्स लाइन नहीं दिखती है, लेकिन ऑर्डर पर टैक्स लगाया गया था, तो इसका मतलब है कि टैक्स शिपिंग लागत पर लगाया गया था।
ग्राहक
"customer": {
  "created_at"
वह समय और तारीख, जब ग्राहक पहली बार बनाया गया था।
"customer": {
  "updated_at"
सबसे हाल का समय और तारीख, जब ग्राहक प्रोफ़ाइल को अपडेट किया गया था।

JSON में मेटाफ़ील्ड

मेटाफ़ील्ड, किसी Shopify रिसोर्स, जैसे कि प्रोडक्ट या संग्रहण के साथ अतिरिक्त कस्टम जानकारी अटैच करने का एक सुविधाजनक तरीका है। मेटाफ़ील्ड का उपयोग करके स्टोर किए गए डेटा के कुछ उदाहरणों में प्रोडक्ट के विशेष विवरण, साइज़ चार्ट, डाउनलोड किए जा सकने वाले दस्तावेज़, रिलीज़ की तारीख, इमेज या पार्ट नंबर शामिल हैं। मेटाफ़ील्ड का उपयोग करने के बारे में ज़्यादा जानें।

आप उस रिसोर्स से जुड़े मेटाफ़ील्ड दिखाने के लिए किसी भी समर्थित रिसोर्स पेज के URL के आखिर में /metafields.json जोड़ सकते हैं। JSON का उपयोग करके मेटाफ़ील्ड जानकारी दिखाने के लिए उपयोग किए जाने वाले रिसोर्स और URL फ़ॉर्मेट के कुछ उदाहरणों के लिए नीचे दी गई तालिका देखें।

कुछ एडमिन रिसोर्स के उदाहरण और साथ में एक JSON मेटाफ़ील्ड फ़ाइल URL का उदाहरण।
उदाहरण रिसोर्स प्रकारउदाहरण 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 के ज़रिए ही जोड़े जा सकते हैं। URL में {id} और अन्य प्लेसहोल्डर को अपनी API क्वेरी के असल मान से बदलें।

स्टोरhttps://admin.shopify.com/store/{your-store-name}/metafields.json

उन रिसोर्स की पूरी सूची के लिए जिनमें मेटाफ़ील्ड हो सकते हैं और हर रिसोर्स प्रकार के लिए स्टोर की गई प्रॉपर्टी के खास प्रकारों के लिए, Shopify डेवलपर दस्तावेज़ीकरण में मेटाफ़ील्ड JSON रिसोर्स देखें।

JSON में इवेंट

जब कुछ एक्शन पूरे होते हैं, तो कुछ Shopify रिसोर्स इवेंट जनरेट करते हैं, जैसे कि ब्लॉग पोस्ट बनाना, किसी ऑर्डर का फ़ुलफ़िलमेंट या किसी प्रोडक्ट को जोड़ना।

आप उस रिसोर्स से जुड़े इवेंट दिखाने के लिए, किसी समर्थित रिसोर्स पेज के URL के आखिर में /events.json जोड़ सकते हैं। JSON का उपयोग करके इवेंट की जानकारी दिखाने के लिए उपयोग किए जाने वाले रिसोर्स और URL फ़ॉर्मेट के कुछ उदाहरणों के लिए नीचे दी गई तालिका देखें।

कुछ एडमिन रिसोर्स के उदाहरण और साथ में एक JSON इवेंट फ़ाइल URL का उदाहरण।
उदाहरण रिसोर्स प्रकारउदाहरण 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 सबसे हाल के इवेंट दिखाता है। इवेंट में प्रोडक्ट बनाना या उसे अपडेट करना, पेज को डिलीट करना और प्रकार को अपडेट करना शामिल हो सकता है, लेकिन यह इन्हीं तक सीमित नहीं है।

उन रिसोर्स की पूरी सूची के लिए जो इवेंट बना सकते हैं और हर रिसोर्स प्रकार के लिए बनाए गए खास इवेंट के लिए, Shopify डेवलपर दस्तावेज़ीकरण में इवेंट JSON रिसोर्स देखें।