Merchant API আপনার প্রোডাক্ট ডেটা ম্যানেজ করার জন্য আরও শক্তিশালী এবং সহজ উপায়
নিয়ে এসেছে। প্রধান পরিবর্তন হল প্রোডাক্ট ডেটাকে দুটি আলাদা রিসোর্সে ভাগ করা:
আপনার ডেটা জমা দেওয়ার জন্য ProductInput এবং প্রোডাক্ট স্ট্যাটাস ও সমস্যা সহ
চূড়ান্ত, প্রসেস করা ভার্সন দেখার জন্য Product। এই নতুন স্ট্রাকচার
আরও অনুমানযোগ্য এবং স্বচ্ছ অভিজ্ঞতা প্রদান করে।
এই নির্দেশিকা আপনাকে মূল পার্থক্যগুলি বুঝতে সাহায্য করে যাতে আপনি শপিংয়ের জন্য কন্টেন্ট API থেকে আপনার ইন্টিগ্রেশন মাইগ্রেট করতে পারেন। নতুন ফিচার ব্যবহার করার ব্যাপারে বিস্তারিত নির্দেশিকা পেতে, আপনার প্রোডাক্ট ম্যানেজ করুন দেখুন।
প্রধান পার্থক্য
Content API for Shopping-এর তুলনায় Merchant API-তে প্রোডাক্ট ম্যানেজ করার পদ্ধতিতে সবচেয়ে গুরুত্বপূর্ণ পরিবর্তনগুলি এখানে দেওয়া হল:
ইনপুট ও প্রসেস করা ডেটার জন্য ডেডিকেটেড রিসোর্স: Merchant API প্রোডাক্ট ম্যানেজমেন্টকে দুটি রিসোর্সে ভাগ করে। আপনার প্রোডাক্ট ডেটা যোগ, আপডেট ও মুছে দিতে, আপনি
ProductInputরিসোর্স ব্যবহার করতে পারবেন। Google আপনার ইনপুট প্রসেস করার পরে, নিয়ম প্রয়োগ করে এবং অতিরিক্ত সোর্স থেকে ডেটা একত্রিত করে, আপনি শুধুমাত্র-পড়ার-জন্যProductরিসোর্স ব্যবহার করে চূড়ান্ত প্রোডাক্ট দেখতে পারবেন।প্রোডাক্টের নামের জন্য এনকোডিং: আপনি
ProductInput.nameএবংProduct.nameউভয় ফিল্ডের জন্য আনপ্যাডেড base64url (RFC 4648 বিভাগ 5) এনকোডিং ব্যবহার করতে পারেন। প্রোডাক্টের নামে Merchant API বা URL-এর জন্য সংরক্ষিত অক্ষর থাকলে, এনকোডিং করা বাধ্যতামূলক। যেমন, প্রোডাক্টের নামে নিম্নলিখিত অক্ষরগুলির মধ্যে কোনও একটি থাকলে, আপনাকে অবশ্যই প্রোডাক্টের নাম এনকোড করতে হবে:% . + / : ~ , ( * ! ) & ? = @ # $ইন্টিগ্রেটেড প্রোডাক্ট স্ট্যাটাস:
productstatusesপরিষেবা সরিয়ে দেওয়া হয়েছে। প্রোডাক্ট যাচাইকরণ সংক্রান্ত সমস্যা এবং ডেস্টিনেশন স্ট্যাটাস এখন সরাসরিProductরিসোর্সেরproductStatusফিল্ডে অন্তর্ভুক্ত করা হয়েছে, যা ডেটা খুঁজে পাওয়ার প্রসেসকে সহজ করে তোলে।প্রোডাক্টের অনুমানযোগ্য আপডেট: নতুন
productInputs.patchপদ্ধতিটি সরাসরি একটি নির্দিষ্ট প্রোডাক্ট ইনপুট পরিবর্তন করে। এটি Content API for Shopping-এর তুলনায় অনেক উন্নত, যেখানে অন্যান্য ফিড আপলোডের মাধ্যমে আপডেটগুলি অপ্রত্যাশিতভাবে ওভাররাইট করা হতে পারে। Merchant API-তে, কোনও আপডেট সেই নির্দিষ্ট প্রোডাক্ট ইনপুট আবার আপডেট বা মুছে না ফেলা পর্যন্ত থেকে যায়। প্রোডাক্ট আপডেটProductInputরিসোর্সে প্রয়োগ করা হয়েছে, প্রসেস করাProductরিসোর্সে নয়।আরও ভালোভাবে ডেটা ম্যানেজ করার জন্য আপনার ডেটা সোর্স বেছে নিন: সব
productInputsরাইট অপারেশনের জন্য এখন একটিdataSourceকোয়েরি প্যারামিটার প্রয়োজন, যার ফলে আপনি কোন ডেটা সোর্স পরিবর্তন করছেন তা স্পষ্টভাবে বোঝা যায়। আপনার কাছে ডেটা প্রদানকারী একাধিক সোর্স থাকলে, এটি বিশেষভাবে উপযোগী।নতুন রিসোর্স শনাক্তকারী: প্রোডাক্ট এখন
idফিল্ডের পরিবর্তে RESTful রিসোর্সnameদ্বারা শনাক্ত করা হয়। ফর্ম্যাট হলaccounts/{account}/products/{product}।কোনও কাস্টম ব্যাচ নেই:
custombatchপদ্ধতি আর উপলভ্য নেই। একটি HTTP কলে একাধিক অনুরোধ পাঠাতে আপনি অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করতে পারেন।
মাইগ্রেশনের সময় ডেটা সোর্স সংক্রান্ত নির্দেশিকা
আপনার ডেটা সোর্স মাইগ্রেট করার আগে, আমরা আপনাকে ডেটা সোর্স স্ট্র্যাটেজি বেছে নিতে জোরালো সাজেশন দিই।
সহজে মাইগ্রেশন নিশ্চিত করতে এবং অফার চুরি হওয়ার মতো সমস্যা প্রতিরোধ করতে, এইসব সাজেশন অনুসরণ করুন:
আপনার ডেটাবেস ব্যাকফিল করুন: প্রতিটি প্রোডাক্ট অপারেশনের আগে
dataSources.listকল করার পরিবর্তে, আমরা আপনাকে আপনার লোকাল ডেটাবেসের এককালীন ব্যাকফিল করার জন্য জোরালো সাজেশন দিচ্ছি। প্রতিটি প্রোডাক্ট রেকর্ডে একটিdataSourceনামের ফিল্ড যোগ করুন যাতে আপনি সরাসরি আপনার অনুরোধে সঠিক শনাক্তকারী প্রদান করতে পারেন।যেকোনও লেবেল ও ভাষার জন্য ডেটা সোর্স একত্রিত ও ব্যবহার করা: মার্চেন্ট API-এর মাধ্যমে লেবেল ও ভাষা উল্লেখ না করেই ডেটা সোর্স তৈরি করা সম্ভব এবং তাই যেকোনও ডেটা সোর্স লেবেল ও ভাষার সাথে প্রোডাক্ট যোগ করার অনুমতি দেয়। যেকোনও লেবেল ও ভাষার জন্য একটি ডেটা সোর্স ব্যবহার করার কথা বিবেচনা করুন।
আপনার প্রোডাক্ট সুরক্ষিত রাখুন: আপনি ডেটা সোর্স সংক্রান্ত নিয়ম ব্যবহার করলে,
products.getকল করুন যাতে কোনও প্রোডাক্ট আপডেট বা মুছে দেওয়ার আগে তার সাথে যুক্ত সঠিকdataSourceখুঁজে পেতে পারেন। এটি নিশ্চিত করে যে আপনি সঠিক সোর্স পরিবর্তন করছেন এবং অফার চুরি হওয়া আটকায়।
অনুরোধ
এই বিভাগে Content API for Shopping এবং Merchant API-এর জন্য অনুরোধের ফর্ম্যাট তুলনা করা হয়েছে।
| অনুরোধের বিবরণ | Content API for Shopping | Merchant API |
|---|---|---|
| প্রোডাক্ট পান | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} |
GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product} |
| প্রোডাক্টের তালিকা তৈরি করো | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products |
GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products |
| প্রোডাক্ট যোগ করুন | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products |
POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert |
| প্রোডাক্ট আপডেট করুন | PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} |
PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput} |
| প্রোডাক্ট মুছে দেওয়া | DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} |
DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput} |
| প্রোডাক্টের স্ট্যাটাস পান | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId} |
GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product} |
| প্রোডাক্টের স্ট্যাটাসের তালিকা তৈরি করো | GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products |
| একাধিক অনুরোধ ব্যাচ করা | POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch |
অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন |
আইডেন্টিফায়ার
Merchant API-তে প্রোডাক্ট শনাক্তকারীর ফর্ম্যাট পরিবর্তন করে স্ট্যান্ডার্ড REST রিসোর্স নাম করা হয়েছে।
| শনাক্তকারীর বিবরণ | Content API for Shopping | Merchant API |
|---|---|---|
| পন্যের ID | কোলন (:) দিয়ে আলাদা করা সেগমেন্ট নিয়ে তৈরি স্ট্রিং।ফর্ম্যাট: channel:contentLanguage:targetCountry:offerId অথবা channel:contentLanguage:feedLabel:offerId।উদাহরণ: online:en:US:sku123 |
একটি REST রিসোর্স name স্ট্রিং।ফর্ম্যাট: accounts/{account}/products/{product} যেখানে {product} হল contentLanguage~feedLabel~offerId।উদাহরণ: accounts/12345/products/en~US~sku123।এনকোডিং: আনপ্যাডেড base64url এনকোডিং সাজেস্ট করা হয় এবং মার্চেন্ট API বা URL-রিজার্ভড অক্ষর ব্যবহার করে এমন প্রোডাক্ট আইডির ক্ষেত্রে বাধ্যতামূলক। |
পদ্ধতি
এই সারণীতে Content API for Shopping পদ্ধতি এবং Merchant API-তে তার সমতুল্য পদ্ধতি দেখানো হয়েছে।
| Content API for Shopping পদ্ধতি | Merchant API পদ্ধতি | উপলভ্যতা ও নোট |
|---|---|---|
products.get |
products.get |
চূড়ান্ত, প্রসেস করা প্রোডাক্ট ফিরিয়ে আনে। |
products.list |
products.list |
চূড়ান্ত, প্রসেস করা প্রোডাক্টের তালিকা। |
products.insert |
productInputs.insert |
প্রোডাক্ট ইনপুট যোগ করে। dataSource থাকতে হবে। |
products.update |
productInputs.patch |
আচরণ উল্লেখযোগ্যভাবে আলাদা। এটি নির্দিষ্ট প্রোডাক্ট ইনপুট আপডেট করে এবং এটি স্থায়ী। |
products.delete |
productInputs.delete |
নির্দিষ্ট প্রোডাক্ট ইনপুট মুছে দেয়। dataSource থাকতে হবে। |
products.custombatch |
উপলভ্য নয় | অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন। |
productstatuses.get |
products.get |
productstatuses পরিষেবা সরানো হয়েছে। স্ট্যাটাস সংক্রান্ত তথ্য এখন Product রিসোর্সের অংশ। |
productstatuses.list |
products.list |
productstatuses পরিষেবা সরানো হয়েছে। স্ট্যাটাস সংক্রান্ত তথ্য এখন Product রিসোর্সের অংশ। |
productstatuses.custombatch |
উপলভ্য নয় | অ্যাসিঙ্ক্রোনাস অনুরোধ বা HTTP ব্যাচিং ব্যবহার করুন। |
বিস্তারিত ফিল্ড পরিবর্তন
এই সারণীতে Merchant API-তে পরিবর্তন করা, যোগ করা বা সরিয়ে দেওয়া গুরুত্বপূর্ণ ফিল্ড হাইলাইট করা হয়েছে।
| Content API for Shopping | Merchant API | বিবরণ |
|---|---|---|
id |
name |
প্রোডাক্টের প্রাথমিক শনাক্তকারী এখন REST রিসোর্স name। প্রোডাক্টের নামে Merchant API বা URL-রিজার্ভড অক্ষর থাকলে আনপ্যাডেড base64url এনকোডিং সাজেস্ট করা হয় এবং এটি বাধ্যতামূলক। |
টপ-লেভেল প্রোডাক্ট ডেটা স্পেসিফিকেশন অ্যাট্রিবিউট (যেমন, title, price, link) |
productAttributes অবজেক্ট |
title, price ও link-এর মতো প্রোডাক্ট অ্যাট্রিবিউট আর টপ-লেভেল ফিল্ড হিসেবে নেই। এগুলি এখন Product এবং ProductInput রিসোর্স দুটিতেই productAttributes অবজেক্টের মধ্যে গ্রুপ করা হয়েছে। এটি আরও পরিচ্ছন্ন ও সুবিন্যস্ত রিসোর্স স্ট্রাকচার প্রদান করে। |
targetCountry |
feedLabel |
Merchant Center-এর কার্যকারিতার সাথে সামঞ্জস্য রাখতে রিসোর্সের নাম এখন targetCountry-এর পরিবর্তে feedLabel ব্যবহার করে। |
feedId |
dataSource (কোয়েরি প্যারামিটার) |
dataSource-এর নাম এখন সব productInputs রাইট মেথডের (insert, update, delete) জন্য একটি প্রয়োজনীয় কোয়েরি প্যারামিটার। |
channel |
উপলভ্য নেই। শুধুমাত্র স্থানীয় প্রোডাক্টের জন্য legacy_local ব্যবহার করুন। |
Merchant API-তে channel ফিল্ডটি আর নেই। Content API for Shopping-এ LOCAL চ্যানেল সহ প্রোডাক্টের পরিবর্তে legacy_local ফিল্ডকে 'সত্য' হিসেবে সেট করতে হবে। |
| উপলভ্য নয় | versionNumber |
ProductInput-এ একটি নতুন ঐচ্ছিক ফিল্ড যা প্রাথমিক ডেটা সোর্সে আউট-অফ-অর্ডার ইনসার্শন প্রতিরোধ করতে ব্যবহার করা যেতে পারে। |
string ধরনের ফিল্ডে নির্দিষ্ট সেট করা ভ্যালু আছে |
enum ধরনের ফিল্ডে নির্দিষ্ট সেট করা ভ্যালু আছে |
প্রোডাক্ট অ্যাট্রিবিউটের মধ্যে থাকা ফিল্ডে নির্দিষ্ট সেট করা ভ্যালু (যেমন excluded_destinations, availability) এখন enum ধরনের। |
gtin |
productAttributes.gtins |
সিঙ্গুলার স্ট্রিং (gtin) থেকে রিপিটেড স্ট্রিংয়ে (gtins) পরিবর্তন করা হয়েছে। |
sizes |
productAttributes.size |
পুনরাবৃত্ত স্ট্রিং (sizes) থেকে একবচন স্ট্রিংয়ে (size) পরিবর্তন করা হয়েছে। |
sizeType, additionalSizeType |
productAttributes.sizeTypes |
sizeType এবং additionalSizeType-এর পরিবর্তে রিপিট করা SizeType enum (sizeTypes) ব্যবহার করা হয়েছে যা সর্বাধিক দুটি ভ্যালু গ্রহণ করে (যেমন, ["PETITE", "MATERNITY"])। |