உதவி
உள்நுழை

JSON-ஐப் பயன்படுத்தி உங்கள் Shopify நிர்வாகியில் விரிவான தரவை அணுகுதல்

JSON என்பது JavaScript Object Notation என்பதன் சுருக்கமாகும். இது தரவைச் சேமிக்கவும் பரிமாற்றவும் பயன்படும் ஒரு வடிவமைப்பாகும், பெரும்பாலும் சேவையகங்களிலிருந்து இணையப்பக்கங்களுக்குத் தரவு அனுப்பப்படும்போது இது பயன்படுத்தப்படுகிறது. Shopify நிர்வாகியில் உள்ள ஆர்டர்கள், தயாரிப்புகள் அல்லது வாடிக்கையாளர்கள் பக்கங்கள் போன்ற பெரும்பாலான ஆதாரப் பக்கங்களில், JSON-ஐப் பயன்படுத்தி நீங்கள் இன்னும் விரிவான தரவை அணுக முடியும்.

JSON-ஐப் பயன்படுத்தி மேம்பட்ட மேம்பாட்டுப் பணிகளை நீங்கள் செய்ய வேண்டியதில்லை என்றாலும், உங்கள் Shopify நிர்வாகியில் உள்ள ஒரு குறிப்பிட்ட ஆதாரத்திற்கான JSON கோப்பை அணுக முடிந்தால், அது கூடுதல் விரிவான தகவல்களைச் சேகரிக்க அல்லது சிக்கல்களை நீங்களே தீர்க்கவும் ஆராயவும் உதவும். எடுத்துக்காட்டாக, சில தரவு இடமாற்றப் பணிகளுக்கு அல்லது தீம் குறியீடு தனிப்பயனாக்கங்களுக்குத் தேவைப்படக்கூடிய மாறுபாடு ID-யைக் கண்டறிய, ஒரு தயாரிப்பின் JSON கோப்பை நீங்கள் மதிப்பாய்வு செய்யலாம். மற்றொரு எடுத்துக்காட்டாக, Shopify Flow இல் தானியங்குப் பணிப்பாய்வை உருவாக்கும்போது, நீங்கள் பயன்படுத்த விரும்பும் தரவு மாறியை உறுதிப்படுத்த, ஒரு ஆர்டரின் JSON கோப்பைப் பார்க்கலாம்.

JSON பெரும்பாலும் டெவலப்பர்களாலேயே பயன்படுத்தப்படுகிறது, ஆனாலும் குறைந்த குறியீட்டு அறிவைக் கொண்ட பயனர்களும்கூடத் தங்கள் Shopify நிர்வாகியில் சில பொதுவான JSON தகவல்களை எப்படிக் கண்டறிவது மற்றும் விளக்குவது என்பதைக் கற்றுக்கொள்வதன் மூலம் பயனடையலாம்.

இப்பக்கத்தில்

JSON கோப்பை மறுவடிவமைத்தல்

மூல JSON தரவானது, நெஸ்ட் செய்யப்பட்ட மாறிகள் மற்றும் அடைப்புக்குறிகளின் நீண்ட வரிசையாகக் காட்டப்படும், இது ஒரு மனிதப் பயனருக்குப் படிப்பதற்குக் கடினமாக இருக்கும்.

JSON வடிவமைப்பு படிப்பதற்கு எளிதாக இருக்க, பின்வரும் விருப்பங்களில் ஏதேனும் ஒன்றைப் பயன்படுத்தலாம்:

  • உங்கள் உலாவியில் JSON பார்வையாளர் நீட்டிப்பை நிறுவவும்.
  • பெரும்பாலான நவீன இணைய உலாவிகளில் இயல்புநிலையாக இருக்கும் pretty-print திறனைப் பயன்படுத்தவும்:

எடுத்துக்காட்டுத் தயாரிப்புத் தகவல் காட்டப்படும் JSON தயாரிப்புக் கோப்பின் ஸ்கிரீன்ஷாட். The

உங்கள் 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= என்பதைச் சேர்த்து, அதன்பின் காற்புள்ளியால் பிரிக்கப்பட்டவாறு நீங்கள் காட்ட விரும்பும் பண்புப் பெயர்களை எந்த வரிசையிலும் சேர்க்கவும்.

எடுத்துக்காட்டாக, ஒரு ஆர்டரின் 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 பண்புகளைப் பின்வரும் அட்டவணை பட்டியலிடுகிறது. எடுத்துக்காட்டாக, ஒரு குறிப்பிட்ட தயாரிப்பு எப்போது வெளியிடப்பட்டது என்பதை நீங்கள் உறுதிப்படுத்த விரும்பினால், அந்தத் தயாரிப்பின் JSON கோப்பில் published_at பண்பை நீங்கள் மதிப்பாய்வு செய்யலாம், அது 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 டெவலப்பர் ஆவணங்களில் உள்ள Metafield JSON ஆதாரத்தைப் பார்க்கவும்.

JSON இல் Events

வலைப்பதிவு இடுகை உருவாக்குதல், ஆர்டர் நிறைவேற்றம், அல்லது ஒரு தயாரிப்பைச் சேர்த்தல் போன்ற குறிப்பிட்ட செயல்கள் நிறைவடையும்போது சில Shopify ஆதாரங்களால் Events உருவாக்கப்படும்.

ஆதரிக்கப்படும் ஆதாரப் பக்க URL இன் இறுதியில் /events.json என்பதைச் சேர்த்து, அந்த ஆதாரத்துடன் தொடர்புடைய Events-ஐக் காட்டலாம். JSON ஐப் பயன்படுத்தி Event தகவலைக் காட்டப் பயன்படும் ஆதாரங்கள், URL வடிவங்களின் சில எடுத்துக்காட்டுகளுக்குப் பின்வரும் அட்டவணையைப் பார்க்கவும்.

எடுத்துக்காட்டு JSON events கோப்பு URL உடன், சில எடுத்துக்காட்டு நிர்வாகி ஆதாரங்களைப் பட்டியலிடவும்.
எடுத்துக்காட்டு ஆதார வகைஎடுத்துக்காட்டு URL
ஆர்டர்https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

இந்தக் கோப்பு Events-இன் author ஐப் பட்டியலிடுகிறது, தயாரிப்பை யார் அல்லது எது வெளியிட்டது என்பது போன்ற குறிப்பிட்ட செயல்களை எந்தப் பயனர்கள் முடித்தார்கள் என்பதை உங்களுக்குத் தெரிவிக்கும்.

தயாரிப்புhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

இந்தக் கோப்பு Events-இன் author ஐப் பட்டியலிடுகிறது, யார் அல்லது எது பேமெண்ட்டைச் செலுத்தப்பட்டதாகக் குறித்தது என்பது போன்ற குறிப்பிட்ட செயல்களை எந்தப் பயனர்கள் முடித்தார்கள் என்பதை உங்களுக்குத் தெரிவிக்கும்.

ஸ்டோர்https://admin.shopify.com/store/{your-store-name}/events.json?limit=250

இந்த URL வடிவம் உங்கள் ஸ்டோரில் நடைபெற்ற சமீபத்திய 250 Events-ஐக் காட்டுகிறது. தயாரிப்பு உருவாக்குதல் அல்லது புதுப்பிப்புகள், பக்க நீக்கங்கள், மாறுபாடு புதுப்பிப்புகள் ஆகியவை Events-இல் அடங்கும், ஆனால் அவற்றுடன் மட்டும் இது வரையறுக்கப்படவில்லை.

Events-ஐ உருவாக்கக்கூடிய ஆதாரங்களின் முழுமையான பட்டியல், ஒவ்வொரு ஆதார வகைக்கும் உருவாக்கப்படும் குறிப்பிட்ட Events-க்கு, Shopify டெவலப்பர் ஆவணங்களில் உள்ள Event JSON ஆதாரத்தைப் பார்க்கவும்.