دمج واجهة برمجة التطبيقات وCode Assist Toolkit

يمكنك استخدام "حزمة أدوات دمج واجهة برمجة التطبيقات والمساعدة في كتابة التعليمات البرمجية" لتسريع عملية نقل البيانات إلى Merchant API وإنشاء عمليات دمج جديدة باستخدام أدوات التطوير المستندة إلى الذكاء الاصطناعي.

نظرة عامة

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

  • ترجمة التعليمات البرمجية ونقلها: تساعدك هذه الأدوات في فهم التعليمات البرمجية القديمة في Content API for Shopping وتحويلها إلى تنسيق Merchant API الجديد. ويشمل ذلك ربط سمات المنتجات بالبنية الجديدة وتعديل ملفات إدارة التبعيات.
  • الخبرة في مستندات واجهة برمجة التطبيقات: تقدّم هذه الأدوات تفسيرات واضحة لموارد Merchant API وطُرقها وحقولها وحصصها وأفضل ممارساتها استنادًا إلى سياق موثوق من مستندات Google API الرسمية.
  • إنشاء التعليمات البرمجية: تنشئ هذه الأدوات مقتطفات تعليمات برمجية لمختلف مهام Merchant API بـ لغات مثل Python وJava وPHP ولغات أخرى.
  • تحديد المشاكل وحلّها: تساعد هذه الأدوات في تشخيص الأخطاء الشائعة في واجهة برمجة التطبيقات وتصحيحها.

اختَر الخيار الذي يناسب بيئة التطوير وحالة الاستخدام المحدّدة. استخدِم "حزمة أدوات دمج واجهة برمجة التطبيقات والمساعدة في كتابة التعليمات البرمجية" لتخصيص الإعداد بما يتوافق مع سير العمل المفضّل لديك:

يوضّح الرسم البياني التالي خيارات الإعداد لنقل التعليمات البرمجية بمساعدة الذكاء الاصطناعي في بيئات التطوير المتكاملة (IDEs) الأكثر استخدامًا، مثل Antigravity أو Visual Studio Code أو Cursor أو Copilot. يمكنك إعداد مساعدين في كتابة التعليمات البرمجية، مثل Gemini أو Claude أو ChatGPT أو Grok، وتزويدهم بخادم Model Context Protocol ‏(MCP) لمستندات المطوّرين في Merchant API أو مهارات الوكيل في Merchant API ليكونوا أكثر استنادًا إلى السياق مع زيادة سرعة الدمج.

(Merchant API) مخطط "مساعد الترميز المستنِد إلى الذكاء الاصطناعي" لعملية الدمج

خادم Model Context Protocol ‏(MCP) لمستندات المطوّرين في Merchant API

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

آلية العمل

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

مثال على سير العمل:

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

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

لدمج Model Context Protocol ‏(MCP) واستخدامه، اتّبِع الخطوات التالية:

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

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

2- ضبط نقطة النهاية

لربط بيئة التطوير المتكاملة (IDE) أو مساعد كتابة التعليمات البرمجية بـ Model Context Protocol ‏(MCP)، استخدِم تفاصيل نقطة النهاية البعيدة المقدَّمة التي قد تتطلب إدخال عنوان URL المباشر للخدمة أو تعريف Model Context Protocol ‏(MCP)، وذلك حسب إعدادات الأداة:

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

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- إضافة تعليمات الوكيل (اختياري)

لتمكين الوكيل من ترجمة التعليمات البرمجية مباشرةً باستخدام Model Context Protocol ‏(MCP)، زوِّده بالـ تعليمات النظام: بروتوكول وكيل دمج التجّار. توجّه هذه التعليمات الوكيل بشأن كيفية استخدام Model Context Protocol ‏(MCP) بشكل صحيح لترجمة التعليمات البرمجية. يمكنك تقديم هذه التعليمات للوكيل إما في إعدادات تعليمات النظام أو كملف سياق إضافي، وذلك حسب الأداة.

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

يمكن أن يسرّع Model Context Protocol ‏(MCP) سير العمل في حالات الاستخدام الشائعة التالية:

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

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

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

"نقل رمز products.insert البرمجي إلى Merchant API"

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

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

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

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

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

تقدّم خدمة Model Context Protocol ‏(MCP) سياقًا من أدلة النقل والمستندات المرجعية الرسمية، ما يتيح للمساعد الردّ بإجابة مفصّلة، بما في ذلك اسم واجهة برمجة التطبيقات الجديدة، accounts.issues.

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

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

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

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

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

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

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

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

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

تسترجع خدمة Model Context Protocol ‏(MCP) سياقًا من مستندات مورد المنتجات والأدلة ذات الصلة. يمكن للمساعد بعد ذلك شرح كيفية استخدام طريقة accounts.productInputs.insert وتقديم مورد المنتج الجزئي الذي يحتوي فقط على productId والحقول ذات الصلة بالمخزون التي تحتاج إلى تعديلها.

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

تسترجع خدمة Model Context Protocol ‏(MCP) سياقًا من أدلة المصادقة الرسمية التي تتناول طرق التفويض المختلفة. يمكن للمساعد بعد ذلك شرح الخيارات الأساسية المتاحة، مثل استخدام حساب خدمة للتفاعلات بين الخادم والخادم أو معرّف عميل OAuth 2.0 عند التصرّف نيابةً عن مستخدم.

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

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

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

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

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

السيناريو 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'"

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

مهارات الوكيل في Merchant API

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

تتوافق مهارات الوكيل في Merchant API مع مختلف أدوات سطر الأوامر وبيئات التطوير المتكاملة (IDEs) المستندة إلى الذكاء الاصطناعي، مثل أداة Antigravity لسطر الأوامر وClaude Code.

آلية العمل

تقدّم مهارات الوكيل في Merchant API حزمة خبرة متخصّصة تستند إلى معيار مهارات الوكيل المفتوح. تعمل مهارة الوكيل mapi-developer-assistant كطبقة ذكية بين أدوات تطوير الذكاء الاصطناعي وخادم Model Context Protocol ‏(MCP) لمستندات المطوّرين في Merchant API الأساسي. تتضمّن هذه المهارة خبرة في المجال وإرشادات إجرائية، ولها الخصائص التالية:

  • بدون إعداد: تدير هذه المهارة تلقائيًا اتصالات خادم Model Context Protocol ‏(MCP)، ما يزيل الحاجة إلى إعداد نقطة النهاية يدويًا.
  • سير عمل الخبراء: تحسّن هذه المهارة طلبات المستخدمين إلى طلبات بحث محسّنة لاسترجاع المعلومات الأكثر صلة بفعالية.
  • إدارة السياق وكفاءة الرموز المميّزة: تستخدم هذه المهارة ميزة "الكشف التدريجي" لتحميل المعلومات عند الطلب والحفاظ على نافذة سياق الذكاء الاصطناعي.
  • تنسيق محسّن للناتج: تقدّم هذه المهارة تعليمات لتنسيق وتنظيم الناتج من أجل الحصول على ردود قابلة للتنفيذ وقابلة للقراءة ومتّسقة.

مثال على سير العمل:

  1. تطرح سؤالاً عن Merchant API في أداة تطوير الذكاء الاصطناعي.
  2. تحلّل مهارة الوكيل في Merchant API هدفك وتصوغ طلب بحث دقيقًا وتطبّق معرفتها الإجرائية على الطلب.
  3. ترسل مهارة الوكيل طلبًا للحصول على السياق إلى خادم Model Context Protocol ‏(MCP) لمستندات المطوّرين في Merchant API الذي يقع على merchantapi.googleapis.com/devdocs/mcp/.
  4. تبحث خدمة Model Context Protocol ‏(MCP) في مجموعتها المفهرسة من مستندات Merchant API الرسمية والأدلة وعيّنات التعليمات البرمجية.
  5. يستفيد وكيل الذكاء الاصطناعي من هذه المعلومات لتقديم ردّ مُجمَّع وقابل للتنفيذ.

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

يقدّم ملف README الخاص بمهارات الوكيل في Merchant API إرشادات مفصّلة حول ما يلي:

  • المتطلبات الأساسية للأدوات، مثل أداة Antigravity لسطر الأوامر
  • تفعيل إمكانية استخدام مهارات الوكيل في الأداة التي تختارها
  • تثبيت مهارة mapi-developer-assistant من مستودع GitHub كما هو موضّح في ملف README
  • التحقّق من عملية التثبيت
  • الطلبات الأساسية لإدارة المهارات

للحصول على تعليمات مفصّلة حول التثبيت والإعداد لمختلف أدوات الذكاء الاصطناعي، بما في ذلك أداة Antigravity لسطر الأوامر وClaude Code وغيرها، اتّبِع الإرشادات الواردة في ملف README.

أمثلة على الطلبات

بعد تثبيت مهارة mapi-developer-assistant وتفعيلها في أدوات تطوير الذكاء الاصطناعي، يتم تفعيلها تلقائيًا عادةً عند طرح أسئلة متعلقة بـ Merchant API.

"كيف يمكنني إدراج منتج باستخدام Merchant API في Python؟"

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

"أرني مثالاً بلغة Java للتعامل مع المصادقة باستخدام Merchant API."

تظهر لي رسالة الخطأ "400: طلب غير صالح" مع خطأ في التحقّق من الصحة عند طلب productInputs.insert. كيف يمكنني حلّ هذه المشكلة؟"

ما هو الفرق بين ProductInput وProduct في Merchant API؟

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

تنشئ خدمة Model Context Protocol ‏(MCP) قاعدة معلوماتها حصريًا من المصادر العامة والرسمية لضمان دقة السياق الذي تقدّمه وموثوقيته. تفهرس الخدمة المحتوى الكامل لموقع المطوّرين الرسمي ومستودع عيّنات التعليمات البرمجية، بما في ذلك: