বণিক পণ্য API এর ওভারভিউ

এই পৃষ্ঠাটি ব্যাখ্যা করে যে আপনি কীভাবে আপনার পণ্যগুলি প্রোগ্রামগতভাবে আপলোড এবং পরিচালনা করতে পারেন। বণিক পণ্য API ব্যবহার করে, আপনি একটি ডেটা উত্সে একটি পণ্য সন্নিবেশ বা আপডেট করতে পারেন, আপনার অ্যাকাউন্ট থেকে একটি পণ্য পুনরুদ্ধার করতে পারেন এবং একটি ডেটা উত্স থেকে একটি পণ্য মুছতে পারেন৷

বণিক পণ্য API-এ দুটি সংস্থান রয়েছে।

  • productInputs আপনার পণ্যের ইনপুট অংশ প্রতিনিধিত্ব করে।
  • products আপনার ইনপুট অংশগুলি থেকে তৈরি করা প্রক্রিয়াজাত পণ্যগুলির প্রতিনিধিত্ব করে৷

productInputs প্রাথমিক এবং সম্পূরক হতে পারে, এটি নির্ভর করে যে এটি একটি প্রাথমিক ডেটা উত্সে আপলোড করা হয়েছে বা একটি পরিপূরক ডেটা উত্সে ৷ প্রতিটি product একটি একক প্রাথমিক productInput এবং যেকোন সংখ্যক সম্পূরক productInputs থেকে তৈরি করা হবে।

আপনি একটি অনলাইন বা স্থানীয় স্টোর ক্যাটালগ তৈরি করতে বণিক পণ্য API ব্যবহার করতে পারেন, এটি এমন পণ্য যা একাধিক শপিং গন্তব্যে প্রদর্শিত হতে পারে। একবার আপনি আপনার Merchant Center অ্যাকাউন্ট তৈরি করার পরে, আপনার প্রথম ডেটা উত্স সেট আপ করার এবং API-এর মাধ্যমে পণ্যগুলির একটি প্রাথমিক সেট আপলোড করার জন্য প্রস্তুত হয়ে গেলে আপনি productInputs সংস্থানটি ব্যবহার করতে পারেন৷

যদিও বণিকদের একটি PrimaryProductDataSource নামে একটি ফাইল ব্যবহার করে পণ্য আপলোড করার ক্ষমতা রয়েছে, তবে মার্চেন্ট API ব্যবহার করে পণ্য তৈরি এবং মুছে ফেলার বিভিন্ন সুবিধা রয়েছে। এই সুবিধাগুলির মধ্যে রয়েছে দ্রুত প্রতিক্রিয়ার সময় এবং বড় ফাইলগুলি পরিচালনা করার প্রয়োজন ছাড়াই রিয়েল টাইমে পণ্য আপডেট করার ক্ষমতা। এপিআই কলের মাধ্যমে করা পণ্যের পরিবর্তন শপিং ডাটাবেসে দেখাতে কয়েক ঘণ্টা পর্যন্ত সময় লাগতে পারে।

পূর্বশর্ত

আপনার যদি কোনো ডেটা উৎস না থাকে, তাহলে Merchant DataSources API বা Merchant Center ব্যবহার করে একটি ডেটা উৎস তৈরি করুন

আপনার যদি ইতিমধ্যেই একটি ডেটা উত্স থাকে যা আপনি বণিক কেন্দ্র UI ব্যবহার করে বা API ব্যবহার করে তৈরি করেছেন, তাহলে আপনি আপনার পণ্যগুলি যোগ করতে বণিক পণ্য API ব্যবহার করতে পারেন৷ আপনি যদি পণ্য যোগ করার জন্য কেনাকাটার জন্য সামগ্রী API ব্যবহার করেন, তাহলে কীভাবে মার্চেন্ট পণ্য API দিয়ে শুরু করবেন তা বোঝার জন্য মাইগ্রেশন গাইড পড়ুন।

আপনি শপিং বিজ্ঞাপন এবং বিনামূল্যে তালিকা নীতি মেনে চলার জন্য দায়ী। শপিং বিজ্ঞাপনগুলি এই নীতিগুলি প্রয়োগ করার অধিকার সংরক্ষণ করে এবং যদি আমরা এই নীতিগুলি লঙ্ঘন করে এমন সামগ্রী বা আচরণ খুঁজে পাই তবে উপযুক্তভাবে প্রতিক্রিয়া জানাতে৷

সম্পদ

products সম্পদ আপনাকে শপিং ডাটাবেস থেকে পণ্য তথ্য পুনরুদ্ধার করতে দেয়।

productInput রিসোর্সটি কোনও পণ্যের জন্য আপনার জমা দেওয়া ইনপুট ডেটাকে উপস্থাপন করে। এটি এমন পদ্ধতিগুলিও প্রদান করে যা আপনাকে আপডেট করতে দেয়, বা পণ্যের তথ্য মুছে ফেলতে এক সময়ে, বা একাধিকবার ব্যাচ মোডে । একটি productInput রিসোর্সে অবশ্যই নিম্নলিখিত ক্ষেত্র থাকতে হবে:

  • channel : পণ্যের চ্যানেল
  • offerId : পণ্যের অনন্য শনাক্তকারী।
  • contentLanguage : পণ্যের জন্য দুই-অক্ষরের ISO 639-1 ভাষার কোড।
  • feedLabel : পণ্যের জন্য ফিড লেবেল।

আপনার অ্যাকাউন্টে একটি পণ্য ইনপুট আপলোড করুন

আপনার অ্যাকাউন্টে একটি পণ্য ইনপুট আপলোড করতে, accounts.productInputs.insert পদ্ধতি ব্যবহার করুন। আপনাকে অবশ্যই প্রাথমিক বা সম্পূরক ডেটা উৎসের অনন্য শনাক্তকারী পাস করতে হবে।

নিম্নলিখিত নমুনা অনুরোধটি দেখায় যে আপনি কীভাবে আপনার বণিক অ্যাকাউন্টে একটি পণ্য ইনপুট আপলোড করতে accounts.productInputs.insert পদ্ধতি ব্যবহার করতে পারেন৷ অনুরোধটি শিপিংয়ের মূল্য এবং অঞ্চল এবং উত্পাদনের তারিখ এবং আকারের মতো কাস্টম বৈশিষ্ট্যগুলি সেট করে।

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE}

{
  "name": "{PRODUCT_TITLE}",
  "versionNumber": {VERSION_NUMBER},
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "offerId": "{OFFER_ID}",
  "channel": "ONLINE",
  "attributes": {
    "availability": "in stock",
    "imageLink": "{IMAGE_LINK}",
    "link": "{PRODUCT_LINK}",
    "brand": "{BRAND_NAME}",
    "price": {
      "currencyCode": "{CURRENCY_CODE}",
      "amountMicros": {PRICE}
    },
    "color": "red",
    "productWeight": {
      "value": 320,
      "unit": "g"
    },
    "adult": false,
    "shipping": [
      {
        "country": "GB",
        "price": {
          "amountMicros": {SHIPPING_COST},
          "currencyCode": "{CURRENCY_CODE_SHIPPING}"
        },
        "postalCode": "{SHIPPING_POSTALCODE}",
        "service": "",
        "region": "{SHIPPING_REGION}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}"
      }
    ],
    "gender": "Female"
  },
  "customAttributes": [
    {
      "name": "size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

  • {ACCOUNT_ID} : আপনার Merchant Center অ্যাকাউন্টের অনন্য শনাক্তকারী।
  • {DATASOURCE} : ডেটা উৎসের অনন্য শনাক্তকারী। এটি accounts/ {ACCOUNT_ID} /dataSources/ {DATASOURCE_ID}
  • {PRODUCT_TITLE} : পণ্যটির নাম।
  • {VERSION_NUMBER} : পণ্যটির সংস্করণ নম্বর। ঐচ্ছিক।
  • {CONTENT_LANGUAGE} : পণ্যের জন্য দুই-অক্ষরের ISO 639-1 ভাষার কোড। প্রয়োজন।
  • {FEED_LABEL} : যে অঞ্চলে আপনি পণ্যটি বিক্রি করতে চান তার জন্য CLDR টেরিটরি কোড। যদি feedLabel জন্য প্রদত্ত মানটি বৈধ না হয়, তাহলে targetCountry ফিল্ডটি পপুলেট করা হয় না।
  • {OFFER_ID} : পণ্যের অনন্য শনাক্তকারী। প্রয়োজন।
  • {IMAGE_LINK} : আপনার ওয়েবসাইটে পণ্যের ছবির লিঙ্ক। ঐচ্ছিক।
  • {PRODUCT_LINK} : আপনার ওয়েবসাইটে পণ্যটির লিঙ্ক। ঐচ্ছিক।
  • {CURRENCY_CODE} : ISO 4217 অনুযায়ী তিন-অক্ষরের সংক্ষিপ্ত শব্দ ব্যবহার করে মূল্যের মুদ্রা। ঐচ্ছিক।
  • {PRICE} : পণ্যের মূল্য মাইক্রোতে একটি সংখ্যা হিসাবে উপস্থাপিত৷ ঐচ্ছিক।
  • {SHIPPING_COST} : নির্দিষ্ট শিপিং মূল্য একটি সংখ্যা হিসাবে উপস্থাপিত৷ ঐচ্ছিক।
  • {SHIPPING_POSTALCODE} : পোস্টাল কোডের ব্যাপ্তি যেখানে শিপিং রেট প্রযোজ্য। ঐচ্ছিক।
  • {MAX_HANDLING_TIME} : যখন অর্ডার প্রাপ্ত হয় এবং যখন এটি পাঠানো হয় তখন ব্যবসায়িক দিনের মধ্যে সর্বাধিক পরিচালনার সময়৷ ঐচ্ছিক।
  • {MIN_HANDLING_TIME} : যখন অর্ডার প্রাপ্ত হয় এবং যখন এটি পাঠানো হয় তখন ব্যবসায়িক দিনে সর্বনিম্ন হ্যান্ডলিং সময়। মান 0 এর মানে হল যে অর্ডারটি প্রাপ্তির দিনেই বিতরণ করা হয়। ঐচ্ছিক।
  • {MAX_TRANSIT_TIME} : যখন অর্ডারটি পাঠানো হয়েছে এবং কখন এটি বিতরণ করা হয়েছে তার মধ্যে ব্যবসায়িক দিনের মধ্যে সর্বাধিক ট্রানজিট সময়৷ ঐচ্ছিক।
  • {MIN_TRANSIT_TIME} : যখন অর্ডারটি পাঠানো হয়েছে এবং যখন এটি বিতরণ করা হয়েছে তখন ব্যবসায়িক দিনের মধ্যে সর্বনিম্ন ট্রানজিট সময়। মান 0 এর মানে হল যে অর্ডারটি পাঠানোর দিনেই বিতরণ করা হয়। ঐচ্ছিক।

অনুরোধটি সফলভাবে চালানো হলে, আপনি নিম্নলিখিত প্রতিক্রিয়া দেখতে পাবেন:

{
  "name": "{PRODUCT_NAME}",
  "product": "{PRODUCT_ID}",
  "channel": "ONLINE",
  "offerId": "{OFFER_ID}",
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "versionNumber": "{VERSION_NUMBER}",
  "attributes": {
    "link": "{PRODUCT_LINK}",
    "imageLink": "{IMAGE_LINK}",
    "adult": false,
    "availability": "in stock",
    "brand": "{BRAND_NAME}",
    "color": "red",
    "gender": "Female",
    "price": {
      "amountMicros": "{PRICE}",
      "currencyCode": "{CURRENCY_CODE}"
    },
    "shipping": [
      {
        "price": {
          "amountMicros": "{SHIPPING_COST}",
          "currencyCode": "{CURRENCY_CODE}"
        },
        "country": "{SHIPPING_COUNTRY}",
        "region": "{SHIPPING_REGION}",
        "postalCode": "{SHIPPING_POSTALCODE}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}"
      }
    ],
    "productWeight": {
      "value": 320,
      "unit": "g"
    }
  },
  "customAttributes": [
    {
      "name": "Size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

আপনার অ্যাকাউন্ট থেকে একটি প্রক্রিয়াজাত পণ্য পুনরুদ্ধার করুন

আপনার অ্যাকাউন্ট থেকে একটি প্রক্রিয়াজাত পণ্য পুনরুদ্ধার করতে, accounts.products.get পদ্ধতি ব্যবহার করুন। প্রক্রিয়াজাত পণ্য সন্নিবেশের পরে প্রদর্শিত হতে কয়েক মিনিট সময় লাগতে পারে।

আপনি accounts.productInputs.insert এর প্রতিক্রিয়ায় product ক্ষেত্র থেকে প্রক্রিয়াকৃত পণ্যের সংস্থানের নাম পেতে পারেন

আপনার অ্যাকাউন্ট থেকে একটি পণ্য ইনপুট মুছুন

আপনার অ্যাকাউন্ট থেকে একটি পণ্য ইনপুট মুছে ফেলতে, accounts.productInputs.delete পদ্ধতি ব্যবহার করুন। বণিক পণ্য API ব্যবহার করে একটি পণ্য মুছে ফেলার জন্য আপনাকে পণ্যটি যে প্রাথমিক বা পরিপূরক ডেটা উৎসের অনন্য শনাক্তকারীকে পাস করতে হবে।

আপনার অ্যাকাউন্ট থেকে পণ্য তালিকা

আপনার অ্যাকাউন্টে প্রক্রিয়াজাত পণ্য তালিকাভুক্ত করতে, accounts.products.list পদ্ধতি ব্যবহার করুন।