يمكنك الحصول على معلومات سياقية حول 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 الرسمية وتعرضها كسياق لمساعد الترميز. يتيح ذلك لمساعدك تقديم إجابات دقيقة وحديثة بدون الحاجة إلى مغادرة بيئة التطوير.
آلية العمل
يتكامل دمج مستندات المطوّرين باستخدام MCP مع سير عمل حديث للتطوير بمساعدة الذكاء الاصطناعي، وذلك على النحو التالي:
- تطرح سؤالاً على مساعد الترميز أو الوكيل المتوافق مع MCP. يمكن أن يكون ذلك سؤالاً بلغة طبيعية أو طلبًا للحصول على عينة تعليمات برمجية من Merchant API أو حتى طلبًا لترجمة التعليمات البرمجية مباشرةً إلى Merchant API.
- يرسل مساعدك في البرمجة طلبًا للحصول على السياق إلى نقطة نهاية MCP.
- تبحث خدمة MCP في مجموعة المستندات والفيديوهات وعيّنات التعليمات البرمجية المفهرسة الخاصة بواجهة Merchant API الرسمية للعثور على المعلومات الأكثر صلة.
- تعرض الخدمة هذه المقتطفات الموثوقة كسياق لمساعد البرمجة.
- يستخدم مساعد البرمجة هذا السياق العالي الجودة لإنشاء ردّ دقيق ومفيد على سؤالك الأصلي أو لتنفيذ مهمة ترجمة الرموز البرمجية.
الخطوات الأولى
لاستخدام 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 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 في بناء قاعدة المعرفة الخاصة بها إلى مصادر عامة ورسمية فقط لضمان دقة السياق الذي توفّره وموثوقيته. تتضمّن الفهرسة التي تجريها الخدمة لكل محتوى الموقع الإلكتروني الرسمي للمطوّرين ومستودع عينات التعليمات البرمجية ما يلي:
- موقع "مطوّر واجهة Merchant API": يتضمّن جميع الأدلة والمواد المرجعية والمستندات.
- خدمة Merchant API في "برمجة تطبيقات Google": مثال على استخدام Merchant API من "برمجة تطبيقات Google".
- عيّنات التعليمات البرمجية الرسمية: جميع عيّنات التعليمات البرمجية الرسمية التي توفّرها Google لواجهة Merchant API من مستودع GitHub
- مكتبات العملاء: جميع مكتبات العملاء الرسمية التي يتيحها التاجر