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

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

أكتوبر 2026

تشرين الأول (أكتوبر) 2026

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

  • سياسات المطوّرين وإعداد التقارير في برنامج شركاء "التسوّق على YouTube" (الإصدار v1alpha):

  • معرّف الموارد المنتظم (URI) للصفحة الرئيسية للمتجر في واجهة برمجة التطبيقات الفرعية للحسابات: تمت إضافة الحقل homePageUri للقراءة فقط إلى مورد الحسابات لعرض معرّف الموارد المنتظم (URI) للصفحة الرئيسية للمتجر.

  • إضافات سمات واجهة برمجة التطبيقات الفرعية للمنتجات:

    • روابط شهادات اعتماد المنتجات وتعدادات كفاءة استهلاك الطاقة في المملكة المتحدة: تمت إضافة الحقلَين certificationDocumentLink وcertificationLabelLink، إلى جانب هيئة إصدار شهادات الاعتماد التابعة لوزارة أمن الطاقة والحياد الكربوني (DESNZ) وتعدادات اسم شهادة الاعتماد GB_ENERGY_INFORMATION، إلى ProductCertification ضمن ProductAttributes. لمزيد من المعلومات، يُرجى الاطّلاع على شهادة الاعتماد.
    • الحدّ الأقصى للمسافة المقطوعة في أقساط المركبة: تمت إضافة السمة mileageAllowance إلى ProductInstallment ضمن ProductAttributes لتحديد الحدّ الأقصى للمسافة المقطوعة في عقود تأجير المركبات.
    • روابط الفيديوهات على مستوى العرض: تمت إضافة السمة videoLinks إلى ProductAttributes لإرسال الفيديوهات على مستوى العرض على نطاق واسع.

  • مستندات جديدة لمقدّمي الخدمات الخارجيين:

  • عيّنات تعليمات برمجية جديدة بلغة Java لإدارة تجميع المناطق:

  • تقارير أداء وكيل UCP (الإصدار v1alpha): تمت إضافة ملفَّين شخصيَّين جديدَين لإعداد التقارير إلى accounts.reports.search في واجهة برمجة التطبيقات الفرعية للتقارير (الإصدار v1alpha) من أجل استرداد مقاييس أداء الدفع والإحالات الناجحة في UCP على مستوى مساحات عرض Google، بما في ذلك "وضع AI" في "بحث Google" وGemini:

    • UcpAgenticPerformanceView: تُبلغ عن مقاييس مسار الإحالة الناجحة والطلب والإلغاء ونقل سلة التسوق على مستوى الحساب، ويتم تقسيمها حسب التاريخ وبلد العميل.
    • ‫UcpAgenticProductPerformanceView: تعرض هذه السمة مقاييس النقر على زر الشراء في offerId على مستوى المنتج، مقسّمة حسب التاريخ وبلد العميل.
    • تم نشر دليل تحليل أداء وكيل UCP (إصدار أولي) مع نماذج لطلبات البحث بلغة طلب البحث في Merchant Center‏ (MCQL).

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

  • توسيع نطاق إتاحة سمة الضمان: تم تعميم سمة warranty في ProductAttributes لتشمل كل المنتجات وليس فقط بيانات المركبات، وتم السماح بتحديد مدة الضمان بالأشهر أو السنوات.
  • إلغاء تسوية المشاكل في الحساب على مستوى العرض: تم عرض مشاكل محدّدة في الحساب تؤدي إلى تعليقه مباشرةً على العروض المتأثرة بدلاً من عرضها كرسالة عامة ACCOUNT_DISAPPROVAL، ما يوفّر بيانات تشخيصية أوضح حول التأثير على مستوى العرض وطريقة التسويق والبلد.
  • إيقاف YoutubeProductPerformanceView (الإصدار 1alpha) نهائيًا: تم إيقاف YoutubeProductPerformanceView نهائيًا في واجهة برمجة التطبيقات الفرعية للتقارير (الإصدار 1alpha) واستبدالها بـ YoutubeProductSoldStatsView وYoutubeProductTaggedStatsView.
  • الإعدادات التلقائية لتقسيم الصفحات في واجهة برمجة التطبيقات الفرعية للإشعارات وأدلة جديدة: تم توحيد accounts.notificationsubscriptions.list تقسيم الصفحات باستخدام مَعلمة pageSize اختيارية يتم ضبطها تلقائيًا على 100 (الحد الأقصى 200)، ونشرنا دليلاً جديدًا لإعداد الإشعارات الفورية للتغييرات في خدمة الحساب.
  • إعادة تنظيم المستندات المرجعية ودليل الحصص والحدود: تمت إزالة جميع الصفحات المرجعية المتوقفة نهائيًا لـ REST وRPC في الإصدار التجريبي v1beta من الموقع الإلكتروني للمطوّرين، وتمت إعادة تنظيم الحصص والحدود في أدلة مخصّصة لحصص واجهة برمجة التطبيقات وحدود الحساب.

أغسطس 2026

أغسطس 2026

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

  • تم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026. على جميع المطوّرين نقل عمليات الدمج الحالية إلى Merchant API في أقرب وقت ممكن. لمزيد من المعلومات، يُرجى الاطّلاع على الإيقاف النهائي والإيقاف التدريجي.
  • دمج حساب Universal Commerce Protocol (UCP): تمت إضافة UcpCheckoutManagement كنوع خدمة في مورد Account Service، بالإضافة إلى إتاحة برنامج 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 sub-API بلغات 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

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

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

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

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

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

يناير 2026

يناير 2026

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

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

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

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

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

نوفمبر 2025

نوفمبر 2025

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

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

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

  • أصبح من الممكن الآن رصد معرّفات المنتجات المرمّزة بترميز base64url وفك ترميزها داخليًا في جميع الطرق التي تستخدم معرّفات المنتجات.

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

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

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

سبتمبر 2025

سبتمبر 2025

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

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

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

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

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

  • تقارير جديدة لإحصاءات برنامج التسويق بالعمولة من حزمة "التسوّق على YouTube"، مثل v1alpha في واجهة برمجة التطبيقات الفرعية Reports لاسترداد إحصاءات حول صنّاع المحتوى والمحتوى والمنتجات المعروضة على 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.

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

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

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

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

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

  • يمكن الوصول إليها من خلال خادم Model Context Protocol (MCP) (الإصدار v1alpha).

مايو 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

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

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

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

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