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

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

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

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. يمكنك متابعة العملية بأكملها في صفحة "نظرة عامة".

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

   يكون تنسيق عناوين URL للطلبات في Merchant API على النحو التالي:

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

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

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

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

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

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

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

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

ننصحك باتّباع الأسلوب التالي:

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

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

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

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

2. المراقبة:

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