আপনার পছন্দের কোডিং অ্যাসিস্ট্যান্ট থেকে সরাসরি আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট সম্পর্কিত লাইভ ডেটা পান। আপনার ইন্টিগ্রেটেড ডেভেলপমেন্ট এনভায়রনমেন্ট (IDE) বা কাস্টম এজেন্ট ফ্রেমওয়ার্কের মধ্যে, আপনি এখন মডেল কনটেক্সট প্রোটোকল (MCP) পরিষেবা ব্যবহার করে আপনার মার্চেন্ট সেন্টার ডেটা অ্যাক্সেস এবং পরিচালনা করতে পারবেন। এই পরিষেবাটি আপনার কোডিং অ্যাসিস্ট্যান্ট বা এজেন্টকে আপনার মার্চেন্ট সেন্টার ডেটার উপর রিড-অনলি এবং নিরাপদ রাইট অপারেশন সম্পাদন করার ক্ষমতা দেয়, যার ফলে এটি নির্ভরযোগ্য ও লাইভ কনটেক্সটের সাহায্যে সমস্যা নির্ণয় করতে, প্রোগ্রাম পরীক্ষা করতে এবং রিপোর্ট কোয়েরি করতে পারে।
প্রোটোকলটি সম্পর্কে আরও তথ্যের জন্য, মডেল কনটেক্সট প্রোটোকল স্ট্যান্ডার্ডটি দেখুন।
নিরাপত্তা এবং প্রবেশাধিকার নিয়ন্ত্রণ
মার্চেন্ট ডেটা এমসিপি সার্ভারটি নিরাপত্তাকে অগ্রাধিকার দিয়ে ডিজাইন করা হয়েছে:
- প্রমাণীকরণ : টুলটির কার্যকারিতা কঠোরভাবে স্ট্যান্ডার্ড মার্চেন্ট এপিআই প্রমাণীকরণ দ্বারা নিয়ন্ত্রিত হয়, যার জন্য OAuth 2.0 অথবা সার্ভিস অ্যাকাউন্টের ক্রেডেনশিয়াল প্রয়োজন।
- কার্য সম্পাদনের নিরাপত্তা : আপনার এজেন্টের কাছে টুল স্কিমাগুলো ব্যাপকভাবে দৃশ্যমান থাকা সত্ত্বেও, যেকোনো টুলের প্রকৃত কার্য সম্পাদন অত্যন্ত সুরক্ষিত থাকে এবং আপনার নির্দিষ্ট এপিআই ক্রেডেনশিয়াল দ্বারা কঠোরভাবে সীমাবদ্ধ থাকে।
গুরুত্বপূর্ণ বিবেচ্য বিষয়
এই সরঞ্জামগুলি ব্যবহার করার আগে, নিম্নলিখিত সর্বোত্তম অনুশীলন এবং সীমাবদ্ধতাগুলি পর্যালোচনা করুন:
পরিবর্তন এবং রিলিজ
আমরা রিলিজ নোটে পরিবর্তনগুলো সম্পর্কে জানাবো, কিন্তু সেগুলো কোনো ডেপ্রিকেশন পিরিয়ড ছাড়াই অবিলম্বে কার্যকর হতে পারে।
নিরাপদ পরীক্ষা
লাইভ প্রোডাকশন পরিবেশে এই টুলগুলি ব্যবহার করার আগে, আমরা প্রথমে একটি টেস্ট অ্যাকাউন্ট বা নন-লাইভ অ্যাকাউন্ট ব্যবহার করে পরীক্ষা করার পরামর্শ দিই।
ভাগ করা কোটা
এমসিপি সার্ভার আপনার স্ট্যান্ডার্ড মার্চেন্ট এপিআই কলগুলোর মতোই একই কোটা পুল ব্যবহার করে। চলমান এজেন্টগুলো দ্রুত কোটা শেষ করে ফেলতে পারে, বিশেষ করে ডেটা সোর্স ফেচ করার ক্ষেত্রে। প্রোডাকশন পরিষেবায় বিঘ্ন এড়াতে আমরা একটি টেস্ট অ্যাকাউন্ট ব্যবহার করার জন্য দৃঢ়ভাবে সুপারিশ করছি।
টুল ফিল্টারিং এবং নিরাপত্তা
ভবিষ্যতে গুগল এই এমসিপি সার্ভারে নতুন টুল (লেখার ক্ষমতা সহ) যোগ করতে পারে। আপনার এআই এজেন্ট যাতে স্বয়ংক্রিয়ভাবে এবং অনিচ্ছাকৃতভাবে নতুন বা ঝুঁকিপূর্ণ টুল ব্যবহার না করে, তা প্রতিরোধ করার জন্য আমরা দৃঢ়ভাবে সুপারিশ করছি যে, সম্পূর্ণ টুলসেটটি উন্মুক্ত না করে আপনার ক্লায়েন্টকে বিল্ট-ইন টুল ফিল্টারিংয়ের জন্য স্পষ্টভাবে কনফিগার করুন।
পরিধি এবং সীমাবদ্ধতা
- শুধুমাত্র পঠনযোগ্যতার উপর মনোযোগ : এই প্রাথমিক পর্যায়ের সুরক্ষাব্যবস্থা হিসেবে, টুলগুলো কঠোরভাবে শুধুমাত্র পঠনযোগ্য অপারেশন এবং কম ঝুঁকিপূর্ণ রাইট টুলের (যেমন ডেটা সোর্স তৈরি) মধ্যে সীমাবদ্ধ রাখা হয়েছে।
উপলব্ধ ক্ষমতা
আপনি মার্চেন্ট ডেটা এমসিপি সার্ভার ব্যবহার করে এজেন্টিক পদ্ধতিতে নিম্নলিখিত কাজগুলো সম্পাদন করতে পারেন:
- সঠিক রিসোর্স নাম ব্যবহার করে নির্দিষ্ট প্রোডাক্টের বিস্তারিত স্ট্যাটাস এবং রিপোর্টিং কনটেক্সট পুনরুদ্ধার করুন ।
- একাধিক পণ্য তালিকাভুক্ত করুন এবং অনুসন্ধান করুন ।
- সার্চ রিপোর্টের মাধ্যমে পারফরম্যান্স ডেটা, পণ্যের স্ট্যাটাস এবং মূল্য সম্পর্কিত তথ্য জানুন।
- ডেটা সোর্সগুলোর তালিকা তৈরি করুন, সেগুলো তৈরি করুন, সংগ্রহ করুন এবং আপলোডের অবস্থা পরীক্ষা করুন ।
- পণ্যের দৃশ্যমানতা বা প্রোগ্রামে অংশগ্রহণকে প্রভাবিত করে এমন অ্যাকাউন্ট-স্তরের সমস্যাগুলো শনাক্ত করুন ।
- আপনার ইনভেন্টরি জুড়ে পণ্য অনুমোদনের অস্বীকৃতির সম্মিলিত কারণগুলো তালিকাভুক্ত করুন ।
- নির্দিষ্ট মার্চেন্ট সেন্টার প্রোগ্রামগুলোর জন্য সক্রিয় অঞ্চল, অপূর্ণ প্রয়োজনীয়তা এবং অংশগ্রহণের অবস্থা যাচাই করুন ।
- আইটেম, ছবি এবং শিপিং-এর জন্য স্বয়ংক্রিয় উন্নতি সেটিংস পর্যালোচনা করুন ।
সেটআপ
আপনার IDE বা কোডিং অ্যাসিস্ট্যান্টকে মার্চেন্ট ডেটা MCP সার্ভারের সাথে সংযুক্ত করতে, আপনার MCP ক্লায়েন্ট সেটিংস আপডেট করুন। উদাহরণস্বরূপ, Claude Desktop, Antigravity, Visual Studio Code, বা আপনার কাস্টম এজেন্ট ফ্রেমওয়ার্কের জন্য mcp.json ফাইলটি আপডেট করুন।
স্থানীয় এমসিপি সার্ভার সেটআপের জন্য একটি সার্ভিস অ্যাকাউন্ট প্রয়োজন । এই হেডলেস লোকাল এক্সিকিউশনের জন্য স্ট্যান্ডার্ড ইউজার OAuth সমর্থিত নয় । আপনাকে অবশ্যই একটি সার্ভিস অ্যাকাউন্ট তৈরি করতে হবে, এর JSON প্রাইভেট কী ফাইলটি ডাউনলোড করতে হবে এবং আর্গুমেন্ট হিসেবে আপনার নির্দিষ্ট মার্চেন্ট সেন্টার আইডির সাথে সেটির পাথ প্রদান করতে হবে।
সার্ভিস অ্যাকাউন্ট কীভাবে তৈরি ও ডাউনলোড করতে হয়, সে বিষয়ে বিস্তারিত নির্দেশাবলীর জন্য সার্ভিস অ্যাকাউন্টস গাইডটি দেখুন।
ক্লায়েন্ট কনফিগারেশন
কনফিগারেশন সেটআপ:
অ্যান্টিগ্র্যাভিটি
অ্যান্টিগ্র্যাভিটি ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
ক্লড ডেস্কটপ
Claude Desktop ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
ব্যবহারের উদাহরণ পরিস্থিতি
মার্চেন্ট ডেটা এমসিপি সার্ভার আপনার এজেন্টকে আপনার লাইভ মার্চেন্ট সেন্টার ডেটার সাথে ইন্টারঅ্যাক্ট করতে সক্ষম করে। এখানে কিছু সাধারণ পরিস্থিতি তুলে ধরা হলো:
দৃশ্যকল্প ১: পণ্যের অনুমোদন না দেওয়ার কারণগুলো নির্ণয় করুন
আপনি বুঝতে চান কেন একটি নির্দিষ্ট পণ্য গুগল সার্চ ফলাফলে দেখা যাচ্ছে না।
ব্যবহারকারীর জন্য নির্দেশিকা:
আমার 'offer123' অফার আইডির পণ্যটি কেন অনুমোদন করা হয়নি?
MCP-এর সাথে এজেন্টের আচরণ:
- এজেন্ট পণ্যের অবস্থা খুঁজে বের করার জন্য
list_productsঅথবাget_product_by_nameকল করে। - এমসিপি সার্ভার পণ্যের স্ট্যাটাস ফেরত দেয়, যার মধ্যে
issuesএকটি তালিকাও থাকে (উদাহরণস্বরূপ, "ভুল মূল্য বিন্যাস" বা "শিপিং মূল্য অনুপস্থিত")। - এজেন্ট সমস্যাগুলো বিশ্লেষণ করে আপনাকে মূল কারণ ব্যাখ্যা করেন এবং তা সমাধানের উপায়ও বাতলে দেন (যেমন, মূল্যের তথ্য হালনাগাদ করা)।
দৃশ্যকল্প ২: স্বয়ংক্রিয় উন্নতিগুলো পরীক্ষা করুন
আপনার স্বয়ংক্রিয় শিপিং উন্নয়নগুলো সক্রিয় আছে কিনা তা যাচাই করতে হবে।
ব্যবহারকারীর জন্য নির্দেশিকা:
আমার স্বয়ংক্রিয় শিপিং উন্নতিগুলো কি সক্রিয় করা আছে?
MCP-এর সাথে এজেন্টের আচরণ:
- এজেন্ট অ্যাকাউন্ট-স্তরের সেটিংস পুনরুদ্ধার করতে
get_automatic_improvementsকল করে। - এমসিপি সার্ভারটি ছবি, আইটেম এবং শিপিং-এর উন্নতির অবস্থা প্রদর্শনকারী কনফিগারেশনটি ফেরত দেয়।
- এজেন্ট নিশ্চিত করে যে শিপিং সংক্রান্ত উন্নতিগুলো সক্রিয় আছে, অথবা সেগুলো বন্ধ থাকলে কীভাবে সক্রিয় করতে হবে তা ব্যাখ্যা করে।
দৃশ্যকল্প ৩: পারফরম্যান্স মেট্রিক্স কোয়েরি করুন
আপনি মার্চেন্ট সেন্টার UI-তে প্রবেশ না করেই দ্রুত আপনার সাম্প্রতিক পারফরম্যান্স যাচাই করতে চান।
ব্যবহারকারীর জন্য নির্দেশিকা:
গত সপ্তাহে ক্লিকের ভিত্তিতে আমার সেরা ৫টি পারফর্মিং প্রোডাক্ট দেখান।
MCP-এর সাথে এজেন্টের আচরণ:
- এজেন্টটি
product_performance_viewটেবিলকে লক্ষ্য করে একটি মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ (MCQL) কোয়েরি তৈরি করে, যাclicks DESCক্রমে সাজায় এবং5এ সীমাবদ্ধ রাখে। - এজেন্ট নির্মিত কোয়েরিটি দিয়ে
report_searchকল করে। - এমসিপি সার্ভার লাইভ রিপোর্টিং ডেটাবেসের বিরুদ্ধে কোয়েরিটি চালায় এবং সারিগুলো ফেরত দেয়।
- এজেন্টটি আপনার জন্য ফলাফলগুলোকে একটি পরিচ্ছন্ন মার্কডাউন টেবিলে সাজিয়ে দেয়।
উপলব্ধ সরঞ্জামগুলির বিস্তারিত তালিকা
এমসিপি সার্ভার আপনার এজেন্টের কাছে নিম্নলিখিত টুলগুলি সরবরাহ করে:
| এমসিপি টুল | বর্ণনা |
|---|---|
get_product_by_name | সঠিক প্রোডাক্ট রিসোর্স নামটি ব্যবহার করে কোনো নির্দিষ্ট মার্চেন্টের পণ্যের তথ্য পান। এটি রিপোর্টিং কনটেক্সট এবং সম্ভাব্য পণ্য-স্তরের সমস্যাসহ পণ্যের বিস্তারিত স্ট্যাটাস ফেরত দেয়। |
list_products | কোনো নির্দিষ্ট মার্চেন্টের জন্য একাধিক পণ্য তালিকাভুক্ত করুন বা অনুসন্ধান করুন। এটি পণ্যের বিস্তারিত স্ট্যাটাস প্রদান করে, যাতে রিপোর্টিং কনটেক্সট এবং পণ্য-স্তরের সম্ভাব্য সমস্যাগুলো অন্তর্ভুক্ত থাকে। |
report_search | পারফরম্যান্স মেট্রিক, পণ্যের অবস্থা এবং মূল্য সম্পর্কিত তথ্য পেতে রিপোর্টিং টেবিলগুলো কোয়েরি করুন। বিস্তারিত জানতে রিপোর্ট গাইড দেখুন। |
list_data_sources | কোনো নির্দিষ্ট ব্যবসায়ীর জন্য ডেটার উৎসগুলো তালিকাভুক্ত করুন। |
get_data_source | একটি নির্দিষ্ট ডেটা উৎসের বিবরণ জানুন। |
create_data_source | প্রদত্ত কোনো বণিকের জন্য একটি ডেটা উৎস তৈরি করুন। |
fetch_data_source | প্রদত্ত কোনো মার্চেন্টের জন্য ডেটা সোর্সের সাথে সংশ্লিষ্ট ফাইলটি সংগ্রহ ও প্রসেস করুন। |
get_file_upload | প্রদত্ত ডেটা সোর্সের সর্বশেষ ফাইল আপলোডের স্ট্যাটাস জানুন। |
list_accounts | একজন নির্দিষ্ট ব্যবহারকারীর অ্যাকাউন্টগুলোর তালিকা। |
list_account_issues | অ্যাকাউন্ট-ব্যাপী সমস্যা শনাক্ত করার জন্য কোনো নির্দিষ্ট মার্চেন্টের অ্যাকাউন্ট-স্তরের সমস্যাগুলোর তালিকা তৈরি করুন। |
list_programs | কোনো নির্দিষ্ট ব্যবসায়ীর জন্য প্রোগ্রামগুলোর তালিকা দিন, যার মধ্যে অংশগ্রহণের রাজ্য, সক্রিয় অঞ্চল এবং কোনো অপূর্ণ শর্ত অন্তর্ভুক্ত থাকবে। |
list_aggregated_product_issues | আপনার পণ্যের ডেটার সার্বিক অবস্থা নিরীক্ষণ করতে পণ্য-স্তরের সমস্যাগুলোর একটি সম্মিলিত তালিকা তৈরি করুন। |
get_automatic_improvements | আইটেম আপডেট, ছবির উন্নতি এবং শিপিংয়ের উন্নতি সহ স্বয়ংক্রিয় উন্নতির সেটিংস পান। |