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

آلية العمل

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

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

  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)، زوِّده بالـ تعليمات النظام: بروتوكول وكيل أداة دمج Merchant Center. توجّه هذه التعليمات الوكيل بشأن كيفية استخدام بروتوكول سياق النموذج (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) عيّنات الرموز البرمجية ذات الصلة من مستودعات 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 مع مختلف أدوات سطر الأوامر وبيئات التطوير المتكاملة (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؟"

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

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

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

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

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

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