পণ্য স্থানান্তর

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

এই নির্দেশিকাটি আপনাকে মূল পার্থক্যগুলো বুঝিয়ে দেবে, যা আপনাকে Content API for Shopping থেকে আপনার ইন্টিগ্রেশন মাইগ্রেট করতে সাহায্য করবে। নতুন ফিচারগুলো ব্যবহারের বিস্তারিত নির্দেশিকার জন্য, Manage your products দেখুন।

মূল পার্থক্য

শপিং-এর জন্য কন্টেন্ট এপিআই-এর তুলনায় মার্চেন্ট এপিআই-তে পণ্য ব্যবস্থাপনার সবচেয়ে উল্লেখযোগ্য পরিবর্তনগুলো নিচে দেওয়া হলো:

• ইনপুট এবং প্রক্রিয়াকৃত ডেটার জন্য নির্দিষ্ট রিসোর্স : মার্চেন্ট এপিআই প্রোডাক্ট ম্যানেজমেন্টকে দুটি রিসোর্সে বিভক্ত করে। আপনি আপনার প্রোডাক্ট ডেটা ইনসার্ট, আপডেট এবং ডিলিট করার জন্য ProductInput রিসোর্সটি ব্যবহার করতে পারেন। গুগল আপনার ইনপুটগুলো প্রসেস করার পর, নিয়ম প্রয়োগ করে এবং সম্পূরক উৎস থেকে ডেটা একত্রিত করার পরে চূড়ান্ত প্রোডাক্টটি দেখার জন্য আপনি রিড-অনলি Product রিসোর্সটি ব্যবহার করতে পারেন।

• পণ্যের নামের জন্য এনকোডিং : আপনি ProductInput.name এবং Product.name উভয় ফিল্ডের জন্য আনপ্যাডেড base64url (RFC 4648 সেকশন 5) এনকোডিং ব্যবহার করতে পারেন। যদি পণ্যের নামে মার্চেন্ট এপিআই (Merchant API) দ্বারা ব্যবহৃত অক্ষর বা ইউআরএল-সংরক্ষিত অক্ষর থাকে, তবে এনকোডিং বাধ্যতামূলক । উদাহরণস্বরূপ, পণ্যের নামে নিম্নলিখিত অক্ষরগুলির কোনোটি থাকলে আপনাকে অবশ্যই তা এনকোড করতে হবে:

  % . + / : ~ , ( * ! ) & ? = @ # $
  

• সমন্বিত পণ্যের অবস্থা : productstatuses সার্ভিসটি সরিয়ে ফেলা হয়েছে। পণ্যের যাচাইকরণ সংক্রান্ত সমস্যা এবং গন্তব্যের অবস্থা এখন সরাসরি Product রিসোর্সের productStatus ফিল্ডের মধ্যে অন্তর্ভুক্ত করা হয়েছে, যা ডেটা পুনরুদ্ধারকে সহজ করে তুলেছে।

• Predictable product updates : The new productInputs.patch method modifies a specific product input directly. This is a significant improvement over the Content API for Shopping, where updates could be unexpectedly overwritten by other feed uploads. In Merchant API, an update remains until that specific product input is updated again or deleted. Product updates are applied on ProductInput resource instead of processed Product resource.

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

• নতুন রিসোর্স আইডেন্টিফায়ার : প্রোডাক্টগুলো এখন id ফিল্ডের পরিবর্তে একটি RESTful রিসোর্স name দ্বারা চিহ্নিত করা হয়। এর ফরম্যাটটি হলো accounts/{account}/products/{product} ।

• কাস্টম ব্যাচ নেই : custombatch মেথডটি এখন আর উপলব্ধ নেই। আপনি একটিমাত্র HTTP কলে একাধিক অনুরোধ পাঠাতে অ্যাসিঙ্ক্রোনাস রিকোয়েস্ট অথবা HTTP ব্যাচিং ব্যবহার করতে পারেন।

• যেকোনো ফিড লেবেল এবং ভাষার জন্য ডেটা সোর্স : মার্চেন্ট এপিআই ফিড লেবেল এবং ভাষা নির্দিষ্ট না করেই ডেটা সোর্স তৈরি করা সম্ভব করে, এবং এর ফলে যেকোনো ফিড লেবেল ও ভাষার পণ্য অন্তর্ভুক্ত করা যায়।

অনুরোধ

এই বিভাগে কন্টেন্ট এপিআই ফর শপিং এবং মার্চেন্ট এপিআই-এর রিকোয়েস্ট ফরম্যাটগুলোর তুলনা করা হয়েছে।

শনাক্তকারী

মার্চেন্ট এপিআই-তে প্রোডাক্ট আইডেন্টিফায়ারের ফরম্যাট পরিবর্তন করে একটি স্ট্যান্ডার্ড REST রিসোর্স নেম করা হয়েছে।

পদ্ধতি

এই সারণিতে কন্টেন্ট এপিআই-এর শপিং মেথডগুলো এবং মার্চেন্ট এপিআই-তে সেগুলোর সমতুল্য মেথডগুলো দেখানো হয়েছে।

বিস্তারিত ক্ষেত্রের পরিবর্তন

এই সারণিতে মার্চেন্ট এপিআই-তে পরিবর্তন করা, যোগ করা বা সরিয়ে দেওয়া গুরুত্বপূর্ণ ফিল্ডগুলো তুলে ধরা হয়েছে।