از سرویس دسترسی پروتکل زمینه مدل API فروشنده (MCP) برای دسترسی مجاز به دادهها و بینشهای مرکز فروشندگان خود استفاده کنید تا تجربیات جدید عاملیت و گردشهای کاری خودکار ایجاد کنید.
نمای کلی
سرویس دسترسی MCP API فروشنده، یک پل ارتباطی استاندارد و امن برای LLMها، نمایندگان و دستیاران کدنویسی فراهم میکند تا تجربیات جدید نمایندگی و گردشهای کاری خودکار مبتنی بر دادههای مرکز فروشنده را ایجاد و هماهنگ کنند.
به طور خاص، این امکان دسترسی مجاز به دادههای مرکز فروشندگان و گزارشها و بینشهای تولید شده توسط گوگل را برای انجام عملیات فقط خواندنی و نوشتن محدود فراهم میکند تا موارد استفادهای مانند موارد زیر را بررسی کند:
- تشخیص و رفع عدم تایید محصولات
- گزارشهای عملکرد و بینشها را ایجاد کنید
- گزینهی «بهبودهای خودکار» را بررسی کنید
- ایجاد و واکشی منابع داده
ایمنی و کنترل دسترسی
سرویس دسترسی MCP API فروشگاه با اولویت امنیت طراحی شده است:
- احراز هویت : اجرای ابزار توسط احراز هویت استاندارد Merchant API اداره میشود که نیازمند OAuth 2.0 یا اعتبارنامههای حساب کاربری سرویس است. توصیه میکنیم از اعتبارنامههایی با محدودترین حقوق دسترسی ممکن استفاده کنید.
- ایمنی اجرا : در حالی که قابلیت مشاهده ابزار برای کشف عامل محدود نشده است، اجرای ابزار به اعتبارنامههای API خاص شما محدود میشود.
- اقدامات حفاظتی : ابزارها به شدت به عملیات فقط خواندنی و ابزارهای نوشتن کمخطر (برای مثال، ایجاد منبع داده) به عنوان یک محافظ ایمنی محدود شدهاند.
ملاحظات مهم
سرویس دسترسی MCP API فروشگاه، یک نسخه آلفا است؛ دامنه و قابلیتهای آن گسترش یافته و ممکن است تغییر کند.
قبل از شروع، محدودیتها و بهترین شیوههای زیر را بررسی کنید:
تغییرات و نسخهها
تغییرات میتوانند بدون اطلاع قبلی رخ دهند و در یادداشتهای انتشار منتشر خواهند شد.
آزمایش ایمن
توصیه میکنیم قبل از استفاده از این ابزارها در یک محیط تولید زنده، ابتدا با استفاده از یک حساب آزمایشی یا یک حساب غیر زنده، آزمایش کنید.
سهمیه مشترک
سرویس دسترسی MCP API فروشنده، همان سهمیهای را که فراخوانیهای استاندارد API فروشنده شما دارد، به اشتراک میگذارد. عاملهای در حال اجرا میتوانند به سرعت سهمیه را تمام کنند، به خصوص برای واکشی منابع داده. ما اکیداً توصیه میکنیم برای جلوگیری از اختلالات سرویس تولید، از یک حساب آزمایشی استفاده کنید.
فیلتر کردن ابزار و ایمنی
قابلیتهای جدید، به ویژه اقدامات نوشتن، در آینده اضافه خواهند شد. ما اکیداً توصیه میکنیم که کلاینت خود را به طور صریح برای فیلتر کردن ابزار داخلی پیکربندی کنید تا اینکه کل مجموعه ابزارها را در معرض نمایش قرار دهید.
خلاصهای از قابلیتهای موجود
شما میتوانید از سرویس دسترسی MCP API مربوط به Merchant برای انجام اقدامات زیر به صورت عاملمحور استفاده کنید:
- وضعیت دقیق و زمینه گزارشدهی را برای محصولات خاص با استفاده از نام دقیق منابع بازیابی کنید .
- چندین محصول را فهرست و جستجو کنید .
- معیارهای عملکرد، وضعیت محصولات و بینشهایی در مورد محصولات محبوب، بینشهای قیمتگذاری، میزان رقابتپذیری و تجزیه و تحلیلهای همکاری در فروش یوتیوب را جستجو کنید .
- مشکلات سطح حساب کاربری که بر دیده شدن محصول یا مشارکت در برنامه تأثیر میگذارند را شناسایی کنید .
- فهرست کردن، ایجاد کردن، واکشی کردن و بررسی وضعیت آپلود منابع داده.
- دلایل کلی عدم تایید محصولات را در موجودی خود فهرست کنید .
- تنظیمات بهبود خودکار برای اقلام، تصاویر و ارسال را بررسی کنید .
- مناطق فعال، الزامات برآورده نشده و وضعیت مشارکت را برای برنامههای خاص مرکز بازرگانان بررسی کنید .
شروع به کار
برای اتصال IDE، دستیار کدنویسی یا عامل خود به سرویس دسترسی MCP API فروشنده، تنظیمات کلاینت MCP خود را بهروزرسانی کنید (برای مثال، mcp.json یا settings.json ).
پیکربندی کلاینت
تنظیمات پیکربندی:
ضد جاذبه
با استفاده از یک توکن دسترسی OAuth 2.0 (با دامنه https://www.googleapis.com/auth/content ) مستقیماً به نقطه پایانی MCP از راه دور میزبانی شده متصل شوید. دستورالعملهای موجود در مستندات Antigravity را دنبال کنید.
{
"mcpServers": {
"merchant-api-access": {
"serverUrl": "https://merchantapi.googleapis.com/mcp",
"headers": {
"Authorization": "Bearer {ACCESS_TOKEN}",
"x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
}
}
}
}
کلود سیالآی
با استفاده از دستور claude mcp add نقطه پایانی MCP از راه دور میزبانی شده را مستقیماً در Claude CLI اضافه کنید:
claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
--header "Authorization: Bearer {ACCESS_TOKEN}" \
--header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"
دستورالعملهای موجود در مستندات Claude MCP را دنبال کنید.
حلقه
درخواستهای استاندارد JSON-RPC 2.0 را مستقیماً به نقطه پایانی MCP API Merchant میزبان ارسال کنید.
فهرست ابزارهای موجود:
curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'
یک فراخوانی ابزار (برای مثال، list_data_sources ) را اجرا کنید:
curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "list_data_sources",
"arguments": {
"parent": "accounts/{ACCOUNT_ID}"
}
}
}'
موارد زیر را جایگزین کنید:
-
ACCOUNT_ID: شناسه مرکز فروش شما -
ACCESS_TOKEN: توکن مجوز برای برقراری فراخوانی API -
GOOGLE_CLOUD_PROJECT_ID: شناسه پروژه Google Cloud مرتبط با حساب مرکز فروش شما
سناریوهای استفاده نمونه
برای نشان دادن چگونگی بهرهگیری از سرویس دسترسی 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 | تنظیمات بهبود خودکار، از جمله بهروزرسانیهای اقلام، بهبود تصاویر و بهبودهای ارسال را دریافت کنید. |