بدء عملية نقل البيانات

في هذه الصفحة، نقدّم إرشادات حول التخطيط لعملية نقل بيانات واجهة برمجة التطبيقات.

بعد ذلك، نقدّم نظرة عامة على الخطوات التي عليك اتّخاذها لنقل البيانات.

التخطيط لعملية نقل البيانات

1. ربط طُرق Content API for Shopping بطُرق Merchant API

   من المفيد جدًا فهم الطُرق والمَراجع الجديدة التي تحتاج إليها في Merchant API بوضوح.

2. فهم التغييرات الأكثر أهمية التي تنطبق على عملية نقل البيانات

   يُرجى مراجعة المَراجع التالية للمساعدة في عملية نقل البيانات:

   • نظرة عامة على نقل البيانات من Content API: يوضّح هذا المرجع التغييرات الرئيسية التي يجب أخذها في الاعتبار في Merchant API.
   • أدلة نقل البيانات الخاصة بواجهات برمجة التطبيقات الفرعية: يُرجى مراجعة أدلة نقل البيانات الخاصة بواجهات برمجة التطبيقات الفرعية التي تحتاج إليها، لأنّها توفّر معلومات مهمة، مثل عمليات ربط الحقول الجديدة. على سبيل المثال، يُرجى الاطّلاع على نقل بيانات إدارة المنتجات.
   • يوفّر تفاصيل مَراجع وطُرق Merchant API.
   • يوضّح دليل البدء السريع كيفية البدء بسرعة في استخدام Merchant API لإنشاء حساب وتحميل منتج نموذجي.
   • الأدلة الخاصة بالميزات: لتنفيذ ميزة جديدة أو للحصول على مزيد من التوضيحات، يمكنك مراجعة أدلة الميزات المتوفّرة في شريط التنقّل.

3. تحديد واجهات برمجة التطبيقات الفرعية التي تخطّط لنقل بياناتها وتنفيذها

   عليك تحديد أمرين:

   • ميزات Merchant API التي تحتاج إلى نقل بياناتها
   • الميزات الجديدة التي تريد تنفيذها

   بعد إكمال هذه الخطوة، يمكنك تحديد مقدار الجهد المطلوب ووضع قائمة أولويات لواجهات برمجة التطبيقات الفرعية التي يجب العمل عليها.

   ننصحك بنقل كل البيانات أو أكبر قدر ممكن منها. إذا لم تتمكّن من نقل بيانات عملية تنفيذ Content API بالكامل في البداية، بسبب أهميتها وتعقيدها، عليك تحديد أولويات واجهات برمجة التطبيقات الفرعية التالية.

   • حسابات
   • المنتجات
   • مصادر البيانات
   • التقارير

خطوات نقل البيانات

1. التسجيل كمطوّر لاستخدام Merchant API، عليك إنشاء رابط بين مشروعك على Google Cloud وحسابك الأساسي على Merchant Center. يجب إكمال عملية التسجيل هذه لمرة واحدة لكل مشروع على Google Cloud تستخدمه مع Merchant API. يمكنك اتّباع العملية بأكملها في صفحة "نظرة عامة".

2. اختبار طُرق مختلفة لمساعدتك في البدء ننصحك باستخدام مستكشف واجهات برمجة التطبيقات من Google لإجراء اختبارات أساسية.

   تنسيق عناوين URL للطلبات في Merchant API هو

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. الاستفادة من نماذج التعليمات البرمجية ومكتبات العملاء

   للمساعدة في تقليل وقت التنفيذ والاستفادة من gRPC، استخدِم مكتبات العملاء ونماذج التعليمات البرمجية.

   نضمّن أيضًا مقتطفات من نماذج التعليمات البرمجية في أدلتنا. على سبيل المثال، يُرجى الاطّلاع على إضافة منتج.

4. اختبار رحلات المستخدم البسيطة

   يُرجى إجراء اختبارات رحلات المستخدم على جميع واجهات برمجة التطبيقات الفرعية والوظائف التي تخطّط لنقل بياناتها مع تحقيق الأهداف التالية:

   • أن تكون نتائج الردود صحيحة للمَراجع والطلبات التي تم نقل بياناتها
   • أن يظلّ معدّل الأخطاء منخفضًا

التخطيط لعملية الطرح

ننصحك باتّباع المنهج التالي:

• تنفيذ واجهة برمجة تطبيقات فرعية أو طريقة واحدة في كل مرة
• تنفيذ الميزات على شريحة صغيرة فقط من النشاط التجاري في كل مرة
• مراقبة المشاكل في جميع الأوقات

تنفيذ عملية نقل البيانات

1. العمل على كتابة التعليمات البرمجية باستخدام المَراجع ونقاط النهاية الجديدة

   بعد إجراء الاختبار الأولي وتطوير خطة إصدار، يمكنك دمج Merchant API في مسارات العمل.

2. المراقبة

   يُرجى الاستعداد لمعالجة المشاكل المحتملة.