از سرویس دسترسی پروتکل زمینه مدل API فروشنده (MCP) برای دسترسی مجاز به دادهها و بینشهای مرکز فروشندگان خود استفاده کنید تا تجربیات جدید عاملیت و گردشهای کاری خودکار ایجاد کنید.
نمای کلی
سرویس دسترسی MCP API فروشنده، یک پل ارتباطی استاندارد و امن برای LLMها، نمایندگان و دستیاران کدنویسی فراهم میکند تا تجربیات جدید نمایندگی و گردشهای کاری خودکار مبتنی بر دادههای مرکز فروشنده را ایجاد و هماهنگ کنند.
به طور خاص، این امکان دسترسی مجاز به دادههای مرکز فروشندگان و گزارشها و بینشهای تولید شده توسط گوگل را برای انجام عملیات فقط خواندنی و نوشتن محدود فراهم میکند تا موارد استفادهای مانند موارد زیر را بررسی کند:
- تشخیص و رفع عدم تایید محصولات
- گزارشهای عملکرد و بینشها را ایجاد کنید
- گزینهی «بهبودهای خودکار» را بررسی کنید
- ایجاد و واکشی منابع داده
ایمنی و کنترل دسترسی
سرویس دسترسی MCP API فروشگاه با اولویت امنیت طراحی شده است:
- احراز هویت : اجرای ابزار توسط احراز هویت استاندارد Merchant API اداره میشود که نیازمند OAuth 2.0 یا اعتبارنامههای حساب کاربری سرویس است. توصیه میکنیم از اعتبارنامههایی با محدودترین حقوق دسترسی ممکن استفاده کنید.
- ایمنی اجرا : در حالی که قابلیت مشاهده ابزار برای کشف عامل محدود نشده است، اجرای ابزار به اعتبارنامههای API خاص شما محدود میشود.
- اقدامات حفاظتی : ابزارها به شدت به عملیات فقط خواندنی و ابزارهای نوشتن کمخطر (برای مثال، ایجاد منبع داده) به عنوان یک محافظ ایمنی محدود شدهاند.
ملاحظات مهم
سرویس دسترسی MCP API فروشگاه، یک نسخه آلفا است؛ دامنه و قابلیتهای آن گسترش یافته و ممکن است تغییر کند.
قبل از شروع، محدودیتها و بهترین شیوههای زیر را بررسی کنید:
تغییرات و نسخهها
تغییرات میتوانند بدون اطلاع قبلی رخ دهند و در یادداشتهای انتشار منتشر خواهند شد.
آزمایش ایمن
توصیه میکنیم قبل از استفاده از این ابزارها در یک محیط تولید زنده، ابتدا با استفاده از یک حساب آزمایشی یا یک حساب غیر زنده، آزمایش کنید.
سهمیه مشترک
سرویس دسترسی MCP API فروشنده، همان سهمیهای را که فراخوانیهای استاندارد API فروشنده شما دارد، به اشتراک میگذارد. عاملهای در حال اجرا میتوانند به سرعت سهمیه را تمام کنند، به خصوص برای واکشی منابع داده. ما اکیداً توصیه میکنیم برای جلوگیری از اختلالات سرویس تولید، از یک حساب آزمایشی استفاده کنید.
فیلتر کردن ابزار و ایمنی
قابلیتهای جدید، به ویژه اقدامات نوشتن، در آینده اضافه خواهند شد. ما اکیداً توصیه میکنیم که کلاینت خود را به طور صریح برای فیلتر کردن ابزار داخلی پیکربندی کنید تا اینکه کل مجموعه ابزارها را در معرض نمایش قرار دهید.
خلاصهای از قابلیتهای موجود
شما میتوانید از سرویس دسترسی MCP API مربوط به Merchant برای انجام اقدامات زیر به صورت عاملمحور استفاده کنید:
- وضعیت دقیق و زمینه گزارشدهی را برای محصولات خاص با استفاده از نام دقیق منابع بازیابی کنید .
- چندین محصول را فهرست و جستجو کنید .
- معیارهای عملکرد، وضعیت محصولات و بینشهایی در مورد محصولات محبوب، بینشهای قیمتگذاری، میزان رقابتپذیری و تجزیه و تحلیلهای همکاری در فروش یوتیوب را جستجو کنید .
- مشکلات سطح حساب کاربری که بر دیده شدن محصول یا مشارکت در برنامه تأثیر میگذارند را شناسایی کنید .
- فهرست کردن، ایجاد کردن، واکشی کردن و بررسی وضعیت آپلود منابع داده.
- دلایل کلی عدم تایید محصولات را در موجودی خود فهرست کنید .
- تنظیمات بهبود خودکار برای اقلام، تصاویر و ارسال را بررسی کنید .
- مناطق فعال، الزامات برآورده نشده و وضعیت مشارکت را برای برنامههای خاص مرکز بازرگانان بررسی کنید .
شروع به کار
برای اتصال IDE، دستیار کدنویسی یا عامل خود به Merchant API MCP Access Service، تنظیمات کلاینت MCP خود را بهروزرسانی کنید. برای مثال، فایل mcp.json را برای Google Agent Studio، Claude Desktop، Antigravity، Visual Studio Code یا چارچوب عامل سفارشی خود بهروزرسانی کنید.
راهاندازی سرویس دسترسی محلی Merchant API MCP به یک حساب کاربری سرویس نیاز دارد . کاربر استاندارد OAuth برای این اجرای محلی بدون سر پشتیبانی نمیشود . شما باید یک حساب کاربری سرویس ایجاد کنید، فایل کلید خصوصی JSON آن را دانلود کنید و مسیر آن را به همراه شناسه مرکز فروش خاص خود به عنوان آرگومان ارائه دهید.
برای دستورالعملهای دقیق در مورد نحوه ایجاد و دانلود یک حساب کاربری سرویس، به راهنمای حسابهای کاربری سرویس مراجعه کنید.
پیکربندی کلاینت
تنظیمات پیکربندی:
ضد جاذبه
دستورالعملهای موجود در مستندات Antigravity را دنبال کنید.
{
"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"
]
}
}
}
سناریوهای استفاده نمونه
برای نشان دادن چگونگی بهرهگیری از سرویس دسترسی MCP API فروشنده برای ایجاد تجربیات عاملمحور و گردشهای کاری خودکار، سناریوهای زیر را در نظر بگیرید:
سناریو ۱: تشخیص و رفع عدم تایید محصولات
شما میخواهید بفهمید که چرا یک محصول خاص در نتایج جستجوی گوگل نمایش داده نمیشود.
درخواست کاربر:
«چرا محصول من با شناسه پیشنهاد «offer123» تایید نشده است؟»
رفتار عامل با MCP:
- عامل برای یافتن وضعیت محصول
list_productsیاget_product_by_nameرا فراخوانی میکند. - سرور MCP وضعیت محصول، شامل لیستی از
issues(برای مثال، «فرمت قیمت نادرست» یا «ارزش ارسال ناموجود») را برمیگرداند. - نماینده مشکلات را تجزیه و تحلیل میکند و علت اصلی را برای شما توضیح میدهد و نحوه رفع آن را پیشنهاد میدهد (برای مثال، بهروزرسانی اطلاعات قیمت).
سناریو ۲: بررسی گزینهی «بهبودهای خودکار»
شما میخواهید تأیید کنید که آیا بهبودهای ارسال خودکار شما فعال هستند یا خیر.
درخواست کاربر:
«آیا بهبودهای ارسال خودکار من فعال هستند؟»
رفتار عامل با MCP:
- عامل
get_automatic_improvementsرا برای بازیابی تنظیمات سطح حساب فراخوانی میکند. - سرور MCP پیکربندی را برمیگرداند که وضعیت بهبود تصویر، کالا و ارسال را نشان میدهد.
- نماینده تأیید میکند که بهبودهای حمل و نقل فعال هستند، یا در صورت غیرفعال بودن، نحوه فعال کردن آنها را توضیح میدهد.
سناریو ۳: تهیه گزارشهای عملکرد و بینشها
شما میخواهید بدون نیاز به پیمایش در رابط کاربری مرکز فروشندگان، عملکرد اخیر خود را به سرعت بررسی کنید.
درخواست کاربر:
«پنج محصول برتر من از نظر تعداد کلیک در هفته گذشته را به من نشان بده.»
رفتار عامل با MCP:
- عامل یک پرسوجوی زبان پرسوجوی مرکز فروشندگان (MCQL) میسازد که جدول
product_performance_viewهدف قرار میدهد، بر اساسclicks DESCمرتب میکند و به5محدود میکند. - عامل
report_searchبا پرسوجوی ساختهشده فراخوانی میکند. - سرور MCP پرس و جو را در پایگاه داده گزارش زنده اجرا میکند و ردیفها را برمیگرداند.
- عامل نتایج را در یک جدول Markdown تمیز برای شما قالببندی میکند.
سناریو ۴: ایجاد و دریافت منابع داده
شما میخواهید یک منبع داده جدید برای آپلود بهروزرسانیهای محصول اضافه کنید.
درخواست کاربر:
«برای حساب تجاری من، یک منبع داده تکمیلی با نام «بهروزرسانیهای قیمت» ایجاد کنید.»
رفتار عامل با MCP:
- عامل، تابع
create_data_sourceرا با تنظیمات مشخص شده برای ثبت فید جدید فراخوانی میکند. - سرور MCP منبع داده را ایجاد میکند و نام منبع منحصر به فرد آن را برمیگرداند.
- عامل، تابع
fetch_data_sourceرا فراخوانی میکند تا دانلود و پردازش فایل مرتبط را آغاز کند. - عامل
get_file_uploadرا برای نظارت بر پیشرفت آپلود و تأیید وضعیت پردازش موفقیتآمیز موارد، فراخوانی میکند.
ابزارها و توضیحات MCP
سرویس دسترسی MCP API فروشنده، ابزارهای زیر را در اختیار نماینده شما قرار میدهد:
| ابزار MCP | توضیحات |
|---|---|
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 | تنظیمات بهبود خودکار، از جمله بهروزرسانیهای اقلام، بهبود تصاویر و بهبودهای ارسال را دریافت کنید. |