تحديد الإصدار

يوضّح هذا الدليل كيفية تعامل Merchant API مع الإصدارات وعمليات الإصدار ودورة حياة إصداراتها المختلفة.

مخطّط تحديد الإصدارات

تستخدم Merchant API استراتيجية تحديد الإصدارات على مستوى واجهة برمجة التطبيقات الفرعية. هذا يعني أنّ كل واجهة Merchant API، مثل Products ضمن Merchant API، سيكون لها دورة حياة خاصة بإصدارها.

تنسيق الإصدارات وعرضها

• إصدارات واجهات برمجة التطبيقات الفرعية الثابتة: إذا كانت واجهة برمجة التطبيقات الفرعية في إصدار ثابت، تكون جميع طُرقها في إصدار ثابت. يتم تمثيل إصدار واجهة برمجة التطبيقات الفرعية الثابت على النحو التالي: vX (على سبيل المثال، v1 وv2). وهذه هي الإصدارات الرئيسية الجاهزة للإنتاج.

• إصدارات واجهة برمجة التطبيقات الفرعية الأولية: إذا كانت واجهة برمجة التطبيقات الفرعية في إصدار أولي، تكون جميع طرقها في إصدار أولي. يتم تمثيل إصدار واجهة برمجة التطبيقات الفرعية الأوّلي على النحو التالي: vXalpha (على سبيل المثال، v1alpha وv2alpha). وتحتوي على ميزات تجريبية متاحة للاستخدام قبل إطلاقها، وهي مخصّصة للاختبار والتكرار السريع. لا تضمن إصدارات ألفا الاستقرار، وليس لها عمر محدّد، ويمكن تغييرها أو إيقافها نهائيًا مع إرسال إشعار قبل 30 يومًا.

تغييرات الإصدار

• زيادة رقم الإصدار الرئيسي (على سبيل المثال، من الإصدار 1 إلى الإصدار 2): تشير هذه الزيادة إلى تغييرات غير متوافقة مع الأنظمة القديمة وتغييرات قد تؤدي إلى عطل، ما يتطلّب اتخاذ إجراء من المطوّر. سيتم تخصيص رقم إصدار جديد فقط للتغييرات التي قد تؤدي إلى عطل في واجهات برمجة التطبيقات الفرعية الثابتة. على سبيل المثال، من الإصدار 1 إلى الإصدار 2.
• التغييرات البسيطة: يتم عرض الإضافات أو الإصلاحات المتوافقة مع الأنظمة القديمة على أنّها تغييرات في رقم الإصدار الرئيسي الحالي. سيتم توضيح هذه التغييرات في ملاحظات الإصدار الخاص برقم الإصدار الرئيسي هذا. سيتم طرح الإضافات غير المسبّبة للأعطال في واجهة برمجة تطبيقات فرعية في قناة الإصدار الأولي من أحدث إصدار ثابت أو مباشرةً في أحدث إصدار ثابت.

سياسة الإيقاف النهائي

نوقف نهائيًا الإصدارات القديمة من واجهات برمجة التطبيقات الفرعية في Merchant Center بشكل دوري. نلتزم بفترة إيقاف نهائي مدتها 12 شهرًا لأرقام الإصدارات الرئيسية الثابتة (vX)، بدءًا من الإعلان الرسمي عن الإيقاف النهائي.

على سبيل المثال، إذا أوقفنا الإصدار 1 من واجهة Products الفرعية في 15 يناير 2026، سيتم إيقافه نهائيًا في موعد لا يتجاوز 15 يناير 2027. وبعد هذا التاريخ، لن يكون الإصدار السابق من واجهة برمجة التطبيقات الفرعية متاحًا للاستخدام.

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

يسرد الجدول التالي أحدث إصدارات كل واجهة برمجة تطبيقات فرعية في Merchant API:

واجهة برمجة تطبيقات فرعية	الإصدارات	الحالة
حسابات	v1 v1alpha	Active نشط
الإحالات الناجحة	v1	نشط
مصادر البيانات	v1	نشط
المساحات الإعلانية المتاحة	v1	نشط
حلّ المشاكل	v1	نشط
شراكة في الخلاصات المحلية	v1	نشط
الإشعارات	v1	نشط
تتبُّع الطلبات	v1	نشط
المنتجات	v1	نشط
Product Studio	v1alpha	نشط
العروض الترويجية	v1	نشط
الحصة	v1	نشط
التقارير	v1	نشط
المراجعات	v1alpha	نشط

أفضل الممارسات

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