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

تم إيقاف Google Content API for Shopping نهائيًا في 18 أغسطس 2026. على جميع المطوّرين نقل عمليات الدمج الحالية إلى Merchant API في أقرب وقت ممكن.

لتشجيع عملية نقل البيانات قبل الإيقاف النهائي للخدمة وضمان التزام المطوّرين بإشعارات الإيقاف النهائي في سجلات تطبيقاتهم، ستتّبع Google عملية تدريجية لإيقاف الخدمة بدءًا من 1 سبتمبر 2026.

الجدول الزمني لتغيير الألوان ليلاً

يوضّح الجدول التالي الجدول الزمني لتدهور الخدمة والإيقاف النهائي لواجهة Google Content API في Shopping (الإصدار 2.1):

انخفاض مستوى الخدمة واستجابات الأخطاء

اعتبارًا من 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، سيتولّى شريك المنصة عملية نقل البيانات نيابةً عنك. وليس هناك إجراء مطلوب من جانبك.

مطلوب اتخاذ إجراء

لتجنُّب حدوث انقطاعات في بيانات منتجاتك وإدارة حسابك، اتّبِع الخطوات التالية:

1. راجِع نظرة عامة على Merchant API للتعرّف على البنية والمصادقة وبُنى واجهات برمجة التطبيقات الفرعية.
2. اتّبِع دليل نقل البيانات من Content API for Shopping إلى Merchant API لتحديد البدائل الحديثة لخدمات Content API الحالية.
3. ثبِّت أحدث مكتبات برامج Merchant API للغة البرمجة التي تستخدمها.
4. عدِّل عملية الدمج واختبِرها في بيئة تطوير قبل نشرها في بيئة الإنتاج.

طلب تمديد

إذا كانت مؤسستك بحاجة إلى وقت إضافي لإكمال عملية النقل، يمكنك تقديم طلب للحصول على تمديد لإعفاء مشروعك على Google Cloud مؤقتًا من أخطاء انخفاض مستوى الخدمة. لطلب تمديد المهلة، يُرجى إرسال نموذج طلب تمديد مهلة Content API.

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