products রিসোর্সটি ৬০টিরও বেশি প্রোডাক্ট অ্যাট্রিবিউটের উপর যথেষ্ট নমনীয়তা এবং নিয়ন্ত্রণের সুযোগ দেয়। বেশ কিছু ফিল্ড বাধ্যতামূলক, এবং গুগল শপিং-এ প্রদর্শনের জন্য অনুমোদিত হতে হলে সেগুলো অবশ্যই অন্তর্ভুক্ত করতে হবে। এছাড়াও বেশ কিছু ঐচ্ছিক ফিল্ড রয়েছে যা অবস্থান, পণ্যের ধরন, প্রোডাক্ট ভ্যারিয়েন্ট এবং প্রোডাক্ট বান্ডেলের মতো বিভিন্ন শর্তের উপর ভিত্তি করে বাধ্যতামূলক হয়ে উঠতে পারে। প্রোডাক্টের জন্য কনফিগার করা যায় এমন ৬০টিরও বেশি ঐচ্ছিক প্যারামিটার সম্পর্কে আরও বিস্তারিত জানতে, প্রোডাক্ট ডেটা স্পেসিফিকেশনস দেখুন।
products রিসোর্সটি আপনাকে একবারে একটি করে প্রোডাক্ট insert , get , update ও delete এবং মার্চেন্ট সেন্টার ডেটাবেসে থাকা সমস্ত প্রোডাক্টের list দেয়।
কোনো একটি গন্তব্যের জন্য একটি নির্দিষ্ট পণ্যের অনুমোদন বা অননুমোদনের অবস্থা যাচাই করতে productstatuses রিসোর্সটি ব্যবহার করা যেতে পারে। কোন কোন পণ্যে ডেটার গুণগত মানের সমস্যা থাকতে পারে এবং সেই সমস্যাগুলো কী হতে পারে, সে সম্পর্কে আরও বিস্তারিত জানতে প্রোডাক্ট স্ট্যাটাস গাইডটি দেখুন।
আমাদের API উদাহরণগুলিতে, আমরা তিনটি পণ্য ব্যবহার করি: দুটি গুগল টি-শার্ট এবং একটি গুগল ক্যাপ। একক পণ্য এবং পণ্যের ব্যাচ ইনসার্ট, গেট, আপডেট, লিস্ট এবং ডিলিট করার জন্য products রিসোর্স কল করতে আমরা নীচের টেবিলে দেখানো পণ্যের ডেটার একটি ন্যূনতম সেট ব্যবহার করি।
আমরা সুপারিশ করি যে শিপিং এবং ট্যাক্স সংক্রান্ত তথ্য প্রোডাক্ট লেভেলের পরিবর্তে অ্যাকাউন্ট লেভেলে কনফিগার করা হোক।
মার্কেটপ্লেসের একাধিক বিক্রেতা সাব-অ্যাকাউন্টের ক্ষেত্রে, সমস্ত পণ্যে অবশ্যই external_seller_id ফিল্ডটি অন্তর্ভুক্ত থাকতে হবে। আরও বিস্তারিত জানতে প্রোডাক্ট আইডি দেখুন।
 |  |  | |
| আইডি | অনলাইন:en:US:1111111111 | অনলাইন:en:US:222222222 | অনলাইন:en:US:3333333333 |
| অফার আইডি | ১১১১১১১১১১ | ২২২২২২২২২২ | ৩৩৩৩৩৩৩৩৩৩ |
| শিরোনাম | কালো গুগল টি-শার্ট | গুগল টি গ্রিন | গুগল টুইল ক্যাপ |
| বর্ণনা | কালো গুগল টি-শার্ট | ১০০% সুতির গুগল টি-শার্ট | ক্লাসিক গুগল ক্যাপ |
| আইটেম গ্রুপ আইডি | গুগল_টি | গুগল_টি | |
| লিঙ্ক | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
| অবস্থা | নতুন | নতুন | নতুন |
| দাম | ২১.৯৯ মার্কিন ডলার | ২১.৯৯ মার্কিন ডলার | ১০.৯৯ মার্কিন ডলার |
| প্রাপ্যতা | স্টকে আছে | স্টকে আছে | স্টকে আছে |
| ইমেজলিঙ্ক | https://shop.example.com/ | https://shop.example.com/ | https://shop.example.com/ |
| জিটিএন | ৯৫০৪০০০০৫৯৪২২ | ৯৫০৪০০০০৫৯৪৪৬ | ৯৫০৪০০০৫৯৪৫২ |
| এমপিএন | ০০৬৩৮এনআইসি | 00638ANG | ০০৬৩৮এবিসি |
| ব্র্যান্ড | গুগল | গুগল | গুগল |
| গুগল পণ্য বিভাগ | পোশাক ও আনুষঙ্গিক সামগ্রী > বস্ত্র | পোশাক ও আনুষঙ্গিক সামগ্রী > বস্ত্র | পোশাক ও আনুষঙ্গিক সামগ্রী > পোশাকের আনুষঙ্গিক সামগ্রী > টুপি |
| রঙ | কালো | সবুজ | কালো |
| আকার | এল | এম | এম |
| বয়স_গোষ্ঠী | প্রাপ্তবয়স্ক | প্রাপ্তবয়স্ক | প্রাপ্তবয়স্ক |
| লিঙ্গ | পুরুষ | পুরুষ | ইউনিসেক্স |
| অন্তর্ভুক্ত_গন্তব্য | কেনাকাটার কার্যকলাপ, কেনাকাটার বিজ্ঞাপন | কেনাকাটার কার্যকলাপ, কেনাকাটার বিজ্ঞাপন | কেনাকাটার কার্যকলাপ |
পণ্য.সন্নিবেশ
একটিমাত্র পণ্য যোগ করতে, আপনার মার্চেন্ট আইডি এবং একটি নমুনা JSON বডি উল্লেখ করে নিম্নলিখিত রিকোয়েস্ট URL ব্যবহার করুন। একটি ইনসার্ট নতুন পণ্যটি তৈরি করে। যদি কোনো নির্দিষ্ট পণ্যের জন্য channel , contentLanguage , offerId , এবং feedLabel অ্যাট্রিবিউটগুলিতে ভ্যালু বিদ্যমান থাকে, তাহলে এই মেথডটি সেই এন্ট্রিটি আপডেট করে এবং উক্ত পণ্যের জন্য পূর্ববর্তী API কলগুলির সমস্ত ডেটা প্রতিস্থাপন করে।
যেসব পণ্য ৭ দিনের বেশি সময় ধরে সব গন্তব্য থেকে বাদ থাকে, সেগুলো স্বয়ংক্রিয়ভাবে মুছে ফেলা হয়।
প্রদর্শিত উদাহরণটি উপলব্ধ পণ্য তালিকায় একটি নতুন 'ব্ল্যাক গুগল টি' যুক্ত করে।
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 কাস্টম অ্যাট্রিবিউটটি প্রোডাক্ট ডেফিনিশনে প্রতিটি কাস্টমার অর্ডারের জন্য একটি ক্রয় সীমা নির্ধারণ করে এবং এটি ফিড দ্বারাও সমর্থিত। এপিআই দ্বারা সম্পূর্ণরূপে সমর্থিত না হওয়া পর্যন্ত অ্যাট্রিবিউটটি বর্তমানে বিটা পর্যায়ে রয়েছে। একজন মার্চেন্ট যেকোনো অতিরিক্ত কাস্টম অ্যাট্রিবিউট যোগ করতে পারেন, কিন্তু এর ফলে এপিআই দ্বারা কোনো নির্দিষ্ট প্রক্রিয়াকরণ হয় না।
একটি সফল কল একটি 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 ব্যবহার করুন। নতুন যোগ করা কোনো পণ্য এই কলের মাধ্যমে উপলব্ধ হতে কয়েক মিনিট সময় লাগতে পারে।
নিম্নলিখিত HTTP অনুরোধ URL ও প্যারামিটার, আপনার মার্চেন্ট আইডি এবং যে পণ্যটি পেতে চান তার প্রোডাক্ট আইডি (REST ID ফরম্যাটে) ব্যবহার করুন:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
একটি সফল কল একটি HTTP 200 এবং রেসপন্স বডিতে 'product resource' ফেরত দেয়। 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"
]
}
পণ্য.আপডেট
একটিমাত্র প্রোডাক্ট আপডেট করতে, PATCH মেথডসহ নিম্নলিখিত রিকোয়েস্ট URL ব্যবহার করুন এবং আপনার মার্চেন্ট আইডি, প্রোডাক্ট আইডি, ও প্রোডাক্টটির জন্য যে ডেটা আপডেট করতে চান তা সম্বলিত একটি JSON বডি উল্লেখ করুন। products.insert মতো নয়, যার জন্য সমস্ত প্রযোজ্য ফিল্ড প্রদান করতে হয়, products.update জন্য আপনাকে শুধুমাত্র সেই ফিল্ডগুলো উল্লেখ করতে হবে যা আপনি পরিবর্তন করতে চান।
কোনো অ্যাট্রিবিউট যোগ বা পরিবর্তন করতে, JSON বডিতে নতুন মানসহ ফিল্ডটি নির্দিষ্ট করুন। দেখানো উদাহরণটি রিকোয়েস্ট বডিতে দেওয়া প্রোডাক্ট ডেটা দিয়ে একটি বিদ্যমান 'Black Google Tee'-এর 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 এর মাধ্যমে একটি বিদ্যমান 'Black Google Tee'-এর 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 ) ব্যবহার করুন:
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 এবং 'resources' কী-তে থাকা প্রোডাক্টগুলোর জন্য 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"
]
}
]
}