পণ্য সম্পদ কল

products সংস্থানটি 60টিরও বেশি পণ্য বৈশিষ্ট্যের উপর প্রচুর নমনীয়তা এবং নিয়ন্ত্রণের অনুমতি দেয়৷ বেশ কয়েকটি ক্ষেত্র রয়েছে যা বাধ্যতামূলক, এবং Google শপিং-এ প্রদর্শনের জন্য অনুমোদিত হওয়ার জন্য অবশ্যই অন্তর্ভুক্ত করতে হবে৷ অবস্থান, পণ্যের ধরন, পণ্যের বৈকল্পিক এবং পণ্যের বান্ডেলের মতো বিভিন্ন অবস্থার উপর ভিত্তি করে অনেকগুলি ঐচ্ছিক ক্ষেত্র রয়েছে যা বাধ্যতামূলক হয়ে উঠতে পারে। পণ্যের জন্য কনফিগার করা যেতে পারে এমন 60+ ঐচ্ছিক পরামিতি সম্পর্কে আরও বিশদ বিবরণের জন্য, পণ্য ডেটা স্পেসিফিকেশন দেখুন।

products সংস্থান আপনাকে একবারে একটি পণ্য insert , get , update এবং delete দেয় এবং বণিক কেন্দ্রের ডাটাবেসে সমস্ত পণ্য list দেয়।

একটি গন্তব্যের জন্য একটি নির্দিষ্ট পণ্যের অনুমোদন বা অস্বীকৃতির স্থিতি পরীক্ষা করতে productstatuses সম্পদ ব্যবহার করা যেতে পারে। কোন পণ্যের ডেটা মানের সমস্যা থাকতে পারে এবং সেই সমস্যাগুলি কী হতে পারে সে সম্পর্কে আরও বিশদ বিবরণের জন্য পণ্যের অবস্থা নির্দেশিকা পড়ুন।

আমাদের API উদাহরণগুলিতে, আমরা তিনটি পণ্য ব্যবহার করি: দুটি Google টি-শার্ট এবং একটি Google ক্যাপ৷ আমরা স্বতন্ত্র পণ্য এবং পণ্যের ব্যাচ সন্নিবেশ, পেতে, আপডেট, তালিকা এবং মুছে ফেলার জন্য products সম্পদ কল করতে নীচের টেবিলে দেখানো পণ্য ডেটার একটি ন্যূনতম সেট ব্যবহার করি।

আমরা সুপারিশ করি যে শিপিং এবং ট্যাক্স তথ্য একটি পণ্য স্তরের পরিবর্তে অ্যাকাউন্ট স্তরে কনফিগার করা হবে৷

মার্কেটপ্লেসের মাল্টি-সেলার সাব-অ্যাকাউন্টের জন্য, সমস্ত পণ্যে অবশ্যই external_seller_id ক্ষেত্র অন্তর্ভুক্ত করতে হবে। আরো বিস্তারিত জানার জন্য পণ্য ID দেখুন.

আইডি অনলাইন:en:US:1111111111 অনলাইন:en:US:2222222222 অনলাইন:en:US:3333333333
অফার আইডি 1111111111 2222222222 ৩৩৩৩৩৩৩৩৩৩৩
শিরোনাম কালো গুগল টি গুগল টি গ্রিন গুগল টুইল ক্যাপ
বর্ণনা কালো গুগল টি 100% সুতি গুগল টি-শার্ট ক্লাসিক গুগল ক্যাপ
আইটেম গ্রুপ আইডি google_tee google_tee
লিঙ্ক http://my.site.com/blacktee http://my.site.com/greenee http://my.site.com/blackhat
অবস্থা নতুন নতুন নতুন
মূল্য 21.99 মার্কিন ডলার 21.99 মার্কিন ডলার 10.99 USD
প্রাপ্যতা স্টকে স্টকে স্টকে
ইমেজ লিঙ্ক https://shop.example.com/ store/20160512512/assets/items/images/ GGOEGXXX1100.jpg https://shop.example.com/ store/20160512512/assets/items/images/ GGOEGXXX0906.jpg https://shop.example.com/ store/20160512512/assets/items/images/ GGOEGHPB071610.jpg
gtin 9504000059422 9504000059446 9504000059452
mpn 00638NIC 00638ANG 00638ABC
ব্র্যান্ড গুগল গুগল গুগল
Google পণ্য বিভাগ পোশাক এবং আনুষাঙ্গিক > পোশাক পোশাক এবং আনুষাঙ্গিক > পোশাক পোশাক ও আনুষাঙ্গিক > পোশাকের আনুষাঙ্গিক > টুপি
রঙ কালো সবুজ কালো
আকার এল এম এম
বয়স_গোষ্ঠী প্রাপ্তবয়স্ক প্রাপ্তবয়স্ক প্রাপ্তবয়স্ক
লিঙ্গ পুরুষ পুরুষ ইউনিসেক্স
অন্তর্ভুক্ত_গন্তব্য শপিং অ্যাকশন, শপিং বিজ্ঞাপন শপিং অ্যাকশন, শপিং বিজ্ঞাপন শপিং অ্যাকশন

products.insert

একটি একক পণ্য সন্নিবেশ করতে, নিম্নলিখিত অনুরোধ URL ব্যবহার করুন, আপনার বণিক আইডি এবং একটি নমুনা JSON বডি উল্লেখ করুন৷ একটি সন্নিবেশ নতুন পণ্য তৈরি করে। কোনো প্রদত্ত পণ্যের জন্য channel , contentLanguage , offerId , এবং feedLabel এর জন্য মান বিদ্যমান থাকলে, এই পদ্ধতিটি প্রদত্ত পণ্যের জন্য পূর্ববর্তী API কলগুলির সমস্ত ডেটা এন্ট্রি আপডেট করে এবং প্রতিস্থাপন করে।

7 দিনের বেশি সমস্ত গন্তব্য থেকে বাদ দেওয়া পণ্যগুলি স্বয়ংক্রিয়ভাবে মুছে ফেলা হয়।

দেখানো উদাহরণটি উপলব্ধ পণ্যগুলিতে একটি নতুন "ব্ল্যাক গুগল টি" সন্নিবেশ করায়৷

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

products.insert এর জন্য নমুনা অনুরোধ বডি কল:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

JSON বডির মধ্যে একটি পণ্যের কাস্টম বৈশিষ্ট্যও থাকতে পারে। উদাহরণস্বরূপ, একজন গ্রাহক কতগুলি আইটেম অর্ডার করতে পারেন তা সীমিত করার জন্য আমরা একটি পণ্যের জন্য একটি purchase_quantity_limit সেট করতে পারি:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

মনে রাখবেন যে purchase_quantity_limit কাস্টম অ্যাট্রিবিউট পণ্যের সংজ্ঞায় গ্রাহকের অর্ডার প্রতি একটি ক্রয় সীমা সেট করে এবং এটি ফিড দ্বারা সমর্থিত। API দ্বারা সম্পূর্ণরূপে সমর্থিত না হওয়া পর্যন্ত বৈশিষ্ট্যটি বর্তমানে বিটাতে রয়েছে৷ যেকোন অতিরিক্ত কাস্টম অ্যাট্রিবিউট একজন বণিক দ্বারা যোগ করা যেতে পারে কিন্তু APIs দ্বারা কোনো নির্দিষ্ট প্রক্রিয়াকরণের ফলে হয় না।

একটি সফল কল একটি HTTP 200 কোড এবং একটি প্রতিক্রিয়া বডি প্রদান করে যেখানে শুধুমাত্র id , offerId , contentLanguage , feedLabel , এবং channel জনবহুল সহ সন্নিবেশিত পণ্য সংস্থান রয়েছে:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

Merchant Center ডাটাবেসে একটি নির্দিষ্ট পণ্যের তথ্য পেতে, products.get ব্যবহার করুন। এই কলের মাধ্যমে একটি নতুন সন্নিবেশিত পণ্য উপলব্ধ হতে কয়েক মিনিট সময় লাগতে পারে৷

আপনি যে পণ্যটি পেতে চান তার জন্য নিম্নলিখিত HTTP অনুরোধ URL এবং প্যারামিটার, আপনার বণিক আইডি এবং পণ্য আইডি (REST ID ফর্ম্যাট) ব্যবহার করুন:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

একটি সফল কল একটি HTTP 200 এবং প্রতিক্রিয়া বডিতে "পণ্য সম্পদ" প্রদান করে। online:en:US:1111111111 :

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

একটি একক পণ্য আপডেট করতে, প্যাচ পদ্ধতির সাথে নিম্নলিখিত অনুরোধের URLটি ব্যবহার করুন, আপনার বণিক আইডি, পণ্য আইডি এবং পণ্যটির জন্য আপনি যে ডেটা আপডেট করতে চান এমন একটি JSON বডি উল্লেখ করুন৷ products.insert এর বিপরীতে, যার জন্য সমস্ত প্রযোজ্য ক্ষেত্র সরবরাহ করা প্রয়োজন, products.update জন্য শুধুমাত্র আপনি যে ক্ষেত্রগুলি পরিবর্তন করতে চান তা নির্দিষ্ট করতে হবে৷

একটি বৈশিষ্ট্য যোগ বা পরিবর্তন করতে, JSON বডিতে নতুন মান সহ ক্ষেত্রটি নির্দিষ্ট করুন। দেখানো উদাহরণটি অনুরোধের অংশে প্রদত্ত পণ্য ডেটার সাথে বিদ্যমান "ব্ল্যাক গুগল টি"-এর title এবং description আপডেট করবে, অন্য সমস্ত ক্ষেত্রগুলিকে স্পর্শ না করে৷

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

products.update এর জন্য নমুনা অনুরোধ বডি কল:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

শুধুমাত্র শীর্ষ-স্তরের ক্ষেত্রগুলি একটি products.update অনুরোধের মাধ্যমে আপডেট করা যেতে পারে৷ আপনি যদি নেস্টেড ক্ষেত্রগুলি আপডেট করতে চান তবে আপনাকে অবশ্যই সম্পূর্ণ শীর্ষ-স্তরের বস্তু প্রদান করতে হবে।

দেখানো উদাহরণটি একটি বিদ্যমান পণ্যের নেস্টেড ক্ষেত্রগুলি সহ, অনুরোধের অংশে প্রদত্ত পণ্য ডেটা সহ শীর্ষ-স্তরের salePrice অবজেক্ট আপডেট করবে, অন্যান্য সমস্ত ক্ষেত্রগুলিকে অস্পর্শিত রেখে৷

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

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

দেখানো উদাহরণটি অনুরোধের অংশে প্রদত্ত সংশ্লিষ্ট পণ্য ডেটা সহ একটি বিদ্যমান "ব্ল্যাক গুগল টি"-এর description এবং availability আপডেট করবে, title সহ অন্যান্য সমস্ত ক্ষেত্রগুলিকে অস্পর্শিত রেখে।

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

products.update এর জন্য নমুনা অনুরোধ বডি কল:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

যদি updateMask তালিকায় একটি ক্ষেত্র সরবরাহ করা হয় তবে অনুরোধের মূল অংশে না থাকে তবে সেই ক্ষেত্রটি Product সংস্থান থেকে মুছে ফেলা হবে, যদি এটি বিদ্যমান থাকে।

দেখানো উদাহরণটি ক্ষেত্র salePrice এর মান অপসারণ করতে updateMask ব্যবহার করবে।

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

এটি মুছে ফেলার জন্য নমুনা অনুরোধের অংশে salePrice ক্ষেত্র অন্তর্ভুক্ত করা উচিত নয় । আপনি কোন শরীর বা একটি খালি শরীর প্রদান করতে পারেন. অন্যান্য ক্ষেত্রগুলি অপরিবর্তিত থাকবে যদি সেগুলি updateMask উপস্থিত না হয়।

একটি products.custombatch অনুরোধের মধ্যে updateMask ব্যবহার করতে, updateMask অনুরোধের মূল অংশে নির্দিষ্ট করা উচিত।

দেখানো উদাহরণটি ব্যাচ এন্ট্রিতে প্রদত্ত পণ্য ডেটা সহ products.custombatch ব্যবহার করে বিদ্যমান "ব্ল্যাক গুগল টি"-এর price এবং availability আপডেট করবে, title এবং description সহ অন্যান্য সমস্ত ক্ষেত্রগুলিকে অস্পৃশ্য রাখবে।

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

একটি একক পণ্য মুছে ফেলতে, আপনি যে পণ্যটি মুছতে চান তার জন্য নমুনা HTTP অনুরোধ URL, আপনার বণিক আইডি এবং পণ্য আইডি (REST ID ফর্ম্যাটে যেমন online:en:US:1111111111 ) সহ products.delete ব্যবহার করুন:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

একটি সফল প্রতিক্রিয়া কোন প্রতিক্রিয়া বডি ছাড়াই একটি HTTP Status 204 প্রদান করে।

পণ্য তালিকা

products.list বণিক কেন্দ্রের ডাটাবেসে একজন ব্যবসায়ীর থাকা সমস্ত পণ্যের তালিকা করে। নিম্নলিখিত অনুরোধ URL ব্যবহার করুন:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

একটি সফল কল "সম্পদ" কী-তে পণ্যগুলির জন্য একটি HTTP 200 এবং JSON ডেটা প্রদান করে৷

নিম্নলিখিত তিনটি উদাহরণ পণ্য ফেরত দেওয়া হয়:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}