সাহায্য
লগ ইন করুন

JSON ব্যবহার করে আপনার Shopify অ্যাডমিনে বিস্তারিত ডেটা অ্যাক্সেস করা

JSON, যার পূর্ণরূপ হলো JavaScript Object Notation, এটি ডেটা স্টোর ও ট্রান্সপোর্ট করার একটি ফর্ম্যাট, যা সাধারণত সার্ভার থেকে ওয়েবপেজে ডেটা পাঠানোর সময় ব্যবহৃত হয়। Shopify অ্যাডমিনের বেশিরভাগ রিসোর্স পেজে, যেমন অর্ডার, পণ্য বা গ্রাহক পেজগুলোতে, আপনি JSON ব্যবহার করে আরও বিস্তারিত ডেটা অ্যাক্সেস করতে পারেন।

যদিও আপনার JSON ব্যবহার করে অ্যাডভান্সড ডেভেলপমেন্টের কাজ করার প্রয়োজন নেই, তবুও আপনার Shopify অ্যাডমিনের নির্দিষ্ট কোনো রিসোর্সের JSON ফাইলে অ্যাক্সেস থাকলে তা আপনাকে আরও বিস্তারিত তথ্য সংগ্রহ করতে, অথবা নিজেই ট্রাবলশুটিং করতে বা সমস্যাগুলো নিয়ে তদন্ত করতে সাহায্য করতে পারে। উদাহরণস্বরূপ, কোনো পণ্যের ভ্যারিয়েন্ট ID খুঁজতে আপনি তার JSON ফাইলটি পর্যালোচনা করতে পারেন, যা নির্দিষ্ট কিছু ডেটা মাইগ্রেশনের কাজ বা থিমের কোড কাস্টমাইজেশনের জন্য প্রয়োজনীয় হতে পারে। আরেকটি উদাহরণ হিসেবে বলা যায়, Shopify Flow-তে কোনো স্বয়ংক্রিয় ওয়ার্কফ্লো তৈরি করার সময় আপনি যে ডেটা ভেরিয়েবলটি ব্যবহার করতে চান তা নিশ্চিত করার জন্য একটি অর্ডারের JSON ফাইল দেখতে পারেন।

JSON বেশিরভাগ ক্ষেত্রেই ডেভেলপাররা ব্যবহার করেন, তবে কোডিংয়ের সীমিত জ্ঞান আছে এমন ব্যবহারকারীরাও তাদের Shopify অ্যাডমিনে কীভাবে কিছু সাধারণ JSON তথ্য খুঁজে পেতে এবং তা বুঝতে হয়, সে বিষয়ে জেনে উপকৃত হতে পারেন।

এই পেজে

JSON ফাইল রিফর্ম্যাট করা

র (Raw) JSON ডেটা নেস্টেড ভেরিয়েবল এবং ব্র্যাকেটের একটি লম্বা ক্রম হিসেবে দেখায়, যা একজন সাধারণ মানুষের জন্য পড়া কঠিন।

JSON ফর্ম্যাটিংকে আরও পড়ার উপযোগী করতে, নিচের যেকোনো একটি বিকল্প বিবেচনা করুন:

  • আপনার ব্রাউজারে একটি JSON ভিউয়ার এক্সটেনশন ইনস্টল করুন।
  • বেশিরভাগ আধুনিক ওয়েব ব্রাউজারে বাই ডিফল্ট থাকা প্রিটি-প্রিন্ট সক্ষমতা ব্যবহার করুন:

Screenshot of a JSON product file with example product information displayed. 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 ফাইলটিকে আরও ব্যবহারকারী-বান্ধব করতে ব্রাউজারে প্রিটি-প্রিন্ট সেটিংটি অ্যাক্টিভ করুন। 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 ডেভেলপার ডকুমেন্টেশন দেখুন।

এতে কিছু উদাহরণস্বরূপ অ্যাডমিন রিসোর্স এবং সেগুলোর সাথে সম্পর্কিত সাধারণ প্রপার্টির তালিকা রয়েছে, সেইসাথে ট্রাবলশুটিংয়ের সময় সেগুলো কী কাজে ব্যবহার করা হতে পারে তার সংজ্ঞাও দেওয়া হয়েছে।
রিসোর্স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 ব্যবহার করে Events-এর তথ্য দেখানোর জন্য কিছু উদাহরণস্বরূপ রিসোর্স এবং ব্যবহারযোগ্য 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 রিসোর্স দেখুন।