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

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

نظرة عامة

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

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

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

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

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

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

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

آلية العمل

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

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

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

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

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

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

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

2- إعداد نقطة النهاية

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

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

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

تتوافق مهارات الوكيل في Merchant API مع مختلف أدوات سطر الأوامر وبيئات التطوير المتكاملة المستندة إلى الذكاء الاصطناعي، مثل 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؟"

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

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

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

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

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

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