تم إيقاف Content API for Shopping التابع لـ Google في 18 أغسطس 2026. ومنذ 1 سبتمبر، تفشل الطلبات الصادرة من المشاريع التي لا تملك تمديداً معتمداً بشكل متقطع مع رمز HTTP 410، وستتوقف نقاط النهاية تماماً في أوائل 2027 (إشعار الإيقاف من Google). إذا كان نص برمجي أو إضافة أو موصل داخلي لا يزال يدفع منتجاتكم إلى Merchant Center عبر الواجهة القديمة، فإن بعض هذه التحديثات يُفقد بالفعل.
هذا الدليل موجّه للمطورين ومالكي خلاصات المنتجات الذين يتولّون صيانة هذا المسار بأنفسهم. بنهايته ستتمكنون من العثور على كل استدعاء متبقٍّ لـ Content API، ومقابلة كل استدعاء بما يعادله في Merchant API، وإنشاء مصدر البيانات الذي تتطلبه الواجهة الجديدة، والتأكد في Merchant Center من أن المنتجات والأسعار ما زالت تصل.
كيف تعرفون ما إذا كان الإيقاف يؤثر عليكم
من السهل ألا يُلاحَظ هذا الخلل لأنه متقطع. توثّق Google نص الخطأ على أنه 410 مع رسالة تبدأ بعبارة «Content API for Shopping was sunset on August 18, 2026»، وتتضمن معرّف مشروع Google Cloud ورقم المشروع ورابطاً إلى مركز المساعدة. ابحثوا في سجلات التكامل لديكم عن هذه العبارة وعن shoppingcontent.googleapis.com.
تظهر عادةً ثلاثة أعراض قبل أن يقرأ أي شخص السجلات:
- تصل تغييرات السعر أو التوفر إلى Google متأخرة ساعات، أو في بعض مرات التشغيل فقط.
- تُبلغ مهمة يومية عن نجاح معظم الدفعات وفشل بعضها.
- يعرض Merchant Center بيانات قديمة بينما يعرض متجركم السعر الصحيح.
للعَرَض الأخير سبب محتمل ثانٍ، وهو أن تحديثات العناصر التلقائية من Google نفسها تتجاوز قيمكم. نتناول ذلك بشكل منفصل في منع Google من تجاوز سعر خلاصة منتجاتكم وتوفرها بصمت. استبعدوا أخطاء 410 أولاً لأن التأكد منها أقل كلفة.
الخطوة 1: حصر كل مستدعٍ للواجهة القديمة
توصي Google نفسها بمراجعة كود تطبيقكم بحثاً عن الاستدعاءات المباشرة لنقاط نهاية Content API. عملياً تختبئ هذه الاستدعاءات في أربعة أماكن: إضافة Google الخاصة بمنصة المتجر، ونص برمجي مخصص كتبه مطوّر سابق، وبرمجية وسيطة لخلاصة المنتجات أو لنظام ERP، ونص Google Ads أو Apps Script جدوله أحدهم قبل سنوات.
أنشئوا سجلاً مختصراً بصف واحد لكل مستدعٍ. دوّنوا وظيفته، ومشروع Google Cloud الذي يستخدمه للمصادقة، ومن يملكه. معرّف المشروع مهم لأن التمديدات ورسالة 410 مرتبطة به.
| المستدعي | ما يرسله | المالك | الإجراء |
|---|---|---|---|
| إضافة المتجر | الكتالوج الكامل، يومياً | مزوّد المنصة | اسألوا عن إصدار الواجهة الذي تستخدمه الآن |
| نص المخزون البرمجي | السعر والمخزون، كل ساعة | مطوّركم | الترحيل إلى Merchant API |
| أداة إدارة خلاصة المنتجات | خلاصة محسّنة | مزوّد الأداة | اطلبوا تأكيد الترحيل كتابياً |
إذا كان مزوّد خارجي يدير الاتصال، فمهمتكم أن تسألوا لا أن تعيدوا البناء. نشرت كل من Productsup وFeedonomics شروحات للترحيل، والمزوّد الناضج يكون قد انتقل بالفعل. اطرحوا السؤال نفسه على كل مزوّد في قائمتكم واحتفظوا بالإجابات.
الخطوة 2: قرّروا ما إذا كنتم بحاجة إلى تمديد
تقدّم Google نموذج طلب تمديد لـ Content API للمؤسسات التي تحتاج إلى مزيد من الوقت. تحمي التمديدات المعتمدة المشروع من استجابات الخطأ المجدولة خلال الفترة المعتمدة، ولا تمتد إلى ما بعد الإيقاف النهائي في أوائل 2027. ولا تذكر Google من تنطبق عليه الشروط.
استخدموا هذه القاعدة في اتخاذ القرار. إذا كان بالإمكان ترحيل كل المستدعين واختبارهم خلال بضعة أسابيع، فتجاوزوا التمديد واستثمروا الوقت في الترحيل. وإذا كان أحد المستدعين يتبع مزوّداً أكّد الترحيل دون تحديد موعد، فاطلبوا تمديداً لذلك المشروع وحده. التمديد هامش أمان وليس خطة.
الخطوة 3: قابِلوا كل استدعاء بما يعادله في Merchant API
يقسّم Merchant API الواجهة القديمة المتكتلة إلى واجهات فرعية ويضع رقم الإصدار في عنوان URL (/products/v1/). بلغ الإصدار v1 مرحلة التوفر العام في يوليو 2025، وتم إيقاف v1beta في 28 فبراير 2026، لذا ابنوا على v1 وتجاهلوا أي شروحات تعتمد على v1beta (ملاحظات إصدار Merchant API).
| Content API | Merchant API | ما الذي يتغير |
|---|---|---|
products.insert | productInputs.insert | يتطلب معامل استعلام dataSource |
products.update | productInputs.patch | تحديث دائم لمُدخل منتج واحد |
products.delete | productInputs.delete | يتطلب معامل dataSource |
products.get / list | products.get / list | يعيد المنتج بعد المعالجة، للقراءة فقط |
productstatuses.get / list | products.get / list | أصبحت الحالة جزءاً من مورد Product |
custombatch | استدعاءات متوازية غير متزامنة | لا توجد طريقة customBatch |
datafeeds | dataSources | يستهدف كل مصدر بيانات تسمية خلاصة (feed label) ولغة واحدة |
المصدر: مقابلة ترحيل المنتجات ومقابلة مصادر البيانات من Google. التحول المفاهيمي هو الفصل بين ProductInput، وهو البيانات الخام التي تكتبونها، وProduct، وهو الناتج المعالَج الذي يمكنكم قراءته فقط. يُبنى المنتج المعالَج من مُدخل أساسي واحد إضافة إلى أي مُدخلات تكميلية بعد تشغيل قواعد الخلاصة (نظرة عامة على المنتجات).
الخطوة 4: أنشئوا مصدر بيانات API قبل إدراج أي شيء
هذه هي الخطوة التي تُفشل معظم عمليات الترحيل الأولى. كان Content API ينشئ مصدر بيانات باسم «Content API» تلقائياً عند أول إدراج. أما Merchant API فلا يفعل ذلك. تنص Google على أنه يجب إنشاء مصدر بيانات واحد على الأقل من النوع API، وأن الواجهة الفرعية Products لا تكتب إلا إلى مصادر البيانات من هذا النوع (ترحيل مصادر البيانات).
يقابل كل مصدر بيانات الآن توليفة واحدة من feedLabel وcontentLanguage. إذا كنتم تخدمون تركيا بالتركية والإمارات بالإنجليزية من خلاصة واحدة متعددة الأهداف، فستحتاجون الآن إلى مصادر بيانات منفصلة. أنشئوها عبر الواجهة الفرعية Data Sources أو في Merchant Center، ثم استخدموا اسم المورد الناتج، بالصيغة accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}، في كل عملية كتابة.
الخطوة 5: أعيدوا كتابة الحمولة، مع مثال عملي
تتسبب ثلاثة تغييرات في الحقول في معظم الأخطاء. ينتقل السعر من سلسلة عشرية إلى micros صحيحة، حيث يساوي مليون micros وحدة عملة واحدة. وتنتقل سمات المنتج إلى كائن productAttributes. ويحل feedLabel محل targetCountry، بينما يختفي channel.
كان معرّف المنتج القديم يبدو هكذا، أما الجديد فيستخدم علامات التيلدا ويحذف القناة:
Content API: online:en:US:SKU12345
Merchant API: en~US~SKU12345
يبدو مُدخل المنتج الذي يستخدمه دليل Google نفسها مثالاً كما يلي (الإدراج عبر POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}):
{
"offerId": "SKU12345",
"contentLanguage": "en",
"feedLabel": "US",
"productAttributes": {
"title": "Classic Cotton T-Shirt",
"link": "https://www.example.com/p/SKU12345",
"imageLink": "https://www.example.com/img/SKU12345.jpg",
"availability": "IN_STOCK",
"price": { "amountMicros": "15990000", "currencyCode": "USD" },
"condition": "NEW",
"gtins": ["9780007350896"]
}
}
قارنوا ذلك بالشكل القديم: "price": {"value": "15.99", "currency": "USD"} يصبح amountMicros وcurrencyCode، ويصبح التوفر قيمة enum، فتتحول in stock إلى IN_STOCK. المصدر: دليل إضافة المنتجات وإدارتها من Google.
بالنسبة إلى الليرة التركية، يكون 1,249.90 TRY هو "amountMicros": "1249900000". احسبوا micros بالحساب الصحيح على أصغر وحدة نقدية، لا بضرب عدد عشري، وإلا سترسلون 1249899999 وتتساءلون لماذا تختلف الأسعار بفارق ضئيل.
استخدموا أيضاً الحقل الجديد versionNumber عندما تكتب عدة مهام إلى المنتج نفسه. فهو يمنع تحديثاً أقدم من الكتابة فوق تحديث أحدث عندما تصل الطلبات بترتيب مختلف.
الخطوة 6: استبدلوا المعالجة بالدفعات واقرؤوا الحالة من المنتج
لا توجد طريقة customBatch. استبدلوها بطلبات متوازية غير متزامنة وحدّدوا سقفاً للتزامن، ثم أعيدوا محاولة الطلبات الفاشلة فقط. احتفظوا بسجل نتائج لكل عرض (offer) حتى لا يتحول فشل جزئي بصمت إلى كتالوج قديم.
أما الحالة، فتوقفوا عن استدعاء productstatuses. اقرؤوا بدلاً من ذلك Product المعالَج الذي يحمل حالته. تشير Google إلى أنه قد يكون هناك تأخير بضع دقائق بين الإدراج أو التحديث وتوفر المنتج النهائي، لذا فإن القراءة مباشرة بعد الكتابة ليست اختباراً للفشل.
الخطوة 7: تحقّقوا قبل إيقاف المسار القديم
شغّلوا المسار الجديد أولاً على شريحة صغيرة منخفضة المخاطر، مثل 50 منتجاً ضمن تسمية خلاصة واحدة. ثم قيّموا عملية الانتقال بقائمة التحقق التالية. يجب أن تكون كل نقطة «نعم» قبل إيقاف المستدعي القديم.
- يصادق المستدعي مقابل المشروع الذي سجلتموه، ولا يعيد أي خطأ 410 لسبعة أيام متتالية.
- يوجد مصدر بيانات API لكل زوج من تسمية الخلاصة واللغة تخدمونه.
- في شريحة الاختبار، يطابق المنتج المعالَج مصدر الحقيقة لديكم في السعر والتوفر والرابط.
- لا يوجد شيء آخر لا يزال يكتب معرّفات العروض نفسها من مصدر البيانات القديم.
- تُسجَّل العروض الفاشلة مع إعادة محاولة، ولا تُهمَل.
- لدى كل المستدعين الذين يديرهم مزوّدون في سجلكم تأكيد كتابي بالترحيل.
البند الرابع يستحق الانتباه. وجود كاتب ثانٍ لمعرّف العرض نفسه، مثل المستدعي القديم ومصدر بيانات API جديد، هو ما يسبب القيم المتعارضة. حدّدوا أي مصدر يملك كل منتج وأزيلوا الآخر.
أين يصل هذا الدليل إلى حدوده
كتبنا هذا الدليل اعتماداً على الوثائق المنشورة من Google ولم نرحّل قاعدة الكود الخاصة بكم. هناك عدة أمور خارج نطاقه. لا تذكر Google شروط أهلية التمديد، لذا لا يمكننا إخباركم ما إذا كان مشروع معيّن سيُعتمد. ولا توثّق النظرة العامة للمنتجات التوقيت بأكثر من «بضع دقائق»، لذا فأي توقع أدق لزمن التأخير عليكم قياسه. أما المخزون المحلي والمخزون الإقليمي والعروض الترويجية والمراجعات، فلكل منها موارد فرعية خاصة في Merchant API، ولم نغطِّ مقابلاتها هنا.
إذا كنتم لا تريدون تملّك تكامل API على الإطلاق، فإن منصة خلاصات مُدارة هي الإجابة الأفضل من إعادة الكتابة. تنشر كل من Productsup وFeedonomics إرشادات لترحيل Merchant API، وبالنسبة إلى فريق مؤسسي لديه نماذج بيانات غير معتادة قد تناسبه أي منهما أكثر من إعدادنا. وبالنسبة إلى Google Shopping تحديداً، فإن إعدادنا موصوف في صفحة تكامل Google Merchant Center.
الأسئلة الشائعة
هل ما زال Content API for Shopping يعمل؟
ليس بشكل موثوق. تنص Google على أنه أُوقف في 18 أغسطس 2026، وأن الطلبات التي لا يغطيها تمديد نشط بدأت تفشل بشكل متقطع مع HTTP 410 اعتباراً من 1 سبتمبر 2026، وأن جميع نقاط النهاية ستتوقف في أوائل 2027.
ماذا تقول رسالة خطأ Content API 410؟
تبدأ الرسالة بعبارة «Content API for Shopping was sunset on August 18, 2026». وتتضمن الاستجابة معرّف مشروع GCP ورقم المشروع ورابطاً إلى مركز المساعدة، وهو ما يحدد لكم أي مشروع يجب ترحيله أو تمديده.
هل يمكنني الحصول على مزيد من الوقت عبر تمديد؟
توفر Google نموذج طلب تمديد لـ Content API. تحمي التمديدات المعتمدة مشروعكم من الأخطاء المجدولة خلال الفترة المعتمدة فقط، ولا تتجاوز موعد الإيقاف النهائي في أوائل 2027.
لماذا يطلب productInputs.insert قيمة dataSource؟
تنتمي عمليات الكتابة في Merchant API إلى مصدر بيانات صريح. وعلى خلاف الواجهة القديمة، لا ينشئ مصدر بيانات «Content API» عند أول إدراج، لذا يجب إنشاء مصدر بيانات من نوع API وتمرير اسم مورده.
كيف أرسل الأسعار في Merchant API؟
استخدموا amountMicros كسلسلة عددية صحيحة وcurrencyCode بصيغة ISO 4217. مليون micros تساوي وحدة عملة واحدة، لذا فإن 15.99 USD تعادل 15990000.
هل يدعم Merchant API المعالجة بالدفعات؟
لا توجد طريقة customBatch. توصي Google باستخدام استدعاءات متوازية غير متزامنة، أي أن عليكم إضافة حد للتزامن وإعادة محاولة لكل عرض بشكل مستقل.
أين ذهب productstatuses؟
أصبحت الحالة جزءاً من مورد Product المعالَج. استخدموا products.get أو products.list لقراءتها، مع مراعاة أن المعالجة قد تتأخر عن الإدراج بضع دقائق.
على أي إصدار من Merchant API يجب أن أبني؟
ابنوا على v1 الذي بلغ مرحلة التوفر العام في يوليو 2025. أُوقف الإصدار v1beta في 28 فبراير 2026، لذا ستفشل الشروحات المكتوبة له.
تحقّقوا مما تراه Google فعلياً
بعد الترحيل، أسرع فحص للتأكد هو مقارنة خلاصة المصدر لديكم بما عالجه Merchant Center. مرّروا خلاصتكم الحية عبر أداة تدقيق خلاصة المنتجات المجانية لدينا للحصول على درجة اكتمال وجودة، وأصلحوا ما تشير إليه قبل دورة الإعلانات التالية.

أحد المؤسسين المشاركين في Feedance، حيث يوظّف خبرته كمهندس حاسوب ومسوّق في تقديم رؤى تحليلية معمّقة. ويركّز بشكل كبير على تحويل البيانات إلى استراتيجيات قابلة للتنفيذ، ويكرّس جهده لمساعدة العلامات التجارية على تحقيق نمو ملموس في البيئة الرقمية.
LinkedIn


















