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

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

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

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

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 تستخدمه مع Merchant API. يمكنك اتّباع العملية بأكملها هنا.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. المراقبة

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