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

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

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

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

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 APIs Explorer لإجراء الاختبارات الأساسية.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. المراقبة:

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