مجموعة أدوات دمج واجهات برمجة التطبيقات وCode Assist باستخدام MCP

يمكنك الحصول على معلومات سياقية حول Merchant API من مساعد الترميز الذي تختاره. يمكنك الآن الوصول إلى عملية دمج مستندات المطوّرين ضمن بيئة التطوير المتكاملة (IDE) باستخدام خدمة Model Context Protocol (MCP). تسرّع هذه الخدمة عملية التطوير الخاصة بسير عمل الدمج ونقل البيانات من خلال تزويد مساعد الترميز بسياق موثوق به من مستندات Google API الرسمية.

لمزيد من المعلومات عن البروتوكول نفسه، اطّلِع على معيار Model Context Protocol.

نظرة عامة

عند نقل البيانات من Content API for Shopping إلى Merchant API أو إنشاء عملية دمج جديدة، عليك فهم بنى الخدمات وأسماء الموارد والطرق الجديدة. تسهّل خدمة MCP هذه العملية من خلال توفير مستندات رسمية وعيّنات من الرموز البرمجية لمساعد الترميز.

تستخدم الخدمة نظامًا خلفيًا عالي التخصّص للتوليد المعزّز بالاسترجاع (RAG). عندما تطرح سؤالاً على مساعد الترميز في بيئة التطوير المتكاملة (IDE) المفعَّلة من خلال MCP بشأن Merchant API، تسترجع الخدمة مقتطفات النص والرمز الأكثر صلة من مراجع Google الرسمية وتعرضها كسياق لمساعد الترميز. يتيح ذلك للمساعد تقديم إجابات دقيقة وحديثة بدون الحاجة إلى مغادرة بيئة التطوير.

آلية العمل

يتكامل دمج مستندات المطوّرين باستخدام بروتوكول Model Context Protocol (MCP) مع سير عمل حديث للتطوير بمساعدة الذكاء الاصطناعي:

  1. تطرح سؤالاً على مساعد الترميز أو الوكيل المتوافق مع MCP. يمكن أن يكون ذلك سؤالاً بلغة طبيعية أو طلبًا للحصول على عينة تعليمات برمجية من Merchant API أو حتى طلبًا لترجمة التعليمات البرمجية مباشرةً إلى Merchant API.
  2. يرسل مساعدك في البرمجة طلبًا للحصول على السياق إلى نقطة نهاية MCP.
  3. تبحث خدمة MCP في مجموعة المستندات والفيديوهات وعيّنات التعليمات البرمجية المفهرسة الخاصة بواجهة Merchant API الرسمية للعثور على المعلومات الأكثر صلة.
  4. تعرض الخدمة هذه المقتطفات الموثوقة كسياق لمساعد البرمجة.
  5. يستخدم مساعد البرمجة هذا السياق العالي الجودة لإنشاء ردّ دقيق ومفيد على سؤالك الأصلي أو لتنفيذ مهمة ترجمة الرمز البرمجي.

الخطوات الأولى

لاستخدام MCP، اتّبِع الخطوات التالية:

1. استخدام أداة متوافقة

افتح بيئة تطوير متكاملة (IDE) أو مساعدًا للترميز يتوافق مع بروتوكول Model Context Protocol مع نقل HTTP قابل للبث.

2. إعدادات نقطة النهاية

لربط بيئة التطوير المتكاملة أو مساعد الترميز ببروتوكول MCP، استخدِم تفاصيل نقطة النهاية البعيدة المقدَّمة التي قد تتطلّب منك إدخال عنوان URL للخدمة المباشرة أو تعريف MCP (حسب إعدادات أداتك).

عنوان URL للخدمة هو:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

عمليات إعداد الضبط:

Antigravity

اتّبِع التعليمات الواردة في مستندات Antigravity.

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

Visual Studio Code

اتّبِع التعليمات الواردة في مستندات Visual Studio Code.

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

‫3. إضافة تعليمات الوكيل (اختياري)

لتمكين وكيلك من ترجمة الرموز البرمجية مباشرةً باستخدام MCP، عليك تزويده بتعليمات النظام: بروتوكول MerchantIntegrator Agent. توجّه هذه التعليمات الوكيل بشأن كيفية استخدام MCP بشكل صحيح لترجمة الرموز. بناءً على الأداة التي تستخدمها، يمكنك تقديم هذه التعليمات إما في إعدادات تعليمات النظام أو كملف سياق إضافي للوكيل.

أمثلة على سيناريوهات الاستخدام

يمكن أن تساعدك ميزة "التحويل المتزامن" في تسريع سير عملك في حالات الاستخدام الشائعة التالية.

السيناريو 1: نقل الرمز products.insert

يمكنك أن تطلب من الموظف نقل رمز دمج Content API for Shopping products.insert إلى Merchant API مباشرةً.

طلب المستخدم:

"نقل رمز products.insert إلى Merchant API"

من خلال تزويد الوكيل بتعليمات النظام: وكيل MerchantIntegrator البروتوكول والوصول إلى MCP، يمكن للوكيل ترجمة رمز Content API for Shopping إلى رمز Merchant API مباشرةً في بيئة التطوير المتكاملة. في هذه الحالة، سيتم تحديد productInputs.insert باعتباره الطلب المكافئ، وسيتم ربط سمات المنتج من التنسيق القديم بالتنسيق الجديد المطلوب من Merchant API. يمكنه أيضًا تعديل عمليات الاستيراد المطلوبة وملف إدارة التبعيات (مثل requirements.txt أو pom.xml أو package.json). يمكنك توجيه الوكيل لتنفيذ التغييرات في مكانها أو إنشاء مجلد جديد.

السيناريو 2: العثور على وظيفة مكافئة

لديك تطبيق حالي يستخدم Content API for Shopping وعليك تعديله. يمكنك طرح أسئلة حول طريقة قديمة معيّنة للحصول على تفاصيل حول عملية التنفيذ الجديدة وعينة تعليمات برمجية ذات صلة.

طلب المستخدم:

"ما هو المكافئ لواجهة Merchant API لطريقة accountstatuses.get في Content API for Shopping؟"

تقدّم خدمة MCP سياقًا من أدلة نقل البيانات الرسمية والمستندات المرجعية، ما يتيح للمساعد الرد بإجابة مفصّلة تتضمّن اسم واجهة برمجة التطبيقات الجديدة، accounts.issues.

السيناريو 3: العثور على عينة تعليمات برمجية

أنت بصدد تنفيذ ميزة جديدة وتحتاج إلى مثال عملي لتتبُّعه.

طلب المستخدم:

أريد عينة تعليمات برمجية بلغة Python لإضافة خدمة شحن جديدة باستخدام Merchant API.

تسترد خدمة MCP عيّنات التعليمات البرمجية ذات الصلة من مستودعات Google الرسمية على GitHub وأدلة المطوّرين. يمكن للمساعد بعد ذلك عرض مجموعة رموز كاملة وجاهزة للتعديل.

السيناريو 4: فهم مفاهيم واجهة برمجة التطبيقات

عندما تصادف مفهومًا جديدًا أو تريد فهم بنية أحد المراجع أو النمط العام لواجهة Merchant API.

طلب المستخدم:

"كيف يمكنني تعديل مستودع منتج باستخدام Merchant API؟"

تعرض خدمة MCP السياق من مستندات موارد المنتجات والأدلّة ذات الصلة. يمكن أن يوضّح لك المساعد بعد ذلك كيفية استخدام طريقة accounts.productInputs.insert ويقدّم مورد المنتج الجزئي الذي يحتوي على productId والحقول ذات الصلة بالمستودع فقط والتي تحتاج إلى تعديلها.

"كيف يمكنني السماح لطلبات التطبيق باستخدام Merchant API؟"

تسترد خدمة MCP السياق من أدلة المصادقة الرسمية التي تغطي طرق الترخيص المختلفة. يمكن أن يوضّح لك المساعد بعد ذلك الخيارات الأساسية المتاحة، مثل استخدام حساب خدمة للتفاعلات بين الخادم والخادم أو معرّف عميل OAuth 2.0 عند العمل نيابةً عن مستخدم.

السيناريو 5: التكيّف مع التغييرات في واجهة برمجة التطبيقات

تتضمّن Merchant API أنماطًا جديدة، مثل تجميع الطلبات، تختلف عن Content API for Shopping. تستخدِم واجهة Content API for Shopping طرقًا custombatch محدّدة، بينما تستخدِم واجهة Merchant API ميزة مدمجة وعامة لتجميع طلبات HTTP.

طلب المستخدم:

"ما هي الطريقة الجديدة لتنفيذ products.custombatch في Merchant API؟"

تستردّ خدمة MCP السياق من إعادة تصميم الرمز البرمجي للطلبات المتزامنة موضّحةً أنّ طرق custombatch المخصّصة غير متوفّرة في Merchant API. بدلاً من ذلك، يقدّم هذا المستند معلومات حول استخدام تجميع HTTP مع قيمة Content-Type تبلغ multipart. يمكن للمساعد بعد ذلك أن يشرح لك كيفية إنشاء طلب HTTP واحد يتضمّن طلبات متعددة من واجهة برمجة التطبيقات، ويتم إرساله إلى نقطة النهاية https://merchantapi.googleapis.com/batch/{sub-api}/v1، كما يمكنه تقديم مثال على كيفية تنظيم الطلب المتعدد الأجزاء. ويحوّل ذلك مهمة نقل البيانات التي قد تكون مربكة إلى عملية إرشادية.

السيناريو 6: ترجمة طلب بحث لإعداد التقارير

يمكنك أن تطلب من الوكيل ترجمة طلب بحث عن تقرير من Content API for Shopping إلى Merchant API.

طلب المستخدم:

"نقل طلب البحث الخاص بإعداد التقارير هذا من Content API إلى Merchant API: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

تستردّ خدمة MCP أحدث مستندات مرجعية لإعداد التقارير وأدلّة المطوّرين وأدلّة نقل البيانات. واستنادًا إلى هذه المعلومات، يتم تحويل طلب البحث إلى البنية الجديدة وتعديل الحقول إلى أسمائها وقيمها الجديدة.

مصادر قاعدة المعلومات

تستند خدمة MCP في بناء قاعدة المعرفة لديها إلى مصادر عامة ورسمية فقط لضمان دقة السياق الذي توفّره وموثوقيته. تُفهرس الخدمة المحتوى الكامل للموقع الإلكتروني الرسمي للمطوّرين ومستودع عينات الرموز البرمجية، بما في ذلك: