آخر التعديلات

الاطّلاع على آخر الإشعارات حول الميزات الجديدة وإصلاحات الأخطاء وتحديثات الإصدار

مايو 2026

مايو 2026

الميزات الجديدة:

• تتوفّر الآن خدمة جديدة ضمن Merchant API MCP (إصدار أوّلي) تتيح الوصول المصرّح به إلى بياناتك وإحصاءاتك في Merchant Center مع التركيز على الوصول للقراءة فقط، وذلك كأداة جديدة مستندة إلى وكيل ضمن Merchant API.

• تتوفّر الآن سمات حوارية جديدة ضمن ProductAttributes في واجهة برمجة التطبيقات الفرعية للمنتجات.

  تشمل هذه السمات ما يلي:

  • السؤال والجواب [question_and_answer]
  • رابط المستند [document_link]
  • المنتج ذو الصلة [related_product]
  • عنوان مجموعة السلع [item_group_title]
  • خيار المنتج [variant_option]
  • الترتيب حسب الرواج [popularity_rank]

• تمت إضافة مجموعة كاملة من السمات الخاصة بـ "إعلانات المركبات" في واجهة برمجة التطبيقات الفرعية "المنتجات".

• تتوفّر الآن الإشعارات بشأن التغييرات في حالة المنتجات التي تستخدم بروتوكول Universal Commerce Protocol (UCP) للدفع في Notifications API من خلال قيمة سياق التقارير FREE_LISTINGS_UCP_CHECKOUT.

• ‫Merchant API Agent Skills هي الأداة الجديدة المستندة إلى الذكاء الاصطناعي الوكيل ضمن مجموعة أدوات Code Assist. توفّر mapi-developer-assistant هذه الميزة الجديدة، المستندة إلى معيار Agent Skills المفتوح، مساعدة ذكية ومناسبة للسياق، وتتيح الاستفادة من الخبرة الخاصة بمجال معيّن، وإجراء سير عمل آلي، وتحسين الكفاءة ضمن أدوات الذكاء الاصطناعي، مثل Antigravity CLI وبيئات التطوير المتكاملة، وذلك لتسريع عملية الدمج.

• يتوفّر إصدار جديد من واجهة برمجة التطبيقات الفرعية v1alpha على YouTube لإدارة عقود "برنامج التسويق بالعمولة من YouTube".

• تمت إضافة إمكانية إدارة برامج شركاء "التسوّق على YouTube" ومراجعات المنتجات في واجهة برمجة التطبيقات الفرعية "الحسابات".

• يتوفّر مصدر بيانات جديد للعروض الترويجية للمنتجات على مستوى حساب بامتيازات متقدّمة.

التغييرات التي تم إجراؤها:

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

الميزات القادمة:

• إحصاءات حول أداء الوكيل باستخدام UCP في Reports API.

يناير 2026

يناير 2026

الميزات الجديدة:

• قيمة سياق تقارير جديد، FREE_LISTINGS_UCP_CHECKOUT، لفهم حالة أهلية المنتج للاستفادة من ميزة الدفع في UCP (بروتوكول Universal Commerce Protocol) في واجهة برمجة التطبيقات الفرعية "التقارير"

• تم طرح تقارير الأداء في برنامج شركاء "التسوّق على YouTube" في الإصدار 1alpha ضمن واجهة برمجة التطبيقات الفرعية "التقارير".

• تمت إضافة دعم لرسائل ErrorInfo من أجل توفير بيانات وصفية قابلة للقراءة آليًا لطلبات البيانات غير الصحيحة من واجهة برمجة التطبيقات. ويصاحب ذلك دليل جديد حول معالجة الأخطاء وقائمة كاملة برسائل الخطأ.

التغييرات التي تم إجراؤها:

• أضفنا InventoryLoyaltyProgram إلى خدمة المخزون المتوفر في المتجر للسماح للمستخدمين بالتحكّم بشكل موحّد في ميزات الولاء، مثل الخصومات واسترداد جزء من المال عند إجراء عمليات شراء مستقبلية ونقاط الولاء.

الميزات القادمة:

• إيقاف الإصدار التجريبي 1 من Merchant API نهائيًا في 28 فبراير 2026 توجيه جميع طلبات البيانات من واجهة برمجة التطبيقات إلى الإصدارين 1 و1alpha على التوالي قبل الموعد النهائي لإيقاف الإصدار v1beta.
• إمكانية تفعيل برنامج "مراجعات المنتجات" وإيقافه من خلال Reviews API v1alpha، ما يسهّل عملية إرسال مراجعات المنتجات وإدارتها.

نوفمبر 2025

نوفمبر 2025

الميزات الجديدة:

• إحصاءات جديدة حول برنامج التسويق بالعمولة من منصّة التسوّق على YouTube (الإصدار الأوّلي 1) في واجهة Reports API الفرعية لاسترداد إحصاءات حول صنّاع المحتوى والمحتوى والمنتجات المعروضة على YouTube وتوفّر هذه التقارير التكافؤ مع التقارير الحالية المتوفّرة في Google Merchant Center (GMC).
• أداة بيانات تشخيص واجهة برمجة التطبيقات التي تمت ترقيتها لإتاحة نقل البيانات إلى Merchant API(الإصدار 1)
• تمت إضافة حقل جديد product_filters، إلى واجهة برمجة التطبيقات الفرعية للحسابات، وذلك للسماح للتجّار بمشاركة مجموعة فرعية فقط من خلاصتهم مع حسابات "إعلانات Google"، استنادًا إلى بعض الفلاتر الشرطية على سمات منتجات التاجر. لا تتوفّر هذه الميزة إلا لعدد محدود من التجّار.
• تمت إضافة إمكانية إنشاء حسابات مستقلة للبائعين على منصات التجارة الإلكترونية.
• تمت إضافة طريقتَين جديدتَين، accounts.limits.get وaccounts.limits.list للاستعلام عن حدود الحساب في Quota API.

التغييرات التي تم إجراؤها:

• تتوفّر الآن إمكانية الرصد التلقائي والفك الداخلي لترميز base64url لمعرّفات المنتجات في جميع الطرق التي تستخدم معرّفات المنتجات.

الميزات القادمة:

• إحصاءات جديدة حول برنامج التسويق بالعمولة من منصّة التسوّق على YouTube (الإصدار الأوّلي 1) في واجهة Reports API الفرعية لاسترداد إحصاءات حول صنّاع المحتوى والمحتوى والمنتجات المعروضة على YouTube وتوفّر هذه التقارير التكافؤ مع التقارير الحالية المتوفّرة في Google Merchant Center (GMC).

• سيتم إيقاف الإصدار التجريبي v1 من Merchant API نهائيًا في 28 فبراير 2026، ويجب توجيه جميع طلبات البيانات من واجهة برمجة التطبيقات إلى الإصدارين 1 و1alpha على التوالي قبل الموعد النهائي لإيقاف الإصدار التجريبي v1. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة إصدارات Merchant API وإيقافها نهائيًا.

سبتمبر 2025

سبتمبر 2025

الميزات الجديدة:

• تتوفّر الآن أول خدمة Model Context Protocol (MCP) لواجهة Merchant API.
  • تدمج خدمة MCP الجديدة مستندات Google API الموثوقة في مساعد الترميز في "بيئة التطوير المتكاملة" (IDE) لتسريع عملية دمج واجهة Merchant API وتحسين دقة سير عمل نقل البيانات.
• طريقة جديدة، getAccountForGcpRegistration، في واجهة برمجة التطبيقات الفرعية "الحسابات" لاسترداد حساب التاجر المسجّل في Google Cloud

التغييرات التي تم إجراؤها:

• طُرق جديدة لإدارة المناطق في واجهة برمجة التطبيقات الفرعية للحسابات
  • تم طرح ثلاث طرق جديدة، وهي batchCreate وbatchDelete وbatchUpdate، لإتاحة تجميع الطلبات في حِزم لعمليات create وupdate وdelete في واجهة برمجة التطبيقات الفرعية "المناطق" ضمن واجهة برمجة التطبيقات "الحسابات"، وذلك لتسهيل إدارة المناطق والحدّ من القيود المفروضة على طلبات one-region-per-request.
• يتوفّر إعداد شحن جديد مستند إلى شركة النقل في واجهة برمجة التطبيقات الفرعية الخاصة بالمنتجات لتحديد سمات الشحن على مستوى المنتج.

الميزات القادمة:

• تقارير جديدة حول إحصاءات برنامج التسويق بالعمولة من منصّة "التسوّق على YouTube"، مثل الإصدار v1alpha من واجهة برمجة التطبيقات الفرعية "التقارير" لاسترداد إحصاءات حول صنّاع المحتوى والمحتوى والمنتجات المعروضة على YouTube، ما يتيح التكافؤ مع التقارير المتوفّرة في Google Merchant Center.
• تفعيل تعديلات أكثر تكرارًا على بيانات المنتجات في سمتَي "مدى التوفّر" و"السعر"
• تحليل أسهل لأخطاء واجهة برمجة التطبيقات باستخدام ErrorInfo والبيانات الوصفية المحسّنة

يوليو 2025

يوليو 2025

الميزات الجديدة:

• أصبح الإصدار (1) من Merchant API، وهو البديل الرسمي لـ Content API for Shopping، متاحًا الآن للجمهور العام.

  وهذا يعني أنّه لن يتوفّر من الآن فصاعدًا سوى الإصدارين الفرعيين v1alpha وv1 من Merchant API، وسيتم نقل معظم إصدارات v1beta إلى الإصدار v1. يُرجى متابعتنا للحصول على مزيد المعلومات.

• تتوفّر موارد جديدة.

  • تستفيد ميزة "مصدر الصورة" في واجهة برمجة التطبيقات Product Studio API (إصدار أوّلي) من الذكاء الاصطناعي التوليدي لإنشاء خلفيات جديدة للمنتجات وإزالة خلفية الصورة وتحسين دقة الصورة.
  • تتيح واجهة برمجة التطبيقات الفرعية الدفع على موقع التاجر في واجهة برمجة التطبيقات Accounts إمكانية إنشاء إعدادات الدفع وتعديلها وحذفها والحصول عليها.
  • تم نقل سياسة الإرجاع على الإنترنت في واجهة برمجة التطبيقات الفرعية "الحسابات"، مع بقاء وظائف المستخدمين كما هي. تمت إزالة التحسينات الفنية الصغيرة، مثل الحقول القديمة وإعادة تسمية الحقول الحالية، للحفاظ على التناسق.
  • يستخدم AccountIdAlias في مورد AccountRelationship ضمن واجهة برمجة التطبيقات الفرعية "الحسابات" اسمًا مستعارًا يحدّده المستخدم بدلاً من رقم التعريف الداخلي (رقم تعريف الحساب). يسهّل ذلك إدارة بنى الحسابات المعقّدة، مثل استخدام اسم مستعار يحدّده المستخدم للسوق بدلاً من المعرّف الداخلي.

• أصبح بإمكان مستخدمي برمجة تطبيقات Google الوصول إلى Merchant API.

• يتوفّر الآن AggregateProductStatuses جديد في Issue resolution API للاستعلام عن إحصاءات مجمّعة حول حالات المنتجات.

التغييرات التي تم إجراؤها:

• إمكانية إنشاء حسابات مستقلة لمنصات إنشاء المتاجر وخدمات CSS في السابق، كان يتم إنشاء حسابات التجّار ضمن حساب بامتيازات متقدّمة واحد.

• انقر على الترتيبات المحتملة في جدول productView ضمن واجهة برمجة التطبيقات الفرعية "التقارير". أما الآن، فيتم تعديل ترتيب المنتجات استنادًا إلى clickPotential ليصبح ضمن القيم بين 1 و1000. المنتجات التي حصلت على قيمة clickPotentialRank منخفضة لا تزال تحصد أعلى قيمة click potential بين منتجات التاجر التي تستوفي شروط طلب البحث.

  ملاحظة: هذا ليس تغييرًا جذريًا.

الميزات القادمة:

• الوصول من خلال خادم Model Context Protocol (MCP) (الإصدار 1alpha)

مايو 2025

مايو 2025

الميزات الجديدة:

• أطلقنا واجهتَي برمجة تطبيقات فرعيتَين جديدتَين.
  • تتيح ميزة تتبُّع الطلبات للأنشطة التجارية عرض سجلّ تتبُّع الطلبات لتقديم تقديرات دقيقة ومفصّلة بشأن الشحن للعملاء. تتيح إشاراتها أيضًا عرض بيانات محسّنة تتضمّن شحنًا مجانيًا وسريعًا.
  • تتيح ميزة حلّ المشاكل الوصول إلى محتوى بيانات التشخيص وإجراءات الدعم بالطريقة نفسها التي تتوفر بها في واجهة مستخدم Merchant Center.
• تتوفّر موارد جديدة في واجهة برمجة التطبيقات الفرعية للحسابات.
  • OmnichannelSettings يدير إعدادات الحساب لعرض الإعلانات على قنوات تسويق شاملة، مثل البيانات المحلية المجانية وإعلانات المنتجات داخل المتجر.
  • LfpProviders يربط الشركاء في "برنامج الشراكة في الخلاصات المحلية" (LFP) ببيانات المستودع.
  • GbpAccounts يرتبط بحساب "الملف التجاري على Google" للحصول على بيانات المتجر المحلية.
  • تتيح لك OnlineReturnPolicy إنشاء سياساتك على الإنترنت وحذفها وتعديلها.
• تتوفّر طريقة جديدة في واجهة برمجة التطبيقات الفرعية للمنتجات.
  • تتيح لك السمة ProductsUpdate تعديل المنتجات الفردية بدون الحاجة إلى تقديم جميع الحقول المطلوبة للسمة ProductInput.

التغييرات التي تم إجراؤها:

• تمت زيادة الحد الأقصى pageSize من 250 إلى 1,000 صف لكل طلب بيانات من واجهة برمجة التطبيقات.
• تم إصلاح مشكلة التأخير التي كانت تحدث عند إدراج المنتجات والعروض الترويجية ومراجعات المنتجات ومراجعات التجّار بعد إنشاء DataSources.

الميزات القادمة:

• إيقاف حقل القناة نهائيًا وإزالته في المستقبل من DataSources والمنتجات
• إطلاق تعريف معدَّل لـ clickPotentialRank في جدول productView ضمن واجهة برمجة التطبيقات الفرعية "التقارير":
  • يتم تعديل ترتيب المنتجات استنادًا إلى clickPotential ليصبح ضمن نطاق القيم بين 1 و1000.
  • ستظل المنتجات التي تحمل القيمة clickPotentialRank المنخفضة هي المنتجات التي لديها أعلى إمكانية للحصول على نقرات بين منتجات التاجر التي تستوفي شروط طلب البحث. هذا تغيير غير مهم وقد يتم إطلاقه في 1 يوليو 2025.
• تتيح AccountIdAlias في مرجع AccountRelationship إدارة هياكل الحسابات المعقّدة بشكل أفضل. على سبيل المثال، تستخدم الأسواق اسمًا مستعارًا يحدّده المستخدم بدلاً من المعرّف الداخلي للتاجر، مثل معرّف الحساب.

أبريل 2025

أبريل 2025

الميزات الجديدة:

• أطلقنا واجهة برمجة تطبيقات فرعية جديدة.
  • تستفيد أداة Product Studio (إصدار أوّلي) من الذكاء الاصطناعي التوليدي لإنشاء عناوين المنتجات وأوصافها وتحسينها. يجب توقيع هذا النموذج من أجل طلب الوصول.
• تتوفّر موارد جديدة في واجهة برمجة التطبيقات الفرعية "الحسابات".
  • تتيح AutomaticImprovements إمكانية الموافقة على ثلاث ميزات للتحديث التلقائي تقدّمها منصة Google Merchant Center:
    • التعديلات التلقائية على بيانات السلع
    • التحسينات التلقائية للصور
    • التحسينات التلقائية لمُدد الشحن
  • تتولّى موارد AccountService وAccountRelationship إدارة العلاقات وتقديم الخدمات لمقدّمي الخدمات.
• أطلقنا ثلاثة حقول AutomatedDiscounts في واجهة برمجة التطبيقات الفرعية للمنتجات لاسترداد الأسعار في الوقت الفعلي للمنتجات التي تم تفعيل ميزة الخصومات التلقائية من Google لها.

التغييرات التي تم إجراؤها:

• نوفّر الآن وجهات، تُعرف باسم طرق التسويق في Merchant Center، لواجهة برمجة التطبيقات الفرعية "مصادر البيانات".
• أجرينا تعديلات متعددة على المرجع، وننصحك بمراجعة ملاحظات إصدار الحسابات للحصول على مزيد من التفاصيل.
• تم إيقاف الحقلَين taxes وtax_category نهائيًا في واجهة برمجة التطبيقات الفرعية الخاصة بالمنتجات بما يتوافق مع الإيقاف النهائي للحقل accounttax في Content API.

الميزات القادمة:

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