دمج واجهة برمجة التطبيقات و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، وتزويدهم بخادم بروتوكول سياق النموذج (MCP) لمستندات المطوّرين في Merchant API أو مهارات وكيل Merchant API ليكونوا أكثر استنادًا إلى الحقائق مع زيادة سرعة عمليات الدمج.

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

خادم بروتوكول سياق النموذج (MCP) لمستندات المطوّرين في Merchant API

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

آلية العمل

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

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

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

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

لدمج بروتوكول سياق النموذج (MCP واستخدامه، اتّبِع الخطوات التالية:

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

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

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

لربط بيئة التطوير المتكاملة (IDE) أو مساعد كتابة التعليمات البرمجية ببروتوكول سياق النموذج (MCP)، استخدِم تفاصيل نقطة النهاية البعيدة المقدَّمة التي قد تتطلب منك إدخال عنوان URL المباشر للخدمة أو تعريف بروتوكول سياق النموذج (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- إضافة تعليمات الوكيل (اختياري)

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

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

يمكن أن يسرّع بروتوكول سياق النموذج (MCP) سير عملك في حالات الاستخدام الشائعة التالية:

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

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

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

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

من خلال تزويد الوكيل بتعليمات النظام وإمكانية الوصول إلى بروتوكول سياق النموذج (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؟"

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

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

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

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

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

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

السيناريو 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) أحدث المستندات المرجعية لإعداد التقارير وأدلة المطوّرين وأدلة نقل البيانات. استنادًا إلى هذه المعلومات، تحوّل الخدمة طلب البحث إلى البنية الجديدة وتعدّل الحقول إلى أسمائها وقيمها الجديدة.

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

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

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

آلية العمل

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

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

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

  1. تطرح سؤالاً عن Merchant API في أداة تطوير الذكاء الاصطناعي.
  2. تحلّل مهارة وكيل Merchant API هدفك وتصوغ طلب بحث دقيقًا وتطبّق معرفتها الإجرائية على الطلب.
  3. ترسل مهارة الوكيل طلبًا للحصول على السياق إلى خادم بروتوكول سياق النموذج (MCP) لمستندات المطوّرين في Merchant API الذي يقع على merchantapi.googleapis.com/devdocs/mcp/.
  4. تبحث خدمة بروتوكول سياق النموذج (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؟"

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

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

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

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

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

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