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

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

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

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

   يجب فهم الطُرق والمراجع الجديدة المطلوبة لواجهة Merchant API.

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

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

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

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

   يجب تحديد أمرين:

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

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

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

   • حسابات
   • المنتجات
   • مصادر البيانات
   • التقارير
   ملاحظة: يمكنك التعامل مع هذه العملية على أساس كل حالة على حدة، استنادًا إلى نوع التكامل. على سبيل المثال، قد تكون ميزة مثل المخزون ذات أولوية أعلى.

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

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

   ملاحظة: إذا كنت بحاجة إلى الانتقال إلى مشروع جديد على Google Cloud أو إدارة مشاريع متعددة أثناء نقل البيانات، يُرجى الاطّلاع على مقالة إدارة مشاريع Google Cloud والانتقال إليها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. المراقبة

   يجب الاستعداد لمعالجة المشاكل المحتملة.