يمكنك الحصول على معلومات سياقية حول 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 مع سير عمل حديث للتطوير مستند إلى الذكاء الاصطناعي:
- تطرح سؤالاً على مساعد الترميز أو الوكيل المتوافق مع MCP. يمكن أن يكون هذا السؤال بلغة طبيعية أو طلبًا للحصول على عينة تعليمات برمجية لتنفيذ طرق Merchant API.
- يرسل مساعدك في البرمجة طلبًا للحصول على السياق إلى نقطة نهاية MCP.
- تبحث خدمة MCP في مجموعتها المفهرسة من مستندات وأدلة وأمثلة الرموز البرمجية الرسمية الخاصة بواجهة Merchant API للعثور على المعلومات الأكثر صلة.
- تعرض الخدمة هذه المقتطفات الموثوقة كسياق لمساعد البرمجة.
- يستخدم مساعد البرمجة هذا السياق العالي الجودة لإنشاء إجابة دقيقة ومفيدة عن سؤالك الأصلي.
الخطوات الأولى
لاستخدام MCP، يجب أن يكون لديك بيئة تطوير متكاملة (IDE) أو مساعد ترميز يتوافق مع بروتوكول سياق النموذج مع نقل HTTP قابل للبث.
إعدادات نقطة النهاية
لربط أداتك بالخدمة، استخدِم تفاصيل نقطة النهاية البعيدة المقدَّمة، والتي قد تتطلّب منك إدخال عنوان URL المباشر للخدمة أو تعريف MCP، وذلك حسب إعدادات أداتك.
عنوان URL للخدمة هو:
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
أمثلة على سيناريوهات الاستخدام
يمكن أن تساعدك ميزة "التحويل المتزامن" في تسريع سير عملك في حالات الاستخدام الشائعة التالية.
السيناريو 1: نقل طلب بيانات قديم من واجهة برمجة التطبيقات
لديك تطبيق حالي يستخدم Content API for Shopping وتحتاج إلى تعديله. يمكنك طرح أسئلة حول طريقة قديمة معيّنة للحصول على تفاصيل حول عملية التنفيذ الجديدة ونموذج رمز برمجي ذي صلة.
طلب المستخدم:
"ما هو المكافئ لواجهة Merchant API لطريقة accountstatuses.get في Content API for Shopping؟"
توفّر خدمة MCP سياقًا من أدلة نقل البيانات الرسمية والمستندات المرجعية، ما يتيح للمساعد تقديم إجابة مفصّلة، بما في ذلك اسم واجهة برمجة التطبيقات الجديدة، accounts.issues.
السيناريو 2: العثور على عيّنة تعليمات برمجية
أنت بصدد تنفيذ ميزة جديدة وتحتاج إلى مثال عملي لتتبعه.
طلب المستخدم:
"أريد الحصول على نموذج رمز برمجي بلغة Python لإضافة خدمة شحن جديدة باستخدام Merchant API".
تسترد خدمة MCP عيّنات التعليمات البرمجية ذات الصلة من مستودعات Google الرسمية على GitHub وأدلة المطوّرين. يمكن للمساعد بعد ذلك عرض مجموعة رموز كاملة وجاهزة للتعديل.
السيناريو 3: فهم مفاهيم واجهة برمجة التطبيقات
تتعرّف على مفهوم جديد أو تريد فهم بنية أحد المراجع أو النمط العام لواجهة Merchant API.
طلب المستخدم:
"كيف يمكنني تعديل مستودع منتج باستخدام Merchant API؟"
تعرض خدمة MCP السياق من مستندات موارد المنتجات والأدلّة ذات الصلة. يمكن أن يوضّح لك المساعد بعد ذلك كيفية استخدام طريقة
accounts.productInputs.insert ويقدّم مصدر المنتج الجزئي
الذي يحتوي على productId والحقول ذات الصلة بالمستودع التي تحتاج إلى تعديلها.
"كيف يمكنني السماح لتطبيقي بإجراء طلبات باستخدام Merchant API؟"
تسترد خدمة MCP السياق من أدلة المصادقة الرسمية التي تغطي طرق التفويض المختلفة. يمكن أن يوضّح لك مساعدك بعد ذلك الخيارات الأساسية المتاحة، مثل استخدام حساب خدمة للتفاعلات بين الخادم والخادم أو معرّف عميل OAuth 2.0 عند العمل نيابةً عن مستخدم.
السيناريو 4: التكيّف مع التغييرات في واجهة برمجة التطبيقات
تتضمّن 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، كما يمكنه تقديم مثال على كيفية تنظيم الطلب المتعدد الأجزاء. ويحوّل ذلك مهمة نقل البيانات التي قد تكون مربكة إلى عملية إرشادية.
مصادر قاعدة المعلومات
تستند خدمة MCP في بناء قاعدة معلوماتها إلى مصادر عامة ورسمية فقط لضمان دقة السياق الذي توفّره وموثوقيته. تفهرس الخدمة المحتوى الكامل لموقع المطوّرين الرسمي ومستودع نماذج الرموز البرمجية، بما في ذلك:
- موقع "مطوّرو Merchant API": يتضمّن جميع الأدلة والمواد المرجعية والمستندات.
- خدمة Merchant API في "برمجة تطبيقات Google": مثال على استخدام Merchant API من خلال "برمجة تطبيقات Google"
- عينات التعليمات البرمجية الرسمية: جميع عينات التعليمات البرمجية الرسمية التي توفّرها Google لواجهة Merchant API من مستودع GitHub.
- مكتبات العملاء: جميع مكتبات العملاء الرسمية التي يتيحها التاجر