ملاحظات إصدار Merchant Products API

الأسبوع الذي يبدأ في 27 يوليو 2026

خدمة المنتجات

تمت إضافة السمة التالية ذات الصلة بالعقارات المعروضة للإيجار إلى المورد ProductAttributes:

الأسبوع الذي يبدأ في 20 يوليو 2026

خدمة المنتجات

تمّت إضافة الحقل returns لإتاحة عمليات إلغاء على مستوى العرض لسياسة الإرجاع. يتيح لك هذا الحقل تحديد قواعد إرجاع دقيقة (مثل البلد وعدد أيام مهلة إرجاع المشتريات وشروط السلع وطُرق الإرجاع والنتائج والرسوم وعنوان URL الخاص بالسياسة) مباشرةً في خلاصة المنتجات وواجهة برمجة التطبيقات.

الأسبوع الذي يبدأ في 15 يونيو 2026

خدمة المنتجات

تمت إضافة السمات التالية ذات الصلة بالعقارات المعروضة للإيجار إلى مرجع ProductAttributes:

لا تتوفّر هذه السمات إلا للتجّار المشاركين في الإصدار التجريبي المغلق. إذا كنت مهتمًا بالمشاركة، يُرجى التواصل مع ممثل مبيعات Google.

الأسبوع الذي يبدأ في 18 مايو 2026

خدمة المنتجات

تمت إضافة السمات الحوارية التالية إلى مرجع ProductAttributes:

لا تتوفّر هذه السمات بعد في مكتبات البرامج الخاصة بالعملاء، وسيتم طرحها قريبًا. في الوقت الحالي، يمكن تحديدها باستخدام سمات مخصّصة.

الأسبوع الذي يبدأ في 11 مايو 2026

خدمة المنتجات

تمت إضافة الحقل archived إلى المورد Product للإشارة إلى ما إذا كان المنتج مؤرشفًا. مزيد من المعلومات حول مستوى عرض العروض

الأسبوع الذي يبدأ في 27 أبريل 2026

تمّت إضافة total_amount في installment.

خدمة المنتجات

تمت إضافة السمات التالية المرتبطة بالمركبات إلى مورد ProductAttributes:

الأسبوع الذي يبدأ في 13 أبريل 2026

تمت إضافة الحقلَين loyalty_program_label وloyalty_tier_label إلى سمات الشحن لتفعيل إعداد خيارات الشحن لبرامج ومستويات ولاء معيّنة.

تمت إضافة الحقل minimum_order_values لتحديد الحد الأدنى لقيمة طلب الشراء المطلوب في سلّة التسوّق قبل أن يتمكّن المستخدم من بدء عملية الدفع.

تمت إضافة "annual_percentage_rate" في installment.

خدمة المنتجات

تمت إضافة حقل video_links. يتيح لك هذا الحقل تقديم عناوين URL للفيديوهات الخاصة بالمنتجات.

الأسبوع الذي يبدأ في 6 أبريل 2026

تمت إضافة الحقل base64_encoded_name إلى رسالتَي Product وProductInput الأوّليتَين لتفعيل استخدام أسماء الإخراج مباشرةً كإدخال في الحالات التي يحتوي فيها الاسم على رموز خاصة.

الأسبوع الذي يبدأ في 16 مارس 2026

خدمة المنتجات

تمت إضافة الحقل return_policy_label.

الأسبوع الذي يبدأ في 1 ديسمبر 2025

تمت إضافة "أسبوع" كمدة اشتراك محتملة في period.

الأسبوع الذي يبدأ في 17 نوفمبر 2025

تتوافق الآن معرّفات المنتجات ضمن مسارات الطلبات مع ترميز base64url غير المضمّن بالإضافة إلى القيم غير المشفّرة/العادية. يضمن هذا التحسين إمكانية استرداد المنتجات التي تتضمّن أحرفًا خاصة (مثل الشرطات المائلة) في معرّفاتها ومعالجتها بنجاح.

الأسبوع الذي يبدأ في 3 نوفمبر 2025

خدمة المنتجات

تمت إضافة الحقلَين shipping_handling_business_days وshipping_transit_business_days للسماح بتحديد أيام الأسبوع التي يجب أخذها في الاعتبار عند احتساب مدة التسليم.

الأسبوع الذي يبدأ في 29 سبتمبر 2025

خدمة المنتجات

تمت إضافة الحقل carrier_shipping لإتاحة تحديد إعدادات الشحن باستخدام شركات النقل لكل من تكلفة الشحن وسرعة الشحن.

الأسبوع الذي يبدأ في 7 يوليو 2025

خدمة المنتجات

تمت إضافة صيغة الجمع لحقل أرقام GTIN وإيقاف صيغة المفرد. في الوقت الحالي، سيتم ملء كلا الحقلين عند القراءة، وسيتم استخدام القيم من كلا الحقلين أثناء الإدراج.

الأسبوع الذي يبدأ في 16 يونيو 2025

خدمة المنتجات

تمت إضافة الحقل maximum_retail_price لإتاحة تحديد الحد الأقصى لسعر البيع بالتجزئة في الهند.

الأسبوع الذي يبدأ في 19 مايو 2025

خدمة المنتجات

زيادة الحدّ الأقصى لحجم الصفحة من 250 إلى 1,000

الأسبوع الذي يبدأ في 12 مايو 2025

ProductInputs Service

تم تقليل التأخير بين إنشاء مصدر البيانات ووقت جهوزيته للاستخدام. في السابق، كان يتم عرض الخطأ Data source not found عند محاولة إدراج عناصر في غضون 5 دقائق من إنشاء مصدر البيانات. ينطبق ذلك على مصادر البيانات المستخدَمة لإدراج المنتجات والعروض الترويجية ومراجعات المنتجات ومراجعات التجّار.

الأسبوع الذي يبدأ في 14 أبريل 2025

تم إيقاف الحقلَين taxes وtax_category في المورد Product نهائيًا بسبب إيقاف accounttax نهائيًا في Content API.

الأسبوع الذي يبدأ في 3 أبريل 2025

خدمة المنتجات

إطلاق الحقل automated_discounts صُمّمت ميزة "الخصومات التلقائية" لتعديل خصومات أسعار المنتجات بشكل ديناميكي، ما يساعدك في زيادة الأرباح الإجمالية إلى أقصى حدّ في كامل مستودعك الإعلاني.

يحتوي الحقل automated_discounts على معلومات حول الأسعار السابقة والسعر قبل تطبيق التخفيضات المتتالية في الأسعار وسعر "الخصم التلقائي".

الأسبوع الذي يبدأ في 24 مارس 2025

ProductInputs Service

إطلاق الطريقة accounts.productInputs.patch التي تتيح لك تعديل إدخالات المنتجات الفردية من خلال قناع التعديل وبدون تقديم جميع حقول المورد accounts.productInputs.

الأسبوع الذي يبدأ في 6 يناير 2025

تم الآن ملء الحقل domain في الأخطاء التي تم إرجاعها بالقيمة merchantapi.googleapis.com بدلاً من global

الأسبوع الذي يبدأ في 12 ديسمبر 2024

خدمة المنتجات

تمت إضافة الحقل sustainability_incentives لتحديد الحوافز المتعلقة بالاستدامة، مثل الإعفاء الضريبي أو الخصم على السعر، لمنتجاتك. إذا لم يتم تقديم قيمة الحقل، لن يكون المنتج غير مؤهّل لأي حوافز متعلقة بالاستدامة.

الأسبوع الذي يبدأ في 15 نوفمبر 2024

خدمة المنتجات

بالنسبة إلى LoyaltyProgram، تمت إضافة الحقل shipping_label لتحديد الأهلية. إذا كان الحقل يتضمّن قيمة، يعني ذلك أنّ هذا العرض يتضمّن ميزة الشحن ضمن برنامج الولاء. إذا لم يتم توفير قيمة الحقل، لن يكون المنتج غير مؤهّل للاستفادة من مزايا شحن خاص ببرنامج الولاء ضمن فئة الولاء المحددة.

الأسبوع الذي يبدأ في 15 يوليو 2024

خدمة المنتجات

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

الأسبوع الذي يبدأ في 27 مايو 2024

إطلاق الإصدار التجريبي من واجهة برمجة التطبيقات الفرعية للمنتجات