আপনার পছন্দের কোডিং সহকারীর কাছ থেকে মার্চেন্ট API সম্পর্কে প্রাসঙ্গিক তথ্য পান। আপনার ইন্টিগ্রেটেড ডেভেলপমেন্ট এনভায়রনমেন্ট (IDE) এর মধ্যে, আপনি এখন মডেল কনটেক্সট প্রোটোকল (MCP) পরিষেবা ব্যবহার করে ডেভেলপার ডকুমেন্টেশন ইন্টিগ্রেশন অ্যাক্সেস করতে পারবেন। এই পরিষেবাটি আপনার কোডিং সহকারীকে অফিসিয়াল Google API ডকুমেন্টেশন থেকে প্রামাণিক প্রসঙ্গ প্রদান করে ইন্টিগ্রেশন এবং মাইগ্রেশন ওয়ার্কফ্লোয়ের জন্য আপনার ডেভেলপমেন্টকে ত্বরান্বিত করে।
প্রোটোকল সম্পর্কে আরও তথ্যের জন্য, মডেল কনটেক্সট প্রোটোকল স্ট্যান্ডার্ড দেখুন।
সংক্ষিপ্ত বিবরণ
শপিংয়ের জন্য কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআইতে স্থানান্তরিত করার সময় বা একটি নতুন ইন্টিগ্রেশন তৈরি করার সময়, আপনাকে নতুন পরিষেবা কাঠামো, রিসোর্সের নাম এবং পদ্ধতিগুলি বুঝতে হবে। এমসিপি পরিষেবা আপনার কোডিং সহকারীকে অফিসিয়াল ডকুমেন্টেশন এবং কোড নমুনা সরবরাহ করে এটিকে সহজ করে তোলে।
এই পরিষেবাটি একটি অত্যন্ত বিশেষায়িত Retrieval-Augmented Generation (RAG) ব্যাকএন্ড ব্যবহার করে। যখন আপনি আপনার MCP-সক্ষম IDE কোডিং সহকারীকে Merchant API সম্পর্কে একটি প্রশ্ন জিজ্ঞাসা করেন, তখন পরিষেবাটি Google এর অফিসিয়াল রিসোর্স থেকে টেক্সট এবং কোডের সবচেয়ে প্রাসঙ্গিক স্নিপেটগুলি পুনরুদ্ধার করে এবং আপনার কোডিং সহকারীকে প্রসঙ্গ হিসাবে ফেরত দেয়। এটি আপনার সহকারীকে আপনার ডেভেলপমেন্ট পরিবেশ ছেড়ে না গিয়েই সঠিক, আপ-টু-ডেট উত্তর প্রদান করতে দেয়।
কিভাবে এটা কাজ করে
MCP ব্যবহার করে ডেভেলপার ডকুমেন্টেশন ইন্টিগ্রেশন একটি আধুনিক, AI-সহায়তাপ্রাপ্ত ডেভেলপমেন্ট ওয়ার্কফ্লোতে সংহত হয়:
- আপনি আপনার MCP-সামঞ্জস্যপূর্ণ কোডিং সহকারী বা এজেন্টে একটি প্রশ্ন জিজ্ঞাসা করতে পারেন। এটি একটি স্বাভাবিক ভাষার প্রশ্ন হতে পারে, একটি মার্চেন্ট API কোড নমুনার জন্য অনুরোধ করতে পারে অথবা এমনকি আপনার কোডটি সরাসরি মার্চেন্ট API তে অনুবাদ করার অনুরোধও করতে পারে।
- আপনার কোডিং সহকারী MCP এন্ডপয়েন্টে প্রসঙ্গটির জন্য একটি অনুরোধ পাঠায়।
- MCP পরিষেবাটি সবচেয়ে প্রাসঙ্গিক তথ্য খুঁজে পেতে তার অফিসিয়াল মার্চেন্ট API ডকুমেন্টেশন, গাইড এবং কোড নমুনার সূচীকৃত সংগ্রহ অনুসন্ধান করে।
- পরিষেবাটি আপনার কোডিং সহকারীকে প্রসঙ্গ হিসাবে এই প্রামাণিক স্নিপেটগুলি ফেরত দেয়।
- আপনার কোডিং সহকারী আপনার মূল প্রশ্নের একটি সুনির্দিষ্ট এবং সহায়ক উত্তর তৈরি করতে অথবা কোড অনুবাদের কাজ সম্পাদন করতে এই উচ্চ-মানের প্রসঙ্গটি ব্যবহার করে।
শুরু করা
MCP ব্যবহার করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
১. একটি সামঞ্জস্যপূর্ণ টুল ব্যবহার করুন
স্ট্রিমেবল HTTP ট্রান্সপোর্ট সহ মডেল কনটেক্সট প্রোটোকল সমর্থন করে এমন একটি IDE বা কোডিং সহকারী খুলুন।
2. এন্ডপয়েন্ট কনফিগারেশন
আপনার IDE বা কোডিং সহকারীকে MCP-এর সাথে সংযুক্ত করতে, প্রদত্ত রিমোট এন্ডপয়েন্ট বিবরণ ব্যবহার করুন যার জন্য আপনাকে সরাসরি পরিষেবা URL অথবা MCP সংজ্ঞা (আপনার টুলের কনফিগারেশনের উপর নির্ভর করে) ইনপুট করতে হতে পারে।
পরিষেবার URLটি হল:
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"
৩. এজেন্ট নির্দেশাবলী যোগ করুন (ঐচ্ছিক)
আপনার এজেন্টকে MCP ব্যবহার করে সরাসরি কোড অনুবাদ করতে সক্ষম করতে, তাকে সিস্টেম নির্দেশাবলী প্রদান করুন: MerchantIntegrator Agent Protocol । এই নির্দেশাবলী এজেন্টকে কোড অনুবাদের জন্য MCP কীভাবে সঠিকভাবে ব্যবহার করতে হয় সে সম্পর্কে নির্দেশনা দেয়। আপনার টুলের উপর নির্ভর করে, আপনি সিস্টেম নির্দেশাবলী কনফিগারেশনে অথবা এজেন্টের জন্য অতিরিক্ত প্রসঙ্গ ফাইল হিসাবে এই নির্দেশাবলী প্রদান করতে পারেন।
ব্যবহারের উদাহরণ
এই সাধারণ ব্যবহারের ক্ষেত্রে MCP আপনার কর্মপ্রবাহকে ত্বরান্বিত করতে পারে।
দৃশ্যকল্প ১: products.insert স্থানান্তর করুন। কোড লিখুন
আপনি এজেন্টকে সরাসরি শপিং products.insert জন্য একটি কন্টেন্ট API মাইগ্রেট করতে বলতে পারেন। মার্চেন্ট API-তে ইন্টিগ্রেশন কোড সন্নিবেশ করান।
ব্যবহারকারীর প্রম্পট:
"
products.insertস্থানান্তর করুন। মার্চেন্ট API-তে কোড সন্নিবেশ করুন"
আপনার এজেন্টকে সিস্টেম নির্দেশাবলী: MerchantIntegrator Agent Protocol এবং MCP অ্যাক্সেস প্রদান করে, আপনার এজেন্ট আপনার IDE-তে সরাসরি শপিং কোডের জন্য Content API কে Merchant API কোডে অনুবাদ করতে পারে। এই ক্ষেত্রে, এটি productInputs.insert কে সমতুল্য কল হিসাবে সনাক্ত করবে এবং Merchant API-এর জন্য প্রয়োজনীয় পুরানো ফর্ম্যাট থেকে নতুন ফর্ম্যাটে পণ্য বৈশিষ্ট্যগুলি ম্যাপ করবে। এটি প্রয়োজনীয় আমদানি এবং নির্ভরতা ব্যবস্থাপনা ফাইল (উদাহরণস্বরূপ requirements.txt , pom.xml বা package.json ) আপডেট করতে পারে। আপনি এজেন্টকে পরিবর্তনগুলি করার জন্য বা একটি নতুন ফোল্ডার তৈরি করার জন্য নির্দেশ দিতে পারেন।
দৃশ্যপট ২: সমতুল্য কার্যকারিতা খুঁজুন
আপনার কাছে একটি বিদ্যমান অ্যাপ্লিকেশন আছে যা শপিংয়ের জন্য কন্টেন্ট এপিআই ব্যবহার করে এবং এটি আপডেট করতে হবে। নতুন বাস্তবায়ন এবং প্রাসঙ্গিক কোড নমুনা সম্পর্কে বিশদ জানতে আপনি একটি নির্দিষ্ট লিগ্যাসি পদ্ধতি সম্পর্কে জিজ্ঞাসা করতে পারেন।
ব্যবহারকারীর প্রম্পট:
"কেনাকাটার জন্য কন্টেন্ট API-তে accountstatuses.get পদ্ধতির জন্য Merchant API সমতুল্য কী?"
MCP পরিষেবাটি অফিসিয়াল মাইগ্রেশন গাইড এবং রেফারেন্স ডকুমেন্টেশন থেকে প্রসঙ্গ প্রদান করে, যা আপনার সহকারীকে নতুন API নাম, accounts.issues সহ একটি বিস্তারিত উত্তর দিয়ে উত্তর দিতে দেয়।
দৃশ্যপট ৩: একটি কোড নমুনা খোঁজা
আপনি একটি নতুন বৈশিষ্ট্য বাস্তবায়ন করছেন এবং অনুসরণ করার জন্য একটি ব্যবহারিক উদাহরণ প্রয়োজন।
ব্যবহারকারীর প্রম্পট:
"Merchant API ব্যবহার করে একটি নতুন শিপিং পরিষেবা যোগ করার জন্য আমাকে একটি Python কোড নমুনা দেখান।"
MCP পরিষেবাটি অফিসিয়াল Google GitHub রিপোজিটরি এবং ডেভেলপার গাইড থেকে প্রাসঙ্গিক কোড নমুনাগুলি পুনরুদ্ধার করে। এরপর আপনার সহকারী একটি সম্পূর্ণ, অ্যাডাপ্ট করার জন্য প্রস্তুত কোড ব্লক উপস্থাপন করতে পারে।
দৃশ্যপট ৪: API ধারণাগুলি বোঝা
আপনি একটি নতুন ধারণার সম্মুখীন হন অথবা একটি রিসোর্সের গঠন বা সামগ্রিক মার্চেন্ট এপিআই প্যাটার্ন বুঝতে চান।
ব্যবহারকারীর প্রম্পট:
"Merchant API ব্যবহার করে আমি কীভাবে কোনও পণ্যের ইনভেন্টরি আপডেট করব?"
MCP পরিষেবাটি পণ্য রিসোর্স ডকুমেন্টেশন এবং প্রাসঙ্গিক নির্দেশিকা থেকে প্রসঙ্গ ফেরত দেয়। এরপর আপনার সহকারী ব্যাখ্যা করতে পারবেন কিভাবে accounts.productInputs.insert পদ্ধতিটি ব্যবহার করতে হয় এবং আংশিক পণ্য রিসোর্স প্রদান করতে পারে যেখানে কেবল productId এবং ইনভেন্টরি-সম্পর্কিত ক্ষেত্রগুলি আপডেট করতে হবে।
"আমি কিভাবে Merchant API ব্যবহার করে আমার অ্যাপ্লিকেশন কল অনুমোদন করব?"
MCP পরিষেবাটি অফিসিয়াল প্রমাণীকরণ নির্দেশিকা থেকে প্রসঙ্গ পুনরুদ্ধার করে, যা বিভিন্ন অনুমোদন পদ্ধতি কভার করে। আপনার সহকারী তখন উপলব্ধ প্রাথমিক বিকল্পগুলি ব্যাখ্যা করতে পারে, যেমন সার্ভার-টু-সার্ভার ইন্টারঅ্যাকশনের জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করা অথবা ব্যবহারকারীর পক্ষে কাজ করার সময় একটি OAuth 2.0 ক্লায়েন্ট আইডি ব্যবহার করা।
দৃশ্যপট ৫: API পরিবর্তনের সাথে খাপ খাইয়ে নেওয়া
মার্চেন্ট API নতুন প্যাটার্ন প্রবর্তন করে — যেমন ব্যাচিং অনুরোধ — যা শপিংয়ের জন্য কন্টেন্ট API থেকে আলাদা। শপিংয়ের জন্য কন্টেন্ট API নির্দিষ্ট custombatch পদ্ধতি ব্যবহার করে, যেখানে মার্চেন্ট API একটি অন্তর্নির্মিত, জেনেরিক HTTP ব্যাচিং বৈশিষ্ট্য ব্যবহার করে।
ব্যবহারকারীর প্রম্পট:
"Merchant API-তে products.custombatch করার নতুন উপায় কী?"
MCP পরিষেবাটি সমসাময়িক অনুরোধগুলির জন্য রিফ্যাক্টর কোড থেকে প্রসঙ্গ পুনরুদ্ধার করে যা ব্যাখ্যা করে যে Merchant API-তে ডেডিকেটেড custombatch পদ্ধতি বিদ্যমান নেই। পরিবর্তে, এটি multipart একটি Content-Type সহ HTTP ব্যাচিং ব্যবহারের উপর ডকুমেন্টেশন প্রদান করে। আপনার সহকারী তারপর ব্যাখ্যা করতে পারে কিভাবে https://merchantapi.googleapis.com/batch/{sub-api}/v1 এন্ডপয়েন্টে পাঠানো একাধিক API কল ধারণকারী একটি একক HTTP অনুরোধ তৈরি করতে হয় এবং মাল্টিপার্ট অনুরোধটি কীভাবে গঠন করতে হয় তার একটি উদাহরণ প্রদান করে। এটি একটি সম্ভাব্য বিভ্রান্তিকর মাইগ্রেশন টাস্ককে একটি নির্দেশিত প্রক্রিয়ায় পরিণত করে।
দৃশ্যপট ৬: একটি রিপোর্টিং কোয়েরি অনুবাদ করুন
আপনি এজেন্টকে একটি রিপোর্টিং কোয়েরি শপিংয়ের জন্য Content API থেকে Merchant API তে অনুবাদ করতে বলতে পারেন।
ব্যবহারকারীর প্রম্পট:
"এই রিপোর্টিং কোয়েরিটি Content API থেকে Merchant API তে স্থানান্তর করুন: MerchantPerformanceView থেকে metrics.impressions, metrics.clicks, metrics.ctr নির্বাচন করুন যেখানে segments.date '2020-12-01' এবং '2020-12-30' এর মধ্যে রয়েছে"
MCP পরিষেবাটি সর্বশেষ রিপোর্টিং রেফারেন্স ডকুমেন্টেশন, ডেভেলপার গাইড এবং মাইগ্রেশন গাইড পুনরুদ্ধার করে। এই তথ্যের উপর ভিত্তি করে, এটি কোয়েরিটিকে নতুন কাঠামোতে রূপান্তরিত করে এবং ক্ষেত্রগুলিকে তাদের নতুন নাম এবং মানগুলিতে আপডেট করে।
জ্ঞানের উৎস
এমসিপি পরিষেবাটি কেবলমাত্র জনসাধারণ এবং অফিসিয়াল উৎস থেকে তার জ্ঞানের ভিত্তি তৈরি করে যাতে এটির প্রদত্ত প্রেক্ষাপট সঠিক এবং নির্ভরযোগ্য হয়। পরিষেবাটি অফিসিয়াল ডেভেলপার সাইট এবং কোড নমুনা সংগ্রহস্থলের সম্পূর্ণ বিষয়বস্তু সূচী করে, যার মধ্যে রয়েছে:
- মার্চেন্ট এপিআই ডেভেলপার সাইট : সমস্ত নির্দেশিকা, রেফারেন্স উপাদান এবং ডকুমেন্টেশন।
- মার্চেন্ট এপিআই অ্যাপস স্ক্রিপ্ট পরিষেবা : অ্যাপস স্ক্রিপ্ট থেকে মার্চেন্ট এপিআই ব্যবহারের উদাহরণ।
- অফিসিয়াল কোড নমুনা : GitHub রিপোজিটরি থেকে মার্চেন্ট API-এর জন্য সমস্ত অফিসিয়াল, গুগল-প্রদত্ত কোড নমুনা।
- ক্লায়েন্ট লাইব্রেরি : মার্চেন্ট দ্বারা সমর্থিত সমস্ত অফিসিয়াল ক্লায়েন্ট লাইব্রেরি