تحديد الإصدار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الدليل كيفية تعامل Merchant API مع الإصدارات وعمليات الإصدار ودورة حياة إصداراته المختلفة.
مخطط تحديد الإصدار
تستخدم Merchant API استراتيجية تحديد الإصدارات على مستوى واجهة برمجة التطبيقات الفرعية. وهذا يعني أنّ كل واجهة برمجة تطبيقات، مثل المنتجات ضمن Merchant API، سيكون لها دورة حياة خاصة بالإصدار.
إصدارات فرعية ثابتة من واجهة برمجة التطبيقات: إذا كان الإصدار الفرعي من واجهة برمجة التطبيقات ثابتًا، يعني ذلك أنّ جميع طرقها ثابتة. يتم تمثيل إصدار ثابت من واجهة برمجة التطبيقات الفرعية
بالصيغة vX (على سبيل المثال، v1 أو v2). هذه هي الإصدارات الرئيسية الجاهزة للاستخدام.
إصدارات واجهة برمجة التطبيقات الفرعية الأولية: إذا كانت واجهة برمجة تطبيقات فرعية في مرحلة الإصدار الأولي، يعني ذلك أنّ جميع طرقها في مرحلة الإصدار الأولي. يتم تمثيل إصدار فرعي أولي من واجهة برمجة التطبيقات على النحو التالي: vXalpha (على سبيل المثال، v1alpha وv2alpha). وتتضمّن هذه الإصدارات ميزات تجريبية متاحة قبل إطلاقها بهدف اختبارها وتكرارها سريعًا. لا تتضمّن إصدارات ألفا أي ضمان للاستقرار، وليس لها مدة صلاحية محددة، ويمكن تغييرها أو إيقافها نهائيًا بعد إرسال إشعار قبل 30 يومًا.
تغييرات الإصدار
زيادات الإصدار الرئيسي (على سبيل المثال، من الإصدار 1 إلى الإصدار 2): تشير هذه الزيادات إلى تغييرات غير متوافقة مع الأنظمة القديمة وتتسبّب في حدوث مشاكل، ما يتطلّب اتّخاذ إجراء من المطوّر.
لن يتم تغيير رقم الإصدار إلا عند إجراء تغييرات غير متوافقة في واجهات برمجة التطبيقات الفرعية الثابتة. على سبيل المثال، من الإصدار 1 إلى الإصدار 2.
التغييرات الطفيفة: يتم عرض الإضافات أو الإصلاحات المتوافقة مع الإصدارات القديمة كتغييرات على الإصدار الرئيسي الحالي. وسيتم تفصيل هذه التغييرات في ملاحظات الإصدار الخاصة بهذا الإصدار الرئيسي. سيتم طرح الإضافات غير المتوافقة مع الإصدارات السابقة إلى قناة الإصدار الأولي من أحدث إصدار ثابت أو مباشرةً إلى أحدث إصدار ثابت.
سياسة إيقاف المنتجات نهائيًا
نوقف نهائيًا بشكل دوري الإصدارات القديمة من واجهات Merchant الفرعية. نلتزم بفترة إيقاف نهائي مدتها 12 شهرًا للإصدارات الرئيسية الثابتة (vX)، بدءًا من تاريخ الإعلان الرسمي عن الإيقاف النهائي.
على سبيل المثال، إذا أوقفنا الإصدار 1 من واجهة Products الفرعية في 15 يناير 2026، لن يتم إيقافه نهائيًا قبل 15 يناير 2027. بعد هذا التاريخ، لن يعود الإصدار السابق من واجهة برمجة التطبيقات الفرعية متاحًا للاستخدام.
إصدار واجهة برمجة التطبيقات الفرعية وحالة مراحل النشاط
يسرد الجدول التالي أحدث إصدارات كل واجهة فرعية من Merchant API:
| واجهة برمجة التطبيقات الفرعية |
الإصدارات |
الحالة |
| Accounts |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| الإحالات الناجحة |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| مصادر البيانات |
v1
v1beta |
نشط
سيتم إيقافه نهائيًا في 28 فبراير 2026 |
| المستودعات الإعلانية |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| حلّ المشاكل |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| برنامج الشراكة في الخلاصات المحلية |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| الإشعارات |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| تتبُّع الطلبات | v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| المنتجات |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| Product Studio |
v1alpha |
نشِط |
| العروض الترويجية
|
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| الحصة |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| إعداد التقارير |
v1
v1beta |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
| المراجعات |
v1alpha
الإصدار التجريبي 1 |
نشطة
سيتم إيقافها نهائيًا في 28 فبراير 2026 |
أفضل الممارسات
- راجِع ملاحظات الإصدار وآخر
التحديثات بانتظام للاطّلاع على الإصدارات الجديدة والتحديثات الرئيسية والتحسينات والإشعارات بشأن إطلاق واجهات برمجة التطبيقات الفرعية وإيقافها نهائيًا.
- إذا كان لإحدى واجهات برمجة التطبيقات الفرعية إصداران ثابتان أو أكثر، ننصحك باستخدام أحدث إصدار في جميع الأوقات.
- صمِّم تطبيقك للتعامل بسلاسة مع مختلف أخطاء واجهات برمجة التطبيقات الفرعية، بما في ذلك مشاكل الشبكة وحدود المعدّل ورموز أو رسائل الخطأ الجديدة التي قد يتم طرحها مع الإصدارات الأحدث من واجهات برمجة التطبيقات الفرعية.
- لا تنتظر حتى توشك إحدى إصدارات واجهة برمجة التطبيقات الفرعية على إيقافها نهائيًا لتبدأ في التخطيط لعملية الترقية. ابدأ بتقييم الإصدارات الجديدة واختبارها فور توفّرها.
- لتقديم طلبات بشأن ميزات أو إبداء مخاوف بشأن خارطة طريق لواجهة برمجة تطبيقات فرعية، يُرجى التواصل معنا
لطرح الأسئلة أو تقديم الملاحظات. للحصول على معلومات حول كيفية التواصل مع فريق Merchant API للحصول على الدعم الفني، يُرجى الاطّلاع على الحصول على مساعدة بشأن Merchant API.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Versioning\n\nThis guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n-----------------\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\n### Versioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\n### Version changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API will\n be released to the alpha channel of the latest stable version or directly to\n the latest stable version.\n\nSunset policy\n-------------\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n------------------------------------\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reporting | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n--------------\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
