নতুন এজেন্টিক অভিজ্ঞতা এবং স্বয়ংক্রিয় ওয়ার্কফ্লো তৈরি করতে আপনার মার্চেন্ট সেন্টারের ডেটা ও ইনসাইটসে অনুমোদিত অ্যাক্সেস পেতে মার্চেন্ট এপিআই মডেল কনটেক্সট প্রোটোকল (এমসিপি) অ্যাক্সেস সার্ভিস ব্যবহার করুন।
সংক্ষিপ্ত বিবরণ
মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিসটি এলএলএম, এজেন্ট এবং কোডিং অ্যাসিস্ট্যান্টদের জন্য মার্চেন্ট সেন্টার ডেটার উপর ভিত্তি করে নতুন এজেন্টিক অভিজ্ঞতা ও স্বয়ংক্রিয় ওয়ার্কফ্লো তৈরি এবং পরিচালনা করার জন্য একটি প্রমিত ও নিরাপদ সংযোগ স্থাপন করে।
বিশেষভাবে, এটি আপনার মার্চেন্ট সেন্টার ডেটা এবং গুগল-তৈরি রিপোর্ট ও ইনসাইটস-এ অনুমোদিত অ্যাক্সেসের সুযোগ দেয়, যার মাধ্যমে নিম্নলিখিত ব্যবহারের ক্ষেত্রগুলো পূরণের জন্য শুধুমাত্র-পঠন (read-only) এবং সীমিত-লিখন (limited write) কার্যক্রম সম্পাদন করা যায়:
- পণ্যের অনুমোদনহীনতা নির্ণয় ও সমাধান করুন
- কর্মক্ষমতা প্রতিবেদন এবং অন্তর্দৃষ্টি তৈরি করুন
- স্বয়ংক্রিয় উন্নতির জন্য অপ্ট-ইন পর্যালোচনা করুন।
- ডেটা উৎস তৈরি এবং সংগ্রহ করুন
নিরাপত্তা এবং প্রবেশাধিকার নিয়ন্ত্রণ
মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিসটি নিরাপত্তাকে অগ্রাধিকার দিয়ে ডিজাইন করা হয়েছে:
- প্রমাণীকরণ : টুলটির কার্যকারিতা স্ট্যান্ডার্ড মার্চেন্ট এপিআই প্রমাণীকরণ দ্বারা পরিচালিত হয়, যার জন্য OAuth 2.0 অথবা সার্ভিস অ্যাকাউন্ট ক্রেডেনশিয়াল প্রয়োজন। আমরা যথাসম্ভব সীমাবদ্ধ অ্যাক্সেস অধিকার সম্পন্ন ক্রেডেনশিয়াল ব্যবহার করার পরামর্শ দিই।
- কার্য সম্পাদনের নিরাপত্তা : এজেন্টিক ডিসকভারির জন্য টুলের দৃশ্যমানতা সীমাবদ্ধ না থাকলেও, টুলের কার্য সম্পাদন আপনার নির্দিষ্ট API ক্রেডেনশিয়ালের মধ্যে সীমাবদ্ধ।
- সুরক্ষামূলক ব্যবস্থা : নিরাপত্তা রক্ষাকবচ হিসেবে, টুলগুলো কঠোরভাবে শুধুমাত্র পঠনযোগ্য (read-only) অপারেশন এবং স্বল্প-ঝুঁকিপূর্ণ লেখার (write) টুলের (যেমন, ডেটা সোর্স তৈরি) মধ্যে সীমাবদ্ধ রাখা হয়েছে।
গুরুত্বপূর্ণ বিবেচ্য বিষয়
মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিসটি একটি আলফা সংস্করণ; এর পরিধি ও কার্যক্ষমতা সম্প্রসারিত করা হবে এবং এতে পরিবর্তন আসতে পারে।
শুরু করার আগে, নিম্নলিখিত সীমাবদ্ধতা এবং সর্বোত্তম অনুশীলনগুলো পর্যালোচনা করুন:
পরিবর্তন এবং রিলিজ
পূর্ব বিজ্ঞপ্তি ছাড়াই পরিবর্তন হতে পারে এবং তা রিলিজ নোটে প্রকাশ করা হবে।
নিরাপদ পরীক্ষা
লাইভ প্রোডাকশন পরিবেশে এই টুলগুলি ব্যবহার করার আগে, আমরা প্রথমে একটি টেস্ট অ্যাকাউন্ট বা নন-লাইভ অ্যাকাউন্ট ব্যবহার করে পরীক্ষা করার পরামর্শ দিই।
ভাগ করা কোটা
মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিস আপনার স্ট্যান্ডার্ড মার্চেন্ট এপিআই কলগুলোর মতোই একই কোটা পুল ব্যবহার করে। চলমান এজেন্টগুলো দ্রুত কোটা শেষ করে ফেলতে পারে, বিশেষ করে ডেটা সোর্স ফেচ করার ক্ষেত্রে। প্রোডাকশন সার্ভিসে বিঘ্ন এড়াতে আমরা একটি টেস্ট অ্যাকাউন্ট ব্যবহার করার জন্য দৃঢ়ভাবে সুপারিশ করছি।
টুল ফিল্টারিং এবং নিরাপত্তা
ভবিষ্যতে নতুন সক্ষমতা, বিশেষ করে রাইট অ্যাকশন, যোগ করা হবে। আমরা দৃঢ়ভাবে সুপারিশ করছি যে, সম্পূর্ণ টুলসেটটি উন্মুক্ত না করে আপনার ক্লায়েন্টকে বিল্ট-ইন টুল ফিল্টারিংয়ের জন্য স্পষ্টভাবে কনফিগার করুন।
উপলব্ধ সক্ষমতার সারাংশ
আপনি মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিস ব্যবহার করে এজেন্টিক পদ্ধতিতে নিম্নলিখিত কাজগুলো সম্পাদন করতে পারেন:
- সঠিক রিসোর্স নাম ব্যবহার করে নির্দিষ্ট প্রোডাক্টের বিস্তারিত স্ট্যাটাস এবং রিপোর্টিং কনটেক্সট পুনরুদ্ধার করুন ।
- একাধিক পণ্য তালিকাভুক্ত করুন এবং অনুসন্ধান করুন ।
- পারফরম্যান্স মেট্রিক্স, পণ্যের অবস্থা, জনপ্রিয় পণ্য সম্পর্কিত তথ্য, মূল্য নির্ধারণের বিবরণ, প্রতিযোগিতামূলক দৃশ্যমানতা এবং ইউটিউব শপিং অ্যাফিলিয়েট অ্যানালিটিক্স সম্পর্কে জানুন ।
- পণ্যের দৃশ্যমানতা বা প্রোগ্রামে অংশগ্রহণকে প্রভাবিত করে এমন অ্যাকাউন্ট-স্তরের সমস্যাগুলো শনাক্ত করুন ।
- ডেটা সোর্সগুলোর তালিকা তৈরি করুন, সেগুলো তৈরি করুন, সংগ্রহ করুন এবং আপলোডের অবস্থা পরীক্ষা করুন ।
- আপনার ইনভেন্টরি জুড়ে পণ্য অনুমোদনের অস্বীকৃতির সম্মিলিত কারণগুলো তালিকাভুক্ত করুন ।
- আইটেম, ছবি এবং শিপিং-এর জন্য স্বয়ংক্রিয় উন্নতি সেটিংস পর্যালোচনা করুন ।
- নির্দিষ্ট মার্চেন্ট সেন্টার প্রোগ্রামগুলোর জন্য সক্রিয় অঞ্চল, অপূর্ণ প্রয়োজনীয়তা এবং অংশগ্রহণের অবস্থা যাচাই করুন ।
শুরু করা হচ্ছে
আপনার IDE, কোডিং অ্যাসিস্ট্যান্ট বা এজেন্টকে মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিসের সাথে সংযুক্ত করতে, আপনার এমসিপি ক্লায়েন্ট সেটিংস আপডেট করুন। উদাহরণস্বরূপ, গুগল এজেন্ট স্টুডিও, ক্লড ডেস্কটপ, অ্যান্টিগ্র্যাভিটি, ভিজ্যুয়াল স্টুডিও কোড বা আপনার কাস্টম এজেন্ট ফ্রেমওয়ার্কের জন্য 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কল করে। - এমসিপি সার্ভার লাইভ রিপোর্টিং ডেটাবেসের বিরুদ্ধে কোয়েরিটি চালায় এবং সারিগুলো ফেরত দেয়।
- এজেন্টটি আপনার জন্য ফলাফলগুলোকে একটি পরিচ্ছন্ন মার্কডাউন টেবিলে সাজিয়ে দেয়।
দৃশ্যকল্প ৪: ডেটা উৎস তৈরি এবং সংগ্রহ করা
আপনি পণ্যের আপডেট আপলোড করার জন্য একটি নতুন ডেটা সোর্স যোগ করতে চান।
ব্যবহারকারীর জন্য নির্দেশিকা:
আমার মার্চেন্ট অ্যাকাউন্টের জন্য 'price-updates' নামে একটি সম্পূরক ডেটা সোর্স তৈরি করুন।
MCP-এর সাথে এজেন্টের আচরণ:
- নতুন ফিডটি নিবন্ধন করার জন্য এজেন্ট নির্দিষ্ট সেটিংস সহ
create_data_sourceকল করে। - এমসিপি সার্ভার ডেটা সোর্সটি তৈরি করে এবং এর অনন্য রিসোর্স নামটি ফেরত দেয়।
- এজেন্ট সংশ্লিষ্ট ফাইলটির ডাউনলোড ও প্রক্রিয়াকরণ শুরু করার জন্য
fetch_data_sourceকল করে। - এজেন্ট আপলোডের অগ্রগতি নিরীক্ষণ করতে এবং আইটেমগুলোর সফল প্রক্রিয়াকরণের অবস্থা নিশ্চিত করতে
get_file_uploadকল করে।
এমসিপি সরঞ্জাম এবং বিবরণ
মার্চেন্ট এপিআই এমসিপি অ্যাক্সেস সার্ভিস আপনার এজেন্টের কাছে নিম্নলিখিত টুলগুলো উন্মুক্ত করে:
| এমসিপি টুল | বর্ণনা |
|---|---|
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_aggregate_product_statuses | আপনার পণ্যের ডেটার সার্বিক অবস্থা নিরীক্ষণ করতে পণ্য-স্তরের সমস্যাগুলোর একটি সম্মিলিত তালিকা তৈরি করুন। |
get_automatic_improvements | আইটেম আপডেট, ছবির উন্নতি এবং শিপিংয়ের উন্নতি সহ স্বয়ংক্রিয় উন্নতির সেটিংস পান। |