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

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

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

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

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. المراقبة

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