JSON کا استعمال کرتے ہوئے اپنے Shopify admin میں تفصیلی ڈیٹا تک رسائی
JSON، جو JavaScript Object Notation کا مخفف ہے، ڈیٹا کو سٹور اور منتقل کرنے کا ایک فارمیٹ ہے، جو اکثر تب استعمال ہوتا ہے جب سرور سے ویب پیج پر ڈیٹا بھیجا جاتا ہے۔ Shopify admin میں زیادہ تر ریسورس پیج پر، جیسے کہ آرڈر، پروڈکٹ، یا کسٹمر کے صفحات، آپ JSON کا استعمال کر کے مزید تفصیلی ڈیٹا تک رسائی حاصل کر سکتے ہیں۔
اگرچہ آپ کے لیے JSON کا استعمال کرتے ہوئے ایڈوانسڈ ڈیولپمنٹ ٹاسک انجام دینا ضروری نہیں ہے، لیکن اپنے Shopify admin میں کسی مخصوص ریسورس کے لیے JSON فائل تک رسائی حاصل کرنے کے قابل ہونا آپ کو مزید تفصیلی معلومات اکٹھا کرنے، یا خود مسائل کی ٹربل شوٹنگ کرنے یا تحقیقات کرنے میں مدد کر سکتا ہے۔ مثال کے طور پر، آپ کسی پروڈکٹ کی ویرینٹ ID تلاش کرنے کے لیے اس کی JSON فائل کا جائزہ لے سکتے ہیں، جو مخصوص ڈیٹا مائیگریشن ٹاسک یا تھیم کوڈ کی کسٹمائزیشن کے لیے درکار ہو سکتی ہے۔ ایک اور مثال کے طور پر، آپ اس ڈیٹا ویری ایبل کی تصدیق کرنے کے لیے کسی آرڈر کی JSON فائل سے رجوع کر سکتے ہیں جسے آپ Shopify Flow میں خودکار ورک فلو بناتے وقت استعمال کرنا چاہتے ہیں۔
JSON کو زیادہ تر ڈیویلپر استعمال کرتے ہیں، لیکن کوڈنگ کا محدود علم رکھنے والے صارفین بھی یہ سیکھ کر فائدہ اٹھا سکتے ہیں کہ اپنے Shopify admin میں JSON کی کچھ عام معلومات کو کیسے تلاش کیا جائے اور ان کی تشریح کیسے کی جائے۔
اس صفحے پر
JSON فائل کی دوبارہ فارمیٹنگ
خام JSON ڈیٹا نیسٹڈ ویری ایبل اور بریکٹ کی ایک لمبی ترتیب کے طور پر ظاہر ہوتا ہے، جسے پڑھنا انسانی صارف کے لیے مشکل ہوتا ہے۔
JSON فارمیٹنگ کو مزید قابل مطالعہ بنانے کے لیے، درج ذیل آپشن میں سے کسی پر بھی غور کریں:
- اپنے براؤزر میں ایک JSON ویور ایکسٹینشن انسٹال کریں۔
- زیادہ تر جدید ویب براؤزرز میں ڈیفالٹ کے طور پر دستیاب pretty-print کی خصوصیت استعمال کریں:

اپنے Shopify ایڈمن میں JSON فائل تک رسائی حاصل کرنا
Shopify ایڈمن آپ کے کاروبار کے تمام پہلوؤں کو منظم کرنے کا مرکزی مرکز ہے، اور اسے ڈیفالٹ کے طور پر صرف انتہائی مفید اور متعلقہ معلومات دکھانے کے لیے ڈیزائن کیا گیا ہے۔ جب بھی آپ کے ایڈمن میں کارروائیاں انجام دی جاتی ہیں تو جمع ہونے والی اضافی معلومات مختلف ریسورس صفحات کی .json فائل میں اسٹور ہوتی ہے۔ یہ اضافی تفصیلات آپ کو ڈیفالٹ کے طور پر نہیں دکھائی جاتیں کیونکہ معلومات کی اتنی زیادہ مقدار الجھن پیدا کر سکتی ہے، غیر مددگار ہو سکتی ہے، اور آپ کے ایڈمن کے استعمال کو مشکل بنا سکتی ہے۔
زیادہ تر کاروباری کاموں کے لیے، آپ اپنے سٹور کی معلومات تک رسائی حاصل کرنے اور ان کو سمجھنے کے لیے Shopify کے موجودہ ٹولز استعمال کر سکتے ہیں۔ تاہم، جب آپ کسی مسئلے کی ٹربل شوٹنگ کر رہے ہوں کہ کوئی واقعہ کیوں یا کب پیش آیا، تو بعض اوقات مخصوص ریسورسز، جیسے کہ پروڈکٹ یا آرڈر کے بارے میں مخصوص معلومات کا جائزہ لینا مفید ہو سکتا ہے۔
مثال: کسی آرڈر کی JSON فائل تک رسائی حاصل کریں
اس مثال میں، آپ اپنے Shopify ایڈمن میں کسی آرڈر کی JSON فائل تک رسائی حاصل کریں گے۔
اقدامات:
اپنے Shopify ایڈمن سے، آرڈر پر جائیں۔
آرڈر کی فہرست میں کسی بھی آرڈر پر کلک کریں۔
براؤزر کے ایڈریس بار میں، URL ایڈریس کے آخر میں
.jsonشامل کریں۔ یہ اس مثال سے ملتا جلتا ہوگا:
https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json- صفحے کو JSON فارمیٹنگ میں دوبارہ لوڈ کرنے کے لیے
Enterدبائیں۔ - اختیاری: اگر آپ کے براؤزر میں JSON ویور ایکسٹینشن انسٹال نہیں ہے، تو JSON فائل کو زیادہ صارف دوست بنانے کے لیے اپنے براؤزر میں Pretty-print سیٹنگ کو فعال کریں۔ JSON فائل کو دوبارہ فارمیٹ کرنے کے بارے میں مزید جانیں۔
آپ دیکھیں گے کہ آرڈر کے بارے میں بہت سی متوقع معلومات ظاہر ہوتی ہیں، جیسے کہ آرڈر سے وابستہ "currency" اور "line_items"، لیکن بہت سی دیگر تفصیلی معلومات بھی شامل ہوتی ہیں، جیسے کہ کسٹمر کے آرڈر دینے پر ان کے براؤزر سیشن سے "client_details"۔ اس قسم کی معلومات مجموعی سیشن ٹریکنگ اور مارکیٹنگ پلیٹ فارم کے اینالیٹکس کے لیے مفید ہے، لیکن آپ کے لیے آرڈر کی کارروائی اور تکمیل کے لیے ضروری نہیں ہے۔
JSON فائل میں مخصوص فیلڈز دکھانا
آپ JSON فائل کو صرف مخصوص فیلڈز دکھانے پر مجبور کر سکتے ہیں، جس سے معلومات کو سمجھنا آسان ہو سکتا ہے جب آپ جانتے ہوں کہ آپ کون سی مخصوص پراپرٹیز شامل کرنا چاہتے ہیں۔ براؤزر کے ایڈریس بار میں کسی بھی JSON فائل URL کے آخر میں، ?fields= شامل کریں اور پھر وہ پراپرٹی کے نام شامل کریں جنہیں آپ کسی بھی ترتیب میں، کوما سے الگ کر کے دکھانا چاہتے ہیں۔
مثال کے طور پر، آرڈر کی ID، کسٹمر کی معلومات، کل قیمت اور ٹیگ دکھانے کے لیے، 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 Developer Documentation سے رجوع کریں۔
| ریسورس | JSON پراپرٹی | تعریف |
|---|---|---|
| پروڈکٹ | | وہ تاریخ اور وقت جب پروڈکٹ ابتدائی طور پر بنائی گئی تھی۔ |
| وہ تاریخ اور وقت جب پروڈکٹ کا اسٹیٹس Active پر سیٹ کیا گیا تھا۔ | |
| حالیہ وقت اور تاریخ جب پروڈکٹ کو اپ ڈیٹ کیا گیا تھا۔ اس میں پروڈکٹ کی تفصیل، ٹائٹل، یا SEO معلومات میں تبدیلیاں شامل ہو سکتی ہیں، ساتھ ہی خودکار اپ ڈیٹس بھی شامل ہو سکتی ہیں جیسے پروڈکٹ خریدے جانے پر انوینٹری میں تبدیلیاں۔ | |
| ویریئنٹ | | وہ وقت اور تاریخ جب ویریئنٹ ابتدائی طور پر بنایا گیا تھا۔ یہ مجموعی پروڈکٹ کے بنائے جانے کی تاریخ اور وقت سے مختلف ہو سکتی ہے۔ |
| حالیہ وقت اور تاریخ جب ویریئنٹ کو اپ ڈیٹ کیا گیا تھا۔ یہ مجموعی پروڈکٹ کے آخری بار اپ ڈیٹ ہونے کی تاریخ اور وقت سے مختلف ہو سکتی ہے۔ | |
| موجودہ ڈیٹا بیس ویلیو اور کسٹمر کی خریداری کے لیے دستیاب ویلیو۔ اگر ویریئنٹ انوینٹری کو ٹریک نہیں کیا جا رہا ہے، یا اگر اسے اوور سیل پر سیٹ کیا گیا ہے تو یہ ایک منفی ویلیو ہو سکتی ہے۔ | |
| ویریئنٹ کی آخری updated_at تاریخ سے پہلے کی ڈیٹا بیس ویلیو۔ | |
| آرڈر | | true یا false کے طور پر ظاہر ہوتا ہے۔ یہ آرڈر دیتے وقت پروڈکٹ یا ویریئنٹ کی شپنگ سیٹنگز کی نشاندہی کرتا ہے۔ |
| true یا false کے طور پر ظاہر ہوتا ہے۔ یہ بتاتا ہے کہ آرڈر دیتے وقت پروڈکٹ یا ویریئنٹ کو ٹیکس وصول کرنے کے لیے کس طرح سیٹ کیا گیا تھا۔ | |
| shopify، amazon_marketplace_web، null، یا کسی تھرڈ پارٹی ویلیو کے طور پر ظاہر ہوتا ہے، جو اس بات پر منحصر ہے کہ پروڈکٹ کی انوینٹری کو ٹریک کرنے کے لیے کون سی تکمیلی سروس سیٹ ہے۔ null ویلیو کا مطلب ہے کہ آرڈر کے وقت پروڈکٹ کو ٹریک نہیں کیا جا رہا تھا۔ | |
| یہ ظاہر کرتا ہے کہ آرڈر کو مکمل کرنے کے لیے سسٹم کے ذریعے اب بھی کتنی انوینٹری مخصوص کی گئی ہے۔ یہ موجودہ ویریئنٹ انوینٹری کے برابر نہیں ہے۔ | |
| خریدی گئی پروڈکٹ یا ویریئنٹ کی تعداد۔ | |
| ریاستہائے متحدہ میں، یہ ریاستی، کاؤنٹی اور میونسپل ویلیوز کو ظاہر کرتا ہے۔ اگر کوئی ٹیکس لائن ظاہر نہیں ہوتی ہے، لیکن آرڈر پر ٹیکس وصول کیا گیا تھا، تو اس کا مطلب ہے کہ شپنگ کی لاگت پر ٹیکس وصول کیا گیا تھا۔ | |
| کسٹمر | | وہ تاریخ اور وقت جب کسٹمر ابتدائی طور پر بنایا گیا تھا۔ |
| حالیہ تاریخ اور وقت جب کسٹمر پروفائل کو اپ ڈیٹ کیا گیا تھا۔ |
JSON میں میٹا فیلڈز
میٹافیلڈ، Shopify ریسورس، جیسے کہ پروڈکٹ یا کلیکشن کے ساتھ اضافی کسٹم معلومات منسلک کرنے کا ایک لچکدار طریقہ ہے۔ میٹافیلڈ کا استعمال کر کے اسٹور کیے گئے ڈیٹا کی کچھ مثالوں میں پروڈکٹ کی خصوصیات، سائز چارٹ، ڈاؤن لوڈ کے قابل دستاویزات، ریلیز کی تاریخیں، تصاویر، یا پارٹ نمبر شامل ہیں۔ میٹافیلڈ کے استعمال کے بارے میں مزید جانیں۔
آپ اس ریسورس سے منسلک میٹافیلڈ کو ڈسپلے کرنے کے لیے تعاون یافتہ ریسورس پیج کے URL کے آخر میں /metafields.json شامل کر سکتے ہیں۔ 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 میں |
| سٹور | https://admin.shopify.com/store/{your-store-name}/metafields.json |
ایسے ریسورس کی مکمل فہرست کے لیے جن میں میٹافیلڈ ہو سکتا ہے، اور ہر ریسورس کی قسم کے لیے اسٹور کی جانے والی مخصوص قسم کی پراپرٹی کے لیے، Shopify ڈیویلپر ڈاکیومنٹیشن میں Metafield JSON ریسورس دیکھیں۔
JSON میں ایونٹ
جب کچھ مخصوص ایکشن مکمل ہو جاتے ہیں، جیسے کہ بلاگ پوسٹ بنانا، کسی آرڈر کی فلفلمنٹ، یا کسی پروڈکٹ کا اضافہ، تو کچھ Shopify ریسورس کے ذریعے ایونٹ تیار کیے جاتے ہیں۔
آپ اس ریسورس سے منسلک ایونٹ کو ڈسپلے کرنے کے لیے تعاون یافتہ ریسورس پیج کے URL کے آخر میں /events.json شامل کر سکتے ہیں۔ JSON کا استعمال کر کے ایونٹ کی معلومات کو ڈسپلے کرنے کے لیے استعمال ہونے والے ریسورس اور URL فارمیٹ کی کچھ مثالوں کے لیے درج ذیل ٹیبل دیکھیں۔
| مثالی ریسورس کی قسم | مثالی URL |
|---|---|
| آرڈر | https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.jsonیہ فائل ایونٹ کے |
| پروڈکٹ | https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.jsonیہ فائل ایونٹ کے |
| سٹور | https://admin.shopify.com/store/{your-store-name}/events.json?limit=250یہ URL فارمیٹ آپ کے سٹور پر ہونے والے 250 حالیہ ترین ایونٹ ڈسپلے کرتا ہے۔ ایونٹ میں پروڈکٹ بنانا یا اپ ڈیٹ کرنا، پیج حذف کرنا، اور ویرینٹ اپ ڈیٹ شامل ہو سکتے ہیں لیکن یہ ان تک محدود نہیں ہیں۔ |
ایسے ریسورس کی مکمل فہرست کے لیے جو ایونٹ بنا سکتے ہیں، اور ہر ریسورس کی قسم کے لیے بنائے جانے والے مخصوص ایونٹ کے لیے، Shopify ڈیویلپر ڈاکیومنٹیشن میں Event JSON ریسورس دیکھیں۔