এই নথিটি সেরা অনুশীলনের জন্য নির্দেশিকা প্রদান করে। আরও তথ্যের জন্য কর্মক্ষমতা টিপস দেখুন।
কখন API ব্যবহার করবেন
প্রোগ্রামে অনুরোধ পাঠাতে
আপনি আপনার কর্মপ্রবাহের প্রতিটি অংশকে স্বয়ংক্রিয় করতে পছন্দ করেন বা আপনার ইআরপি (এন্টারপ্রাইজ রিসোর্স প্ল্যানিং) সিস্টেমে একটি হুক তৈরি করতে চান, বিষয়বস্তু এপিআই আপনাকে আপনার ইনভেন্টরি পরিবর্তনের সাথে সাথে আপডেট পাঠাতে দেয়।
অবিলম্বে প্রতিক্রিয়া পেতে
বিষয়বস্তু API-এ, ডেটা ফিডগুলি প্রক্রিয়া করার পরে একটি ইমেল সারাংশের মাধ্যমে না করে আপনি প্রতিটি অনুরোধের সাথে সাথেই একটি প্রতিক্রিয়া পান৷ বড় ব্যাচের অনুরোধের জন্য পাঁচ থেকে দশ সেকেন্ডের বিলম্ব প্রত্যাশিত৷
ঘন ঘন আপনার পণ্য ডেটা পরিবর্তন করতে
Content API-এর সাহায্যে আপনি দিনে অনেকবার আপনার দ্রুত চলমান পণ্য তালিকায় ক্রমবর্ধমান আপডেট করতে পারেন, যেখানে প্রতিবার আপনার সম্পূর্ণ ডেটা ফিড পাঠানো সম্ভব নয়। আপডেটগুলি পৃথকভাবে উপলব্ধ হলে, সেগুলিকে পৃথকভাবে পাঠান, বেশ কয়েকটি আপডেট না হওয়া পর্যন্ত অপেক্ষা করবেন না যাতে আপনি সেগুলি ব্যাচ করতে পারেন৷ একইভাবে, যদি আপডেটগুলি ব্যাচে পাওয়া যায়, সেগুলিকে ব্যাচে পাঠান, সেগুলিকে পৃথক অনুরোধে ভাগ করবেন না।
বিভিন্ন উপ-অ্যাকাউন্ট পরিচালনা করতে
নতুন তৈরি বণিক কেন্দ্রের অ্যাকাউন্টগুলি হল একক অ্যাকাউন্ট, যার নিজস্ব প্রোডাক্ট ডেটার সেট ধরে থাকে। এটি বেশিরভাগ ক্ষেত্রেই ভাল কাজ করে, কিন্তু আপনার অ্যাকাউন্ট বাড়ার সাথে সাথে আপনি দেখতে পাবেন যে আপনার পণ্যগুলির জন্য আপনার আরও জটিল ব্যবস্থাপনার প্রয়োজন। যদি এটি আপনার ক্ষেত্রে হয়, একটি মাল্টি-ক্লায়েন্ট অ্যাকাউন্ট বা MCA ব্যবহার করার কথা বিবেচনা করুন। একটি MCA অ্যাকাউন্টের API-স্তরের ব্যবস্থাপনা অ্যাকাউন্ট পরিষেবার মাধ্যমে পরিচালিত হতে পারে এবং সাব-অ্যাকাউন্টগুলির প্রোগ্রাম্যাটিক যোগ ও পরিচালনার অনুমতি দেয়। একটি MCA অ্যাকাউন্ট কিভাবে প্রাপ্ত করবেন সে সম্পর্কে আরও তথ্য এখানে পাওয়া যাবে।
কিভাবে API ব্যবহার করবেন
API ব্যবহার করবেন না যেমন আপনি ডেটা ফিড ব্যবহার করবেন
products সম্পদ ব্যবহার করার সময় আপনার সম্পূর্ণ পণ্য ফিডের দৈনিক আপডেট এড়িয়ে চলুন। পরিবর্তে, বিশেষভাবে শুধুমাত্র সেই পণ্যগুলি আপডেট করুন যাদের ডেটা আসলে পরিবর্তিত হয়েছে৷ products রিসোর্সের মাধ্যমে আপনার সম্পূর্ণ ডাটা ফিড পাঠালে Google এবং আপনার উভয়ের জন্যই বেশি সময় এবং সম্পদ খরচ হয়।
আপনার আপলোড করা পণ্যের তথ্য নিয়মিত পুনরুদ্ধার করতে API ব্যবহার করবেন না
আপনি যদি একটি নির্দিষ্ট বণিক কেন্দ্র অ্যাকাউন্টে পণ্যের তথ্য বজায় রাখার জন্য দায়ী হন, তাহলে নিয়মিতভাবে products.get বা products.list পদ্ধতির মাধ্যমে Content API থেকে পণ্যের তথ্যের অনুরোধ করা এড়িয়ে চলুন। তথ্য আপলোড করা ক্লায়েন্টদের জন্য, বিষয়বস্তু API ব্যবহার করে এমন সমাধানগুলি ডিজাইন করার সময় এই পদ্ধতিগুলি আপনাকে সমস্যাগুলি ডিবাগ করতে সহায়তা করতে পারে৷ যাইহোক, তারা এই ধরনের ক্লায়েন্টদের দ্বারা পণ্যের তথ্য নিয়মিত পুনরুদ্ধারের জন্য নয়। আপনার পণ্যের তথ্যের জন্য আপনার কাছে অন্য একটি উত্স থাকা উচিত, যেমন একটি স্থানীয় পণ্য ডাটাবেস, এবং মার্চেন্ট সেন্টারের পণ্যগুলি সেই উত্সের বিষয়বস্তুকে প্রতিফলিত করা উচিত।
পণ্য আইটেম জমা দিতে ডেটা ফিড এবং সামগ্রী API উভয়ই ব্যবহার করবেন না
আপনি যদি আইটেম জমা দেওয়ার জন্য API এ একটি স্যুইচ করার কথা বিবেচনা করছেন, তাহলে নিশ্চিত করুন যে আপনি পণ্য আইটেম জমা দেওয়ার জন্য আর ডেটা ফিড ব্যবহার করছেন না। আপনি যদি উভয় মাধ্যমেই আইটেম জমা দিতে থাকেন, তাহলে অপ্রত্যাশিত ফলাফল হতে পারে।
আমি নিরাপদে API এবং ডেটা ফিড একসাথে ব্যবহার করতে পারি এমন একটি উপায় আছে কি?
আপনি API-এর ডেটাফিড পরিষেবা ব্যবহার করে আপনার ডেটা ফিডগুলি পরিচালনা করতে পারেন৷ যদিও এটি স্কেলে ডেটা ফিড পরিচালনাকে আরও সহজ করে তুলবে, তবে মনে রাখবেন যে আপনি ফিডের সাথে একই সাথে API ব্যবহার করে পণ্যগুলি সন্নিবেশ বা আপডেট করবেন না, কারণ অপ্রত্যাশিত ফলাফল ঘটতে পারে।
ফিড এবং API যৌথভাবে ব্যবহার করার গ্রহণযোগ্য উপায়ের কিছু অন্যান্য উদাহরণ অন্তর্ভুক্ত:
API থেকে শুধুমাত্র পঠনযোগ্য অনুরোধ (পান বা তালিকা) কার্যকর করা: কিছু ব্যবসায়ী তাদের পণ্যের তথ্য এবং স্থিতি আপডেট আনতে API ব্যবহার করতে চায়। এটি গ্রহণযোগ্য কারণ পণ্যের তথ্য শুধুমাত্র ফিড দ্বারা আপডেট করা হয়।
আপনার সাব-অ্যাকাউন্টগুলি ( অ্যাকাউন্টস পরিষেবা ) এবং/অথবা অ্যাকাউন্ট-স্তরের ট্যাক্স এবং শিপিং সেটিংস ( অ্যাকাউন্টট্যাক্স পরিষেবা এবং শিপিংসেটিংস পরিষেবা ) পরিচালনা করতে API ব্যবহার করে৷ এগুলি এমন ফাংশন নয় যা ডেটাফিডগুলি সরবরাহ করতে পারে, তাই এই ফাংশনগুলি পরিচালনা করতে API ব্যবহার করার সাথে কোনও বিরোধ নেই৷
আমি কীভাবে ডেটা ফিড ব্যবহার করে শুধুমাত্র API ব্যবহার করতে বা এর বিপরীতে স্থানান্তর করতে পারি?
আপনি যদি বর্তমানে ডেটা ফিড ব্যবহার করেন এবং আপনি পণ্য আপডেট করার জন্য শুধুমাত্র API ব্যবহার করতে চান, তাহলে আপনাকে API এর সাথে আপনার পণ্য ডেটা পুনরায় আপলোড করতে হবে। যখন আপনি একটি প্রদত্ত পণ্য আপডেট করার জন্য পণ্য পরিষেবা ব্যবহার করেন, তখন API পণ্যের তথ্যের নিয়ন্ত্রণ নেয় এবং ডেটা ফিড থেকে পণ্যটি মুছে ফেললে বা ডেটা ফিড নিজেই মুছে দিলে আপনার বণিক কেন্দ্র অ্যাকাউন্ট থেকে পণ্যের তথ্য আর মুছে যাবে না। আপনি যদি ডেটা ফিড বা ডেটা ফিড থেকে পণ্যটি সরাতে চান তবে কোনও ডেটা ফিড আপডেট নেই তা নিশ্চিত করুন, অন্যথায় ডেটা ফিড আবার মালিকানা নেবে এবং ডেটা ফিড থেকে পণ্যটি সরিয়ে দিলে পণ্যটি সরানো হবে।
আপনি যদি বর্তমানে পণ্যের তথ্যের জন্য শুধুমাত্র API ব্যবহার করেন এবং আপনি পণ্যের তথ্যের প্রাথমিক উৎস হিসেবে ডেটা ফিড ব্যবহার করতে চান, তাহলে আপনি কেবলমাত্র আপনার Merchant Center অ্যাকাউন্টে নতুন ডেটা ফিড যোগ করতে পারেন এবং তারা তাদের তালিকাভুক্ত পণ্যের মালিকানা নেবে। শুধুমাত্র API থেকে আপলোড করা কোনো পণ্যের মেয়াদ শেষ হওয়ার আগে আপনি মুছে ফেলতে চাইলে, আপনাকে অবশ্যই সেগুলিকে মার্চেন্ট সেন্টার বা API-এর মাধ্যমে মুছতে হবে।
আমি কিভাবে কেনাকাটার জন্য সামগ্রী API ব্যবহার করে পণ্য সহ একাধিক দেশকে টার্গেট করব?
বিষয়বস্তু API-এর মাধ্যমে জমা দেওয়া পণ্যগুলির জন্য বিজ্ঞাপন এবং বিনামূল্যের তালিকা সহ একাধিক দেশকে টার্গেট করতে, Merchant Center-এ Content API প্রাথমিক ফিডে অতিরিক্ত দেশগুলি কনফিগার করুন বা products সংস্থানের shipping ক্ষেত্রের মাধ্যমে সেই অতিরিক্ত দেশগুলিকে যুক্ত করুন৷
Content API প্রাথমিক ফিড সেটিংস কীভাবে পরিবর্তন করবেন তার একটি উদাহরণ নিচে দেওয়া হল।
আরও তথ্যের জন্য, দেখুন: একাধিক দেশে শপিং বিজ্ঞাপন এবং বিনামূল্যের তালিকাকে লক্ষ্য করা ।
নিশ্চিত করুন যে আপনার ক্লায়েন্ট লাইব্রেরিগুলি আপ টু ডেট
আপনি যদি Content API-এর সাথে ইন্টারঅ্যাক্ট করার জন্য একটি Google ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে আপনার নির্বাচিত প্রোগ্রামিং ভাষার জন্য প্যাকেজ ম্যানেজার ব্যবহার করা নিশ্চিত করুন এবং নিশ্চিত করুন যে লাইব্রেরি সংস্করণ আপ টু ডেট। আরও তথ্যের জন্য, নমুনা এবং লাইব্রেরিতে আপনার নির্বাচিত ভাষার জন্য বিকাশকারীর নির্দেশিকা দেখুন।
বিভিন্ন শপিং প্রোগ্রামে কোন পণ্যগুলি প্রদর্শিত হবে তা নিয়ন্ত্রণ করতে গন্তব্য বৈশিষ্ট্যগুলি ব্যবহার করা নিশ্চিত করুন৷
Content API স্বয়ংক্রিয়ভাবে আপনার Content API ফিডের ডিফল্ট সেটিংস গ্রহণ করে কারণ এটি বণিক কেন্দ্রে কনফিগার করা হয়েছে। আপনি একটি ফিডের মধ্যে বা সামগ্রী API এর মাধ্যমে একটি পণ্য স্তরে প্রোগ্রাম অংশগ্রহণ নিয়ন্ত্রণ করতে includedDestinations বা excludedDestinations পণ্য বৈশিষ্ট্যগুলি ব্যবহার করতে পারেন৷
যদি আপনার API ফিড কোনো প্রোগ্রামে বেছে নেওয়া হয়, উদাহরণস্বরূপ, Buy on Google (পূর্বে শপিং অ্যাকশন নামে পরিচিত), কিন্তু আপনি কিছু পণ্য বাদ দিতে চান, excludedDestinations অ্যাট্রিবিউট ব্যবহার করুন এবং মান হিসেবে Shopping Actions উল্লেখ করুন। কোনও ত্রুটি না থাকলে, এটি মার্চেন্ট সেন্টারের ডিফল্ট ফিড সেটিংস ওভাররাইট করবে এবং সেই নির্দিষ্ট আইটেমটি Buy on Google (আগে শপিং অ্যাকশন নামে পরিচিত) তে দেখা যাবে না। বিপরীতভাবে, যদি আপনার ফিড কোনো প্রোগ্রামে বেছে না নেওয়া হয়, যেমন শপিং, তাহলে আপনি includedDestinations বৈশিষ্ট্য এবং Shopping_ads মান হিসেবে ব্যবহার করে পৃথক আইটেম অন্তর্ভুক্ত করতে পারেন এবং আইটেমটি শপিং বিজ্ঞাপনে প্রদর্শিত হবে।
includedDestinations এবং excludedDestinations পণ্য বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, সহায়তা কেন্দ্র দেখুন।
মেয়াদ শেষ হওয়ার আগে আইটেম আপডেট করতে ভুলবেন না
যদি একটি আইটেম মেয়াদ শেষ হওয়ার আগে পরিবর্তন না হয়, শেষ আপডেটের 30 দিন পরে বা নির্দিষ্ট মেয়াদ শেষ হওয়ার তারিখে আগে হলে, আইটেমটির নিষ্ক্রিয়করণ এড়াতে আপডেট করুন। আপনার যদি অনেকগুলি আইটেম আপডেট করার প্রয়োজন হয়, কারণ সেগুলির কোনওটিই পরিবর্তিত হয়নি বা আপনি কখন সেগুলি শেষবার আপডেট করা হয়েছিল তা ট্র্যাক করতে সক্ষম নন, একই সময়ে সমস্ত আইটেম আপডেট করবেন না, বরং একাধিক দিনে সমানভাবে লোড ছড়িয়ে দিন৷
Content API ফিড মুছে ফেলবেন না বা আপনার পণ্যগুলি অদৃশ্য হয়ে যেতে পারে
আপনি channel:online Content API-এর মাধ্যমে প্রথমবার একটি পণ্য আপলোড করার সময়, Content API শিরোনামে একটি নতুন ফিড মার্চেন্ট সেন্টারে উপস্থিত হবে। প্রথমবার যখন আপনি channel:local সামগ্রী API-এর মাধ্যমে একটি পণ্য আপলোড করবেন, তখন স্থানীয় পণ্যগুলির একটি উপশিরোনাম সহ বণিক কেন্দ্রে সামগ্রী API শিরোনামে একটি নতুন ফিড প্রদর্শিত হবে। নিশ্চিত করুন যে আপনি দুর্ঘটনাক্রমে অনলাইন বা স্থানীয় বিষয়বস্তু API ফিড মুছে ফেলবেন না। আপনি যে ফিডটি মুছেছেন তার উপর নির্ভর করে, সামগ্রী API এর মাধ্যমে আপনি যে অনলাইন বা স্থানীয় পণ্যগুলি বণিক কেন্দ্রে যোগ করেছেন তা সরানো হবে৷
কাস্টমব্যাচ পদ্ধতি ব্যবহার করে একই পরিষেবাতে একাধিক অনুরোধ ব্যাচ করুন
একই পরিষেবাতে অনেকগুলি অনুক্রমিক বা সমান্তরাল অনুরোধ করার পরিবর্তে, একটি একক কাস্টমব্যাচ অনুরোধ করুন যাতে সমস্ত পছন্দসই অনুরোধ থাকে। এইভাবে, এপিআই এন্ডপয়েন্টে অনুরোধ করার জন্য লেটেন্সি প্রতিটি পৃথক অনুরোধের পরিবর্তে কাস্টমব্যাচ কলের জন্য শুধুমাত্র একবার ঘটে, যা বিশেষ করে গুরুত্বপূর্ণ যদি আপনি অনুক্রমিক অনুরোধ করেন।
একক ব্যাচে একটি আইটেমের একাধিক আপডেট পাঠাবেন না
এটি আপডেটের ক্রম সম্পর্কে অনিশ্চয়তার কারণে অপ্রত্যাশিত ফলাফল দেবে এবং একটি দ্বন্দ্ব ত্রুটির কারণ হতে পারে।
অপরিবর্তিত আইটেমগুলির জন্য আপডেট পাঠাবেন না
নিশ্চিত করুন যে আপনি শুধুমাত্র নতুন, পরিবর্তিত বা মুছে ফেলা পণ্য আইটেমগুলির জন্য অনুরোধ পাঠাচ্ছেন যদি না আইটেমগুলির মেয়াদ শেষ হয়ে যায়।
দাম এবং/অথবা প্রাপ্যতা দ্রুত পরিবর্তন হলে সম্পূরক ফিড ব্যবহার করুন
আপনি যদি একটি পণ্যের মূল্য, প্রাপ্যতা, বা বিক্রয়ের তথ্য আপ-টু-ডেট রাখতে সমস্যায় পড়েন, তবে শুধুমাত্র সেই বৈশিষ্ট্যগুলির জন্য আপডেট পাঠাতে products সম্পদে সম্পূরক ফিডগুলি ব্যবহার করার কথা বিবেচনা করুন৷ যেহেতু সম্পূরক ফিড আপডেটগুলি ছোট, তাই আপনি সম্পূর্ণ পণ্য আপডেটের চেয়ে একটি নির্দিষ্ট সময়ের মধ্যে আরও অনেক পরিপূরক ফিড আপডেট করতে পারেন, যা আপনার পণ্যের দাম এবং আপনার ল্যান্ডিং পৃষ্ঠাগুলির সাথে সামঞ্জস্য রাখতে সাহায্য করবে৷
পণ্যের মূল্য এবং প্রাপ্যতা আপডেট করার আরেকটি রুট হল স্বয়ংক্রিয় আইটেম আপডেট ব্যবহার করা। বণিক কেন্দ্রের তথ্য এবং পণ্যের ল্যান্ডিং পৃষ্ঠার তথ্যের মধ্যে অমিল এড়াতে সহায়তা করতে API আপডেট ছাড়াও এটি ব্যবহার করা যেতে পারে। যাইহোক, মনে রাখবেন যে এটি পণ্যের মূল্য এবং প্রাপ্যতা নির্ভুলতার সাথে ছোট সমস্যাগুলি সমাধান করার জন্য ডিজাইন করা হয়েছে, তাই স্বয়ংক্রিয় আইটেম আপডেটগুলি API-এর মাধ্যমে সঠিক তথ্য প্রদানের প্রতিস্থাপন নয়।
কখন রিফ্রেশ টোকেন ব্যবহার করবেন
রিফ্রেশ টোকেনটি অনুমোদনের অনুরোধের HTTP শিরোনামে ফেরত দেওয়া হয়। এটিতে প্রচুর অন্যান্য প্রমাণীকরণ-সম্পর্কিত তথ্য রয়েছে, কিন্তু রিফ্রেশ টোকেনটি প্রায়শই এমন একটি অংশ যা ডেভেলপাররা তাদের হাত পেতে চায়, কারণ এটি ব্যবহারকারীকে বারবার প্রমাণীকরণের জন্য অনুরোধ করার প্রয়োজনকে সরিয়ে দেয়, যেহেতু অ্যাক্সেস টোকেন মেয়াদ শেষ হওয়ার আগে মাত্র 60 মিনিট স্থায়ী হয়।