وصلت Google Content API for Shopping رسميًا إلى تاريخ إيقافها نهائيًا في 18 أغسطس 2026. ويجب على جميع المطوّرين نقل عمليات الدمج الحالية إلى الـ Merchant API في أقرب وقت ممكن.
لتشجيع عملية نقل البيانات قبل إيقاف الخدمة نهائيًا وضمان اطّلاع المطوّرين على إشعارات الإيقاف النهائي في سجلّات تطبيقاتهم، تقدّم Google عملية تدريجية لتقليل مستوى الخدمة تبدأ في 1 سبتمبر 2026.
الجدول الزمني للإيقاف النهائي
يُوضّح الجدول التالي الجدول الزمني لتقليل مستوى الخدمة والإيقاف النهائي لـ Google Content API for Shopping (الإصدار 2.1):
| التاريخ | الهدف | التفاصيل |
|---|---|---|
| 1 سبتمبر 2026 | تقديم طلبات فاشلة بشكل متقطّع | تبدأ الطلبات بدون تمديد نشط بالفشل بشكل متقطّع مع ظهور الرمز HTTP 410 Gone. |
| أوائل 2027 | إيقاف الخدمة نهائيًا | الإيقاف النهائي. يتم إيقاف جميع نقاط النهاية وتفشل جميع الطلبات. |
تقليل مستوى الخدمة والردود التي تتضمّن أخطاء
اعتبارًا من 1 سبتمبر 2026، ستفشل بشكل متقطّع الطلبات التي يرسلها العملاء إلى نقاط نهاية Google Content API for Shopping بدون تمديد نشط، وسيظهر رمز الحالة HTTP 410 Gone.
تنسيق الرد الذي يتضمّن خطأ
عند رفض طلب كجزء من عملية تقليل مستوى الخدمة المجدولة، تعرض واجهة برمجة التطبيقات حمولة خطأ HTTP 410 Gone تحتوي على الرسالة والبيانات الوصفية مع تفاصيل مشروعك على السحابة الإلكترونية من Google Cloud:
{
"error": {
"code": 410,
"message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
"status": "ABORTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "content_api_sunset",
"domain": "shoppingcontent.googleapis.com",
"metadata": {
"GCP_ID": "YOUR_PROJECT_ID",
"GCP_NUMBER": "YOUR_PROJECT_NUMBER",
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
}
}
]
}
}
يتضمّن الرد الذي يتضمّن خطأ حقول البيانات الوصفية التالية:
GCP_ID: رقم تعريف مشروع Google Cloud الذي يرسل الطلب.GCP_NUMBER: المعرّف الرقمي الفريد لمشروع Google Cloud.HELP_CENTER_LINK: رابط مباشر إلى مستندات نقل البيانات.
تأثير الحصص
لا يتم احتساب الردود التي تتضمّن أخطاء والتي يتم إنشاؤها بشكل مصطنع أثناء تقليل مستوى الخدمة ضمن حصة واجهة برمجة التطبيقات لمشروعك.
إعادة محاولة الطلبات الفاشلة
بما أنّ عملية تقليل مستوى الخدمة الأولية تؤدي إلى فشل جزء فقط من الطلبات، قد تنجح إعادة محاولة طلب فاشل. ومع ذلك، لا يُعدّ الاعتماد على عمليات إعادة المحاولة حلاً قابلاً للتطبيق على المدى الطويل لأنّ الطلبات الفاشلة ستصبح أكثر تكرارًا إلى أن تفشل جميع الطلبات عند إيقاف الخدمة نهائيًا.
المطوّرون المتأثرون
تنطبق عملية الإيقاف النهائي وتقليل مستوى الخدمة على المطوّرين والمؤسسات على النحو التالي:
- عمليات دمج مخصّصة لواجهة برمجة التطبيقات: إذا كانت مؤسستك تحتفظ بأدوات أو نصوص برمجية أو برامج مخصّصة داخلية تُجري طلبات مباشرة إلى Google Content API for Shopping، عليك تعديل تطبيقاتك لاستدعاء Merchant API.
- المنصات الخارجية: إذا كنت تصل إلى Merchant Center من خلال منصة للتجارة الإلكترونية، يدير شريك المنصة عملية نقل البيانات نيابةً عنك. وليس عليك اتّخاذ أي إجراء.
مطلوب اتخاذ إجراء
لمنع حدوث انقطاعات في بيانات منتجاتك وإدارة حسابك:
- راجِع نظرة عامة على Merchant API لفهم البنية والمصادقة وبُنى واجهات برمجة التطبيقات الفرعية.
- اتّبِع دليل نقل البيانات من Content API for Shopping إلى Merchant API لتحديد البدائل الحديثة لخدمات Content API الحالية.
- ثبِّت أحدث مكتبات برامج Merchant API للغة البرمجة التي تستخدمها.
- عدِّل عملية الدمج واختبِرها في بيئة تطوير قبل نشرها في بيئة الإنتاج.
تمديد الموعد النهائي
إذا كانت مؤسستك بحاجة إلى وقت إضافي لإكمال عملية نقل البيانات، يمكنك طلب تمديد لإعفاء مشروعك على Google Cloud مؤقتًا من أخطاء تقليل مستوى الخدمة. لطلب تمديد، أرسِل الـ نموذج طلب تمديد Content API.
تحمي عمليات التمديد الموافَق عليها مشاريعك من الردود التي تتضمّن أخطاء والمجدولة خلال فترة التمديد الموافَق عليها. لا تتجاوز عمليات التمديد تاريخ إيقاف الخدمة نهائيًا في أوائل 2027.