ابزار یکپارچه‌سازی API و کمک به کدنویسی

از ابزار یکپارچه‌سازی API و Code Assist Toolkit برای تسریع مهاجرت به Merchant API و ایجاد یکپارچه‌سازی‌های جدید با ابزارهای توسعه مبتنی بر هوش مصنوعی استفاده کنید.

نمای کلی

هنگام مهاجرت از API محتوا برای خرید به API فروشنده یا ایجاد یک ادغام جدید، باید ساختارهای سرویس جدید، نام منابع و روش‌ها را درک کنید. ابزارهای توسعه مبتنی بر هوش مصنوعی به ویژه برای کمک به عملیات زیر مناسب هستند:

  • ترجمه و انتقال کد : به شما کمک می‌کند تا کد قدیمی Content API for Shopping را درک کرده و آن را به فرمت جدید Merchant API تبدیل کنید. این شامل نگاشت ویژگی‌های محصول به ساختار جدید و به‌روزرسانی فایل‌های مدیریت وابستگی می‌شود.
  • تخصص در مستندسازی API : توضیحات روشنی در مورد منابع، روش‌ها، فیلدها، سهمیه‌ها و بهترین شیوه‌های API فروشگاه بر اساس متون معتبر از مستندات رسمی API گوگل ارائه می‌دهد.
  • تولید کد : قطعه کدهایی را برای وظایف مختلف رابط برنامه‌نویسی کاربردی (API) فروشگاه به زبان‌هایی از جمله پایتون، جاوا، PHP و سایر زبان‌ها تولید می‌کند.
  • عیب‌یابی : به تشخیص و رفع خطاهای رایج API کمک می‌کند.

گزینه‌ای را انتخاب کنید که به بهترین وجه با محیط توسعه و مورد استفاده خاص شما مطابقت داشته باشد. از ابزار یکپارچه‌سازی API و Code Assist Toolkit برای تنظیم تنظیمات با گردش کار دلخواه خود استفاده کنید:

نمودار زیر گزینه‌های راه‌اندازی برای مهاجرت کد با کمک هوش مصنوعی را در رایج‌ترین محیط‌های توسعه یکپارچه (IDE) مانند Antigravity، Visual Studio Code، Cursor یا Copilot نشان می‌دهد. می‌توان دستیارهای کدنویسی مانند Gemini، Claude، ChatGPT، Grok را راه‌اندازی کرد و آنها را با سرور Merchant API Developer Documentation MCP یا Merchant API Agent Skills توانمند ساخت تا ضمن افزایش سرعت ادغام، پایه‌های بیشتری داشته باشند.

(Merchant API) AI Integration Code Assist diagram

مستندات توسعه‌دهنده‌ی رابط برنامه‌نویسی کاربردی فروشگاه (MCP Server)

از دستیار کدنویسی مورد نظر خود، اطلاعات زمینه‌ای در مورد API فروشنده دریافت کنید. اکنون می‌توانید در IDE خود با استفاده از سرویس Model Context Protocol (MCP) به اسناد توسعه‌دهنده دسترسی پیدا کنید. این سرویس اطلاعات کلیدی دستیار کدنویسی شما را از اسناد رسمی Google API دریافت می‌کند. برای اطلاعات بیشتر در مورد خود پروتکل، به استاندارد Model Context Protocol مراجعه کنید.

چگونه کار می‌کند؟

وقتی از دستیار کدنویسی IDE مجهز به MCP خود سوالی در مورد Merchant API می‌پرسید، این سرویس مرتبط‌ترین قطعه‌های متن و کد را از منابع رسمی بازیابی می‌کند و آنها را به عنوان زمینه با استفاده از یک backend تخصصی Retrieval-Augmented Generation (RAG) به دستیار کدنویسی شما بازمی‌گرداند. سیستم RAG سیستمی است که با اتصال LLMها به منابع دانش خارجی و به‌روز، کیفیت پاسخ‌های آنها را بهبود می‌بخشد. این امر دستیار شما را قادر می‌سازد تا بدون نیاز به ترک محیط توسعه، پاسخ‌های دقیق و به‌روز ارائه دهد.

نمونه گردش کار:

  1. شما در دستیار کدنویسی یا عامل کدنویسی سازگار با MCP خود سوالی می‌پرسید (مثلاً سوال زبان طبیعی، درخواست نمونه کد یا ترجمه کد).
  2. دستیار کدنویسی شما درخواستی برای دریافت اطلاعات به نقطه پایانی MCP ارسال می‌کند.
  3. سرویس MCP مجموعه فهرست‌بندی‌شده خود از اسناد، راهنماها و نمونه‌های کد رسمی رابط برنامه‌نویسی کاربردی فروشندگان (Merchant API) را جستجو می‌کند.
  4. این سرویس، قطعه کدهای معتبر را به عنوان متن به دستیار کدنویسی شما برمی‌گرداند.
  5. دستیار کدنویسی شما از این زمینه برای تولید یک پاسخ پایه یا یک کار ترجمه کد استفاده می‌کند.

شروع به کار

برای ادغام و استفاده از MCP، مراحل زیر را دنبال کنید:

۱. از یک ابزار سازگار استفاده کنید

یک IDE یا دستیار کدنویسی باز کنید که از پروتکل Model Context با انتقال HTTP قابل پخش پشتیبانی کند.

۲. پیکربندی نقطه پایانی

برای اتصال IDE یا دستیار کدنویسی خود به MCP، از جزئیات نقطه پایانی از راه دور ارائه شده استفاده کنید که ممکن است بسته به پیکربندی ابزار شما، نیاز به وارد کردن URL مستقیم سرویس یا تعریف MCP داشته باشد:

تنظیمات پیکربندی:

ضد جاذبه

دستورالعمل‌های موجود در مستندات Antigravity را دنبال کنید.

"mcpServers": {
  "mapi-devdocs": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://merchantapi.googleapis.com/devdocs/mcp"
    ]
  }
}

ویژوال استودیو کد

دستورالعمل‌های موجود در مستندات ویژوال استودیو کد را دنبال کنید.

"servers": {
"mapi-devdocs": {
  "type": "http",
  "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
  }
}

۳. دستورالعمل‌های اپراتور را اضافه کنید (اختیاری)

برای اینکه عامل شما بتواند مستقیماً با استفاده از MCP کد را ترجمه کند، دستورالعمل‌های سیستم: پروتکل عامل یکپارچه‌ساز فروشنده را در اختیار آن قرار دهید. این دستورالعمل‌ها، عامل را در مورد نحوه استفاده صحیح از MCP برای ترجمه کد راهنمایی می‌کنند. بسته به ابزار شما، می‌توانید این دستورالعمل‌ها را یا در پیکربندی دستورالعمل‌های سیستم یا به عنوان یک فایل زمینه اضافی برای عامل ارائه دهید.

سناریوهای استفاده نمونه

MCP می‌تواند گردش کار شما را در موارد استفاده رایج زیر تسریع کند:

سناریو ۱: انتقال کد products.insert

می‌توانید از نماینده بخواهید که مستقیماً یک API محتوا برای products.insert فروشگاه را منتقل کند. کد ادغام را به API فروشنده وارد کنید.

درخواست کاربر:

"کد products.insert را به رابط برنامه‌نویسی کاربردی فروشگاه منتقل کنید"

با ارائه دستورالعمل‌های سیستمی و دسترسی به MCP به نماینده شما، نماینده شما می‌تواند کد Content API for Shopping را مستقیماً در IDE شما به کد Merchant API ترجمه کند. در این حالت، productInputs.insert به عنوان فراخوانی معادل شناسایی کرده و ویژگی‌های محصول را از قالب قدیمی به قالب جدید مورد نیاز Merchant API نگاشت می‌کند. همچنین می‌تواند فایل‌های import و مدیریت وابستگی مورد نیاز (به عنوان مثال requirements.txt ، pom.xml یا package.json ) را به‌روزرسانی کند. می‌توانید به نماینده دستور دهید که تغییرات را در محل انجام دهد یا یک پوشه جدید ایجاد کند.

سناریو ۲: یافتن قابلیت‌های معادل

شما یک برنامه موجود دارید که از API محتوا برای خرید استفاده می‌کند و نیاز به به‌روزرسانی آن دارید. می‌توانید در مورد یک روش قدیمی خاص سوال کنید تا جزئیات پیاده‌سازی جدید و نمونه کد مربوطه را دریافت کنید.

درخواست کاربر:

«معادل API فروشنده برای متد accountstatuses.get در API محتوا برای خرید چیست؟»

سرویس MCP زمینه‌ای از راهنماهای رسمی مهاجرت و مستندات مرجع ارائه می‌دهد و به دستیار شما اجازه می‌دهد تا با یک پاسخ دقیق، از جمله نام API جدید، accounts.issues پاسخ دهد.

سناریو ۳: پیدا کردن یک نمونه کد

شما در حال پیاده‌سازی یک ویژگی جدید هستید و به یک مثال عملی برای دنبال کردن نیاز دارید.

درخواست کاربر:

«یک نمونه کد پایتون برای افزودن یک سرویس حمل و نقل جدید با استفاده از Merchant API به من نشان دهید.»

سرویس MCP نمونه‌های کد مربوطه را از مخازن رسمی گوگل گیت‌هاب و راهنماهای توسعه‌دهندگان بازیابی می‌کند. سپس دستیار شما می‌تواند یک بلوک کد کامل و آماده برای تطبیق ارائه دهد.

سناریو ۴: درک مفاهیم API

شما با یک مفهوم جدید روبرو می‌شوید یا می‌خواهید ساختار یک منبع یا الگوی کلی Merchant API را درک کنید.

درخواست کاربر:

«چگونه می‌توانم موجودی یک محصول را با استفاده از رابط برنامه‌نویسی کاربردی فروشنده به‌روزرسانی کنم؟»

سرویس MCP زمینه را از مستندات منابع محصولات و راهنماهای مربوطه برمی‌گرداند. سپس دستیار شما می‌تواند نحوه استفاده از متد accounts.productInputs.insert را توضیح دهد و منبع جزئی محصول را که فقط شامل productId و فیلدهای مربوط به موجودی است که باید به‌روزرسانی کنید، ارائه دهد.

«چگونه می‌توانم تماس‌های برنامه‌ام را با رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) تأیید کنم؟»

سرویس MCP اطلاعات را از راهنماهای رسمی احراز هویت که روش‌های مختلف احراز هویت را پوشش می‌دهند، بازیابی می‌کند. سپس دستیار شما می‌تواند گزینه‌های اصلی موجود، مانند استفاده از یک حساب کاربری سرویس برای تعاملات سرور به سرور یا یک شناسه کلاینت OAuth 2.0 هنگام اقدام از طرف یک کاربر، را توضیح دهد.

سناریوی ۵: سازگاری با تغییرات API

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) الگوهای جدیدی - مانند درخواست‌های دسته‌ای - را معرفی می‌کند که با رابط برنامه‌نویسی کاربردی محتوا (Content API) برای خرید (Shopping) متفاوت است. رابط برنامه‌نویسی کاربردی محتوا (Content API) برای خرید از روش‌های custombatch خاص استفاده می‌کند، در حالی که رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) از یک ویژگی دسته‌ای عمومی و داخلی HTTP استفاده می‌کند.

درخواست کاربر:

«روش جدید برای انجام products.custombatch در Merchant API چیست؟»

سرویس MCP برای درخواست‌های همزمان، زمینه را از کد Refactor بازیابی می‌کند و توضیح می‌دهد که روش‌های custombatch اختصاصی در Merchant API وجود ندارند. در عوض، مستنداتی در مورد استفاده از HTTP batching با Content-Type از نوع multipart ارائه می‌دهد. سپس دستیار شما می‌تواند نحوه ساخت یک درخواست HTTP واحد حاوی چندین فراخوانی API را که به نقطه پایانی https://merchantapi.googleapis.com/batch/{sub-api}/v1 ارسال می‌شود، توضیح دهد و مثالی از نحوه ساختاردهی درخواست multipart ارائه دهد. این امر یک وظیفه مهاجرت بالقوه گیج‌کننده را به یک فرآیند هدایت‌شده تبدیل می‌کند.

سناریو ۶: ترجمه یک کوئری گزارش‌دهی

می‌توانید از نماینده بخواهید که یک کوئری گزارش‌دهی را از API محتوا برای خرید به API فروشنده ترجمه کند.

درخواست کاربر:

«این کوئری گزارش‌دهی را از API محتوا به API فروشنده منتقل کنید: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date بین '2020-12-01' و '2020-12-30'»

سرویس MCP جدیدترین مستندات مرجع گزارش‌دهی، راهنماهای توسعه‌دهندگان و راهنماهای مهاجرت را بازیابی می‌کند. بر اساس این اطلاعات، پرس‌وجو را به ساختار جدید تبدیل کرده و فیلدها را با نام‌ها و مقادیر جدیدشان به‌روزرسانی می‌کند.

مهارت‌های نماینده API فروشگاه

مشخصات مهارت‌های عامل (Agent Skills) یک استاندارد باز است که در ابزارهای توسعه هوش مصنوعی به کار گرفته شده است. از مهارت‌های عامل برای بهبود تجربه توسعه‌دهنده خود و بهینه‌سازی هر دو، با مهاجرت از API محتوا برای خرید و ایجاد ادغام‌های جدید، استفاده کنید. مهارت‌های عامل API فروشنده، دانش و ابزارهای خاص دامنه را برای افزایش قابلیت‌های عامل‌های هوش مصنوعی بسته‌بندی می‌کند و کمک‌های تخصصی و مورد نیاز را برای پرس‌وجوهای مستندسازی، تولید کد و عیب‌یابی ارائه می‌دهد.

مهارت‌های عامل API فروشنده با ابزارهای خط فرمان و IDEهای مختلف مبتنی بر هوش مصنوعی مانند Gemini و Claude Code سازگار است.

چگونه کار می‌کند؟

مهارت‌های عامل API فروشنده، یک بسته تخصصی مبتنی بر استاندارد مهارت‌های عامل باز ارائه می‌دهد. مهارت عامل ما mapi-developer-assistant به عنوان یک لایه هوشمند بین ابزارهای توسعه هوش مصنوعی شما و سرور MCP توسعه‌دهنده API فروشنده عمل می‌کند. این بسته، تخصص دامنه و راهنمایی رویه‌ای را در خود جای داده و دارای ویژگی‌های زیر است:

  • بدون نیاز به پیکربندی : به طور خودکار اتصالات سرور MCP را مدیریت می‌کند و نیاز به تنظیم دستی نقطه پایانی را از بین می‌برد.
  • گردش‌های کاری تخصصی : درخواست‌های کاربر را به پرس‌وجوهای بهینه‌شده تبدیل می‌کند تا مرتبط‌ترین اطلاعات را به‌طور مؤثر دریافت کند.
  • مدیریت زمینه و کارایی توکن : از «افشای تدریجی» برای بارگذاری اطلاعات بر اساس تقاضا و حفظ پنجره زمینه هوش مصنوعی استفاده می‌کند.
  • قالب‌بندی خروجی بهبود یافته : دستورالعمل‌هایی برای قالب‌بندی و ساختاردهی خروجی برای پاسخ‌های عملی، خوانا و سازگار ارائه می‌دهد.

نمونه گردش کار:

  1. شما در یک ابزار توسعه هوش مصنوعی، سوالی در مورد رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) می‌پرسید.
  2. مهارت عامل API فروشنده، هدف شما را تجزیه و تحلیل می‌کند، یک پرس و جو دقیق را تدوین می‌کند و دانش رویه‌ای خود را بر روی درخواست اعمال می‌کند.
  3. مهارت عامل، درخواستی برای دریافت اطلاعات به سرور MCP توسعه‌دهنده API فروشنده واقع در merchantapi.googleapis.com/devdocs/mcp/ ارسال می‌کند.
  4. سرویس MCP مجموعه فهرست‌بندی‌شده خود از اسناد، راهنماها و نمونه‌های کد رسمی رابط برنامه‌نویسی کاربردی فروشندگان (Merchant API) را جستجو می‌کند.
  5. عامل هوش مصنوعی شما از این اطلاعات برای ارائه یک پاسخ ترکیبی و عملی استفاده می‌کند.

شروع به کار

فایل README مهارت‌های عامل رابط برنامه‌نویسی کاربردی فروشنده، راهنمایی گام به گام در موارد زیر ارائه می‌دهد:

  • پیش‌نیازهای ابزارهایی مانند ابزار خط فرمان Gemini.
  • فعال کردن پشتیبانی مهارت‌های عامل (Agent Skills) در ابزار انتخابی شما.
  • نصب مهارت mapi-developer-assistant از مخزن GitHub طبق راهنمای README.
  • تأیید نصب.
  • دستورات مدیریت مهارت پایه.

برای دستورالعمل‌های دقیق نصب و راه‌اندازی ابزارهای مختلف هوش مصنوعی، از جمله ابزار خط فرمان Gemini، Claude Code و موارد دیگر، راهنمایی‌های موجود در فایل README را دنبال کنید.

مثال‌های پیشنهادی

پس از نصب و فعال‌سازی در ابزارهای توسعه هوش مصنوعی، مهارت mapi-developer-assistant معمولاً هنگام پرسیدن سؤالات مربوط به API فروشنده، به‌طور خودکار فعال می‌شود.

"چگونه می‌توانم با استفاده از Merchant API در پایتون، یک محصول درج کنم؟"

«معادل متد accountstatuses.get در رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) چیست؟»

«یک مثال جاوا برای مدیریت احراز هویت با رابط برنامه‌نویسی کاربردی فروشنده به من نشان دهید.»

«هنگام فراخوانی تابع productInputs.insert ، خطای «400 Bad Request» به همراه خطای اعتبارسنجی دریافت می‌کنم. چگونه می‌توانم این مشکل را برطرف کنم؟»

«تفاوت بین ProductInput و Product در Merchant API چیست؟»

منابع پایگاه دانش

سرویس MCP پایگاه دانش خود را منحصراً از منابع عمومی و رسمی می‌سازد تا اطمینان حاصل شود که محتوایی که ارائه می‌دهد دقیق و قابل اعتماد است. این سرویس کل محتوای سایت رسمی توسعه‌دهنده و مخزن نمونه کد، از جمله موارد زیر را فهرست‌بندی می‌کند: