آخر التحديثات

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

أغسطس 2026

أغسطس 2026

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

• تم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026. على جميع المطوّرين نقل عمليات الدمج الحالية إلى Merchant API في أقرب وقت ممكن. لمزيد من المعلومات، اطّلِع على الإيقاف النهائي.
• دمج حساب Universal Commerce Protocol (UCP): تمت إضافة UcpCheckoutManagement كنوع خدمة في مورد "خدمة الحساب"، بالإضافة إلى إتاحة برنامج ucp-integration وبنود خدمة ucp_integration مع إمكانية وصول محدودة.
• إلغاء سياسة الإرجاع على مستوى العرض: أضفنا السمة returns ضمن ProductAttributes لإعداد سياسات الإرجاع وإلغائها (على سبيل المثال، البلد وعدد أيام مهلة إرجاع المشتريات ورسوم الإرجاع والحالة) مباشرةً على مستوى السلعة.
• سمات العقارات المعروضة للإيجار: أضفنا سمات البيانات الأساسية، بما في ذلك leaseTerm إلى ProductAttributes، لإرسال بيانات الإعلانات عن العقارات المعروضة للإيجار.
• تحسينات على واجهة برمجة التطبيقات الفرعية للمستودعات:
  • أضفنا localShippingLabel إلى LocalInventoryAttributes لضبط قواعد الشحن الخاصة بالمتجر.
  • تمت إضافة customAttributes إلى LocalInventoryAttributes لتوفير بيانات وصفية مخصّصة للمنتجات المتوفرة داخل المتجر.
• إشعارات خدمة الحساب: تمت إضافة ACCOUNT_SERVICE كنوع NotificationEventType في واجهة برمجة التطبيقات الفرعية "الإشعارات" لتتبُّع تغييرات الحالة في خدمات الحساب. لمزيد من المعلومات حول الإشعارات المتعلقة بتغييرات خدمة الحساب، يُرجى الاطّلاع على مقالة تلقّي إشعارات فورية بشأن تغييرات خدمة الحساب.
• طرق عرض تقارير الشركاء التابعين في "التسوّق على YouTube" (v1alpha):
  • youtube_product_sold_stats_view لأداء مبيعات طلبات البحث لمنتجات مسوَّقة بالعمولة على YouTube.
  • youtube_product_tagged_stats_view لتتبُّع مرّات الظهور والنقرات والطلبات للمنتجات المُشار إليها في الفيديوهات
• نقطة نهاية "مطابقة العملاء" في برنامج الولاء: يمكنك تحميل بيانات برنامج ولاء العملاء وإدارتها لعرض مزايا المستوى (مثل السعر المخصّص للمشتركين) في نتائج البحث المجاني. لمزيد من المعلومات حول بيانات ولاء العملاء، يُرجى الاطّلاع على نظرة عامة على خدمة "مطابقة العملاء" الخاصة ببرامج الولاء.
• مستودع عام لمكتبات الإصدار الأوّلي: تتوفّر الآن مكتبات الإصدار الأوّلي لواجهة Reviews الفرعية ضمن Python وJava وPHP وC#‎ وRuby وNode.js وGo في مستودع GitHub العام.

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

• فلتر مستوى الوصول ListAccounts: أضفنا المَعلمة access التي تتيح استخدام DIRECT وINDIRECT وALL لفلترة الحسابات استنادًا إلى أذونات المتصل. ويمكن استخدام هذا المعرّف للتمييز بين الحسابات المتقدّمة والحسابات الفرعية.
• عمليات التحقّق من الحصة والقواعد في DataSources:
  • تم طرح ميزة الإدارة التلقائية للحصص لمصادر البيانات في الحسابات المتقدّمة. لمزيد من التفاصيل، يُرجى الاطّلاع على التعرّف على الحصص والحدود.
  • تمت إضافة عملية التحقّق من صحة القواعد التي تتطلّب أن تحتوي القواعد التلقائية في مصادر بيانات المنتجات الأساسية على مرجع واحد بالضبط إلى self أو إلى مصدر بيانات أساسي.
  • تم إيقاف primaryDataSourceName في DataSourceReference واستخدام self بدلاً منه.
• تحسينات في وقت الاستجابة: تم تقليل الحمل الزائد لواجهة برمجة التطبيقات لطلبات إدراج المنتجات وتعديلها وحذفها.

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

• إيقاف Content API for Shopping نهائيًا: تذكير بضرورة نقل البيانات إلى واجهة Merchant API الجديدة لتشجيع عملية نقل البيانات قبل إيقاف الخدمة نهائيًا ولضمان أن يلتزم المطوّرون بإشعارات الإيقاف النهائي في سجلات تطبيقاتهم، ستبدأ Google في 1 سبتمبر 2026 في تطبيق عملية تدريجية لخفض مستوى الخدمة. لمزيد من المعلومات، يُرجى الاطّلاع على قسم الجدول الزمني لإيقاف Content API for Shopping.

مايو 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) في واجهة برمجة التطبيقات الفرعية للإشعارات من خلال قيمة سياق إعداد التقارير FREE_LISTINGS_UCP_CHECKOUT.

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

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

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

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

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

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

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

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

يناير 2026

يناير 2026

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

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

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

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

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

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

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

• إيقاف الإصدار التجريبي 1 من Merchant API نهائيًا في 28 فبراير 2026 توجيه جميع طلبات البيانات من واجهة برمجة التطبيقات إلى الإصدارين v1 وv1alpha على التوالي قبل الموعد النهائي لإيقاف الإصدار 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).

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

سبتمبر 2025

سبتمبر 2025

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

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

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

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

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

• تقارير جديدة حول إحصاءات برنامج التسويق بالعمولة من حزمة "التسوّق على YouTube"، مثل الإصدار 1 ألفا في واجهة برمجة التطبيقات الفرعية "التقارير" لاسترداد إحصاءات حول صنّاع المحتوى والمحتوى والمنتجات المعروضة على 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الجدول ضمن Reports sub-API. أما ترتيب المنتجات استنادًا إلى clickPotential، فيتم تعديله ليصبح ضمن القيم بين 1 و1000. المنتجات التي لديها clickPotentialRank منخفضة لا تزال تحقّق أعلى click potential بين منتجات التاجر التي تستوفي شروط طلب البحث.

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

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

• الوصول من خلال خادم بروتوكول سياق النموذج (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.

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

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