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

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

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

نظرة عامة

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

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

آلية العمل

يتكامل دمج مستندات المطوّرين باستخدام 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"

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

لتفعيل إمكانية ترجمة الرمز البرمجي مباشرةً باستخدام MCP، يجب تزويد الوكيل بـ تعليمات النظام: وكيل MerchantIntegrator البروتوكول. توجّه هذه التعليمات موظف الدعم بشأن كيفية استخدام 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 في بناء قاعدة معلوماتها إلى مصادر عامة ورسمية فقط لضمان دقة السياق الذي توفّره وموثوقيته. تفهرس الخدمة المحتوى الكامل لموقع المطوّرين الرسمي ومستودع نماذج الرموز البرمجية، بما في ذلك:

السابق
Client libraries
التالي
Overview