ملاحظات الإصدار (الإصدار 2.1)

‫18 أغسطس 2025

تم إيقاف Content API نهائيًا وسيتم إيقافها في أغسطس 2026. النقل إلى Merchant API

‫19 يونيو 2025

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

مرجع المنتج

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

خدمة دعم التجّار

‫26 مايو 2025

خدمة الحسابات

يمكن الآن إضافة مستخدمين لديهم إذن بالقراءة فقط إلى الحسابات.

‫14 أبريل 2025

خدمة الحسابات

بما أنّ هذا الإجراء لن يكون مطلوبًا في المستقبل، تم إيقاف خدمة accounttax نهائيًا.

‫17 مارس 2025

في إطار إيقاف واجهات برمجة التطبيقات المرتبطة بالطلبات، تم إيقاف الخدمات التالية نهائيًا:

  • accounts.verifyphonenumber
  • returnpolicy

خدمات أخرى

لم يعُد هذا العنوان مطلوبًا ويمكن إيقافه نهائيًا:

  • pubsubnotificationsettings

‫10 فبراير 2025

تمت إضافة حقول prerendered_out_of_court_dispute_settlement إلى ProductIssue وإلى AccountIssue.

الحقول التي تم إيقاف استخدامها نهائيًا alternate_dispute_resolution من RenderProductIssuesResponse وRenderAccountIssuesResponse

‫12 ديسمبر 2024

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

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

‫15 نوفمبر 2024

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

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

‫30 أكتوبر 2024

في إطار إيقاف واجهات برمجة التطبيقات ذات الصلة بالتسوية، سيتم إيقاف الخدمات التالية نهائيًا:

  • settlementreports
  • settlementtranscations

يرتبط إيقاف واجهات برمجة التطبيقات المتعلّقة بالتسوية بإيقاف برنامج BuyOnGoogle وواجهات برمجة التطبيقات المتعلّقة بالطلبات.

من المتوقّع أن يتعذّر إجراء مكالمات إلى الخدمات المذكورة أعلاه مع ظهور الرد Service was not found on the server.

16 أكتوبر 2024

‫update_mask في UpdateConversionSourceRequest أصبح الآن OPTIONAL. في حال عدم تحديد قناع تعديل، يتم تعديل جميع الحقول التي تتضمّن قيمة غير فارغة.

‫26 أغسطس 2024 (قبل الموعد الذي أعلنّا عنه في الأصل)

في إطار إيقاف واجهات برمجة التطبيقات المرتبطة بالطلبات، تم إيقاف الخدمات التالية نهائيًا:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

من المتوقّع أن يتعذّر إجراء مكالمات إلى الخدمات المذكورة أعلاه مع ظهور الرد Service was not found on the server.

لم يتم إيقاف خدمة OrderTrackingSignals نهائيًا، وستبقى متاحة.

‫10 أغسطس 2024

خدمات "الشراء على Google"

في إطار إيقاف واجهات برمجة تطبيقات "الشراء على Google"، ستتعذّر جميع الطرق ضمن BuyOnGoogleProgramService مع ظهور الخطأ service was not found on the server.

‫19 يوليو 2024

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

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

‫20 مايو 2024

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

تمت إضافة LoyaltyPrograms. يتيح لك هذا التعديل توفير مستويات متعددة بنقاط ولاء وأسعار مختلفة وما إلى ذلك لمنتج واحد. يجب استخدام هذا الحقل بدلاً من الحقل الفردي LoyaltyProgram.

خدمة التقارير

مقاييس "الشراء على Google" المتوقّفة نهائيًا في جدول MerchantPerformanceView بعد هذا التعديل، سيؤدي استرداد أي مقياس من مقاييس "الشراء على Google" إلى عرض القيمة 0. وينطبق ذلك أيضًا على القيم السابقة للتواريخ الماضية.

لمزيد من المعلومات، اطّلِع على مقالة الإيقاف النهائي لبرنامج "الشراء على Google".

‫13 مايو 2024

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

مرجع المنتج

تغييرات على حقل الشهادات: تمت إضافة certificationValue إلى حقل ProductCertification لتوفير قيمة الشهادة (المعروفة أيضًا باسم الفئة أو المستوى أو التقييم)، ما يتيح للمستخدمين تحميل معلومات الشهادة حتى إذا لم تصدر جهة الاعتماد رقم اعتماد أو رمز اعتماد.

لمزيد من المعلومات، يُرجى الاطّلاع على أدلّة المنتجات.

‫6 مايو 2024

خدمة التقارير

تمت إضافة فئة الفعالية إلى جدول PriceInsightsProductView. تشير الفعالية إلى المنتجات التي ستستفيد إلى أقصى حدّ من تغيير الأسعار. يأخذ هذا التقييم في الاعتبار تحسّن الأداء المتوقَّع من خلال تعديل السعر المخفَّض والفرق بين السعر الحالي والسعر المقترَح.

‫24 أبريل 2024

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

مرجع المنتج

تمت إضافة الحقلَين الاختياريَين downpayment وcreditType إلى الدفعات بالتقسيط:

  • تمثّل السمة downpayment المبلغ الذي يجب أن يسدده المشتري كدفعة لمرة واحدة.
  • توفّر السمة creditType نوع الدفع بالأقساط (finance أو lease). لا ينطبق هذا الحقل إلا على "إعلانات المركبات".

‫11 أبريل 2024

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

مرجع المنتج

  • تمت إضافة سمة الحد الأدنى للشحن المجاني (FreeShippingThreshold) للشحن على مستوى العرض. تتيح هذه السمة للتجّار إدخال الحد الأدنى لسعر المنتج كي تصبح تكلفة الشحن مجانية.
  • تم تغيير إذن الوصول إلى LoyaltyPoints

‫10 أبريل 2024

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

مرجع المنتج

تمّت إضافة LoyaltyProgram

‫9 أبريل 2024

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

مرجع المنتج

تمت إضافة structuredTitle وstructuredDescription لتوفير عناوين وأوصاف منتجات من إنشاء الذكاء الاصطناعي.

‫3 أبريل 2024

خدمة دعم التجّار

تمت إضافة الحقل user_input_action_option الذي يتيح للشركاء طلب نوع جديد من الإجراءات: BuiltInUserInputAction. يتيح هذا الإجراء للشركاء إنشاء وظائف معقّدة للخدمة الذاتية للتجّار مباشرةً في تطبيقاتهم بدلاً من إعادة توجيههم إلى Merchant Center.

تمت إضافة طريقة TriggerAction جديدة إلى BuiltInUserInputAction. للوصول إلى هذه الطريقة، يُرجى إرسال طلب من خلال هذا النموذج.

27 مارس 2024

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

مرجع المنتج

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

‫15 مارس 2024

إيقاف ميزة "الشراء على Google" في "شبكة البحث" وShopping يمكنك مواصلة الاطّلاع على الطلبات الحالية حتى 31 أكتوبر 2024 باستخدام orders.list وorders.get.

‫8 مارس 2024

خدمة التقارير

تمّت إضافة تقرير TopicTrendsView إلى خدمة Reports.

لمزيد من المعلومات، يُرجى الاطّلاع على أدلة الإبلاغ.

‫6 آذار (مارس) 2024

خدمة التقارير

تمت إضافة مجموعة وترتيب "احتمال النقر" للمنتجات.

لمزيد من المعلومات، يُرجى الاطّلاع على أدلة الإبلاغ.

‫19 فبراير 2024

خدمة ConversionSources

تمت إزالة القيم التالية كمصادر صالحة للإحالات الناجحة:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

تمت إزالة الخيارَين 60 و90 يومًا من فترة معاينة الإعلان، وتمت إضافة 40 يومًا كخيار صالح.

‫17 يناير 2024

خدمة نقاط البيع

تمت إضافة قيم جديدة للحقل matching_status_hint في PosStore، ما يتيح للمستخدمين الحصول على مزيد من التفاصيل حول سبب تعذُّر مطابقة متجرهم.

‫11 يناير 2024

خدمة الحسابات

تمت إضافة localProductManager وlocalProductManagement كنوع رابط وخدمة على التوالي للطريقة link. تتيح هذه الحسابات ربط حسابات أخرى بهدف إدارة بيانات المنتجات المحلية.

‫29 نوفمبر 2023

خدمة دعم التجّار

تمت إضافة نوع الإجراء الخارجي VERIFY_IDENTITY_IN_MERCHANT_CENTER للتحقّق من الهوية الذي يجب تنفيذه في Merchant Center.

خدمة نقاط البيع

تمت إضافة الحقلَين matching_status وmatching_status_hint إلى PosStore، ما يتيح للمستخدمين معرفة حالة المطابقة لمتجر نقاط البيع مع متجر "الملف التجاري على Google" وتقديم تلميح لحلّ المشكلة في حال حدوثها.

15 تشرين الثاني (نوفمبر) 2023

لم يعُد بالإمكان استخدام نقاط نهاية repricingrules وrepricingrules.repricingreports.

‫1 نوفمبر 2023

خدمة "إعدادات الشحن"

لم يعُد shipment_type=pickup متاحًا.

‫18 أكتوبر 2023

خدمة الحسابات

تمّت إضافة الحقل Business Identity الذي يتيح للتجّار تحديد هويتهم بأنفسهم وفقًا لبعض قيم المستهلكين.

‫10 أكتوبر 2023

تمت إضافة Collection Point كنوع شحن جديد لخدمة إعدادات الشحن. إنّ التسليم إلى نقطة استلام هي خدمة توفّرها جهة خارجية (أي لا يملكها التاجر) لتسليم السلعة إلى موقع جغرافي تابع لجهة خارجية (مثل نقاط وصول UPS)، بدلاً من تسليمها مباشرةً إلى المنزل.

‏18 أيلول (سبتمبر) 2023

خدمة إعدادات "إعلانات المنتجات داخل المتجر"

تمت إضافة طريقة setOmnichannelExperience للسماح للمستخدمين بضبط تجربة القنوات المتعددة (أي إعدادات واجهة المتجر المحلية واستلام الطلبات). في الوقت الحالي، لا تتوفّر هذه الميزة إلا للمستخدمين الذين يثقون في مقدّم خدمة نقاط البيع لتفعيل هذه الإعدادات.

7 أيلول (سبتمبر) 2023

إيقاف ميزة "الشراء على Google" نهائيًا

إضافة حالة DEPRECATED جديدة إلى الطريقة GetBuyOnGoogleProgramStastus ولا يمكن إعادة تفعيل البرنامج أو إيقافه مؤقتًا من هذه الحالة.

‫4 سبتمبر 2023

خدمة دعم التجّار

تمت إضافة إجراء مدمج FIX_ACCOUNT_ISSUE للمشاكل المتعلّقة بالمنتجات والتي يجب حلّها على مستوى الحساب. تمت إضافة الإجراء المضمّن SHOW_ADDITIONAL_CONTENT الذي سيتم استخدامه لتقديم مبرّر من هيئة وطنية.

‫28 أغسطس 2023

خدمة العروض الترويجية

تم تغيير طريقة فتح list في خدمة Promotions من الوصول المحدود إلى الوصول للجميع.

‫22 أغسطس 2023

خدمة دعم التجّار

أطلقنا خدمة دعم التجّار. تقدّم هذه الخدمة محتوى دعمًا للمشاكل المتعلّقة بالحسابات والمنتجات.

‏4 آب (أغسطس) 2023

خدمة التقارير

تمّت إضافة تقرير "التنافسية حسب الظهور" الخاص بالمنافسين المقرّبين إلى خدمة "التقارير".

لمزيد من المعلومات، يُرجى الاطّلاع على أدلة الإبلاغ.

‏25 تموز (يوليو) 2023

خدمة نقاط البيع

مرجع المستودع

أضِف الحقلَين pickup_method وpickup_sla لتوفير إمكانية أن يرسل التجّار معلومات الاستلام مع مستودعهم.

‫14 يوليو 2023

خدمة التقارير

تمّت إضافة تقارير "التنافسية حسب الظهور" إلى خدمة "التقارير".

لمزيد من المعلومات، يُرجى الاطّلاع على أدلة الإبلاغ.

‫7 يوليو 2023

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

مرجع المنتج

تمت إضافة virtualModelLink لتوفير عناوين URL لصور التصاميم الثلاثية الأبعاد.

‫4 يوليو 2023

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

مرجع المنتج

أضِف الحقل certifications لتقديم شهادات اعتماد المنتجات، مثلاً شهادات اعتماد كفاءة استهلاك الطاقة استنادًا إلى قاعدة بيانات EPREL الخاصة بالاتحاد الأوروبي.

‫26 حزيران (يونيو) 2023

خدمة "إعدادات الشحن"

تلبية الطلبات على المستوى المحلي

تمت إضافة الحقل no_delivery_post_cutoff للسماح للتجّار بإيقاف عرض خيار التوصيل المحلي في اليوم التالي (n+1) عندما تكون لديهم خدمة شحن تم ضبطها على التوصيل المحلي في اليوم n.

‫29 مايو 2023

خدمة العروض الترويجية

تمت إضافة طريقة list لخدمة Promotions.

خدمة الاقتراحات

فعِّل إمكانية إغلاق التفاعل في الطريقة ReportInteraction الخاصة بخدمة "الاقتراحات".

‫9 أيار (مايو) 2023

وجهة Cloud Retail

خصائص إضافية في Cloud Retail

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

‫22 مايو 2023

خدمة العروض الترويجية

تمت إضافة طريقة list لخدمة Promotions.

‫11 أبريل 2023

خدمة "إعدادات الشحن"

تلبية الطلبات على المستوى المحلي

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

‫3 أبريل

خدمة الاقتراحات

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

‫20 فبراير 2023

خدمة الحسابات

مرجع الحساب

تمت إضافة قسم جديد Account.ConversionSettings في مورد الحسابات.

خدمة ConversionSources

تمّت إضافة خدمة "مصادر الإحالات الناجحة" التي تتيح إدارة مصادر الإحالات الناجحة (كجزء من قسم "إعدادات الإحالات الناجحة" في Merchant Center).

‫16 فبراير 2023

خدمة "إعدادات الشحن"

التحقّق من صحة رمز المتجر

يتم الآن التحقّق من رموز المتاجر للتأكّد من أنّها تعود إلى التاجر قبل تعديل إعدادات الشحن.

التحقّق من أهلية التاجر لاستخدام "إعلانات المنتجات داخل المتجر"

يتم الآن التحقّق من صحة البرامج التي تم تسجيل معرّف التاجر فيها قبل تعديل إعدادات الشحن. يجب أن يكون التجّار مشاركين في أحد البرامج التالية:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

‫9 فبراير 2023

خدمة العروض الترويجية

توسيع نطاق خدمة "العروض الترويجية" لتشمل 6 خيارات إضافية targetCountry مع توفير الدعم contentLanguage المحلي:

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

‫12 يناير 2023

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

مرجع المنتج

تمت إضافة lifestyleImageLinks لتوفير عناوين URL لصور نمط الحياة.

‫24 نوفمبر 2022

خدمة العروض الترويجية

تمت إضافة حقل جديد باسم `promotionStatus' في قسم Promotions.PromotionStatus. هذا الحقل متاح للقراءة فقط.

‫15 نوفمبر 2022

خدمة التقارير

تمت إضافة تقارير "إحصاءات السوق" إلى خدمة "التقارير".

يمكنك الآن الاستعلام عن خدمة "التقارير" بشأن ما يلي:

لمزيد من المعلومات، يُرجى الاطّلاع على أدلة الإبلاغ.

‫7 نوفمبر 2022

Datafeeds Service

تمت إضافة دعم feedLabel لخدمة "خلاصات البيانات".

‫14 سبتمبر 2022

تم تعديل feedLabel لقبول أي سلسلة.

‫9 أغسطس 2022

تمت إضافة feedLabel إلى المنتجات.

يمكنك الآن استخدام feedLabel بدلاً من targetCountry لتحديد البلد لمعرّفات العروض. يتم الآن إنشاء أرقام تعريف العروض الترويجية على النحو التالي: online:language:feedLabel:offerId.

تمت تعبئة feedLabel تلقائيًا بالقيمة targetCountry في الخلاصات الحالية لضمان التوافق مع الإصدارات القديمة.

تم إيقاف targetCountry نهائيًا.

لإتاحة العروض الترويجية على مستوى العالم، أوقفت Content API for Shopping الحقل targetCountry نهائيًا. بدلاً من ذلك، ننصحك باستخدام الحقل shipping لتحديد البلدان المستهدَفة.

تتم الآن تعبئة targetCountry تلقائيًا بالقيمة التي تقدّمها في feedLabel.

يمكنك الاطّلاع على مشاركة المدونة استبدال البلد المستهدف بتصنيف الخلاصة في Content API for Shopping للحصول على مزيد من التفاصيل.

‫8 ديسمبر 2021

خدمة الحسابات

مرجع الحساب

تمت إضافة قسم جديد Account.AutomaticImprovements في مورد الحسابات.

سيسمح هذا القسم الجديد للتجّار بتعديل بيانات السلع تلقائيًا وتحسين الصور وإعدادات الشحن.

‫25 أكتوبر 2021

خدمة العروض الترويجية

إضافة طريقة Get Promotion إلى Promotion API

‫11 أكتوبر 2021

Shipping Settings API

تمت إضافة حقل warehouse جديد في ShippingSettings resource للسماح للتجّار بإدارة المستودعات التي يمكن استخدامها في WarehouseBasedDeliveryTime.

أضِف حقل warehouseName جديدًا في WarehouseBasedDeliveryTime للإشارة إلى المستودع من خلال اسم المستودع.

‫4 تشرين الأول (أكتوبر) 2021

خدمة الحسابات

مرجع الحساب

تمت إضافة حقل جديد باسم "phone_verification_status" في قسم Accounts.BusinessInformation. هذا الحقل للقراءة فقط، ويتم ضبطه من خلال Accounts.VerifyPhoneNumber.

‫13 سبتمبر 2021

خدمة BuyOnGooglePrograms

مورد BuyOnGoogleProgramStatus

تمت إضافة حقول جديدة في المورد BuyOnGooglePrograms.BuyOnProgramStatus الذي يمثّل قنوات البيع على الإنترنت ونماذج الأنشطة التجارية ورقم هاتف خدمة العملاء.

طريقة New UpdateBuyOnGoogleProgramStatus

تمت إضافة طريقة UpdateBuyOnGoogleProgramStatus الجديدة التي ستتيح تعديل المورد BuyOnGooglePrograms.BuyOnProgramStatus الموسّع.

‫6 سبتمبر 2021

خدمة الحسابات

مرجع الحساب

تمت إضافة حقل جديد باسم korean_business_registration_number في قسم Accounts.BusinessInformation. لن تتم إزالة هذا الحقل إلا إذا تم ضبطه بشكل صريح على سلسلة فارغة.

‫30 آب (أغسطس) 2021

خدمة العروض الترويجية

تمت إضافة خدمة عروض ترويجية جديدة تتضمّن خيار "إدراج عرض ترويجي".

خدمة الطلبات

تمت إضافة طريقة جديدة orders/captureOrder لتحصيل الأموال قبل الشحن.

سبب إلغاء الطلب الجديد FAILED_TO_CAPTURE_FUNDS

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

مرجع المنتج

تمت إضافة productLength وproductHeight وproductWidth وproductWeight لتوفير أبعاد المنتج ووزنه.

‫9 أغسطس 2021

RepricingRule Service

RepricingRule Type

قيمة التعداد الجديدة للحقل RepricingRuleType

تمّت إضافة TYPE_SALES_VOLUME_BASED وTYPE_COMPETITIVE_PRICE.

‫17 أيار (مايو) 2021

خدمة ملصقات إرجاع الطلبات

تمت إضافة حقل product_id جديد في CreateReturnRequest. يمكن للتجّار تحديد إما product_id أو line_item_id لتحديد السلعة المطلوب إرجاعها.

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

تمت إضافة طريقة جديدة لتعديل المنتجات الحالية. يمكنك تعديل منتج من خلال توفير الحقول التي يجب تعديلها فقط بدلاً من المنتج بأكمله.

3 أيار (مايو) 2021

خدمة ملصقات إرجاع الطلبات

تمت إضافة طرق جديدة لتحميل ملصقات برنامج "خدمة الإرجاع المُدارة من التاجر" (MMR). باستخدام orderreturns.labels.create الجديدة، يمكنك تحميل ملصقات الإرجاع لمشاركتها مع العميل.

26 نيسان (أبريل) 2021

Shipping Settings API

حقل warehouseBasedDeliveryTimes جديد في DeliveryTime لإتاحة خدمات الشحن التي تحتسب تاريخ التسليم المقدّر استنادًا إلى الموقع الجغرافي للمستودع وخدمة شركة النقل المحدّدة.

حقل eddServices جديد في عنصر CarriersCarrier لعرض أسماء الخدمات التي يمكن استخدامها في احتساب تاريخ التسليم المقدَّر.

‫12 أبريل 2021

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

مرجع المنتج

حقل additionalSizeType جديد يتيح إضافة ما يصل إلى نوعَي مقاسات لكل منتج.

تغييرات على حقل الشحن: تمت إضافة minHandlingTime وmaxHandlingTime وminTransitTime وmaxTransitTime إلى ProductShipping لتوفير سرعة الشحن على مستوى العرض.

‫28 يناير 2021

خدمة الحسابات

تمت إضافة ميزة التصنيفات التلقائية إلى موارد AccountLabel وAccount. لمزيد من المعلومات، يُرجى الاطّلاع على قسم أنواع تصنيفات CSS في دليل إدارة تصنيفات CSS.

‫5 أكتوبر 2020

خدمة CSSES

مرجع CSS

أضفنا خدمة csses جديدة لاسترداد معلومات حول نطاقات CSS وتعيين تصنيفات لها. يمكن الآن استخدام المرجع AccountLabel أيضًا لإنشاء تصنيفات على مستوى مجموعة CSS وإدراجها. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة تصنيفات CSS.

24 آب (أغسطس) 2020

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

مورد المنتجات

حقل shoppingAdsExcludedCountries جديد لاستبعاد العروض من الإعلانات في بلدان معيّنة.

مورد Productstatuses

حقول جديدة approvedCountries وpendingCountries وdisapprovedCountries في العنصر destinationStatuses توفّر معلومات عن حالة العرض تتجاوز targetCountry.

حقل itemLevelIssues.applicableCountries جديد

10 آب (أغسطس) 2020

خدمة الحسابات

تمت إضافة مورد AccountLabel جديد لإدارة تصنيفات حسابات Merchant Center في CSS Center. يمكن لمستخدمي CSS Center الآن أيضًا إدراج حساباتهم على Merchant Center وتعيين تصنيفات لها باستخدام الطرق accounts.list وaccounts.get وaccounts.updatelabels. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة تصنيفات CSS.

‫19 يونيو 2020

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

مرجع المنتج

حقول جديدة

حقول جديدة: productDetails وproductHighlights وsubscriptionCost وcanonicalLink

2 حزيران (يونيو) 2020

خدمة الطلبات

تمّت إضافة طرق جديدة لبدء عمليات ردّ الأموال بدون إرجاع المنتجات. باستخدام orders.refunditem وorders.refundorder الجديدَين، يمكنك بدء عملية ردّ الأموال المدفوعة مقابل الطلبات حتى إذا لم يرجعها العميل.

‫27 نيسان (أبريل) 2020

Orderreturns Service

تمت إضافة الطريقتَين الجديدتَين acknowledge وprocess، بالإضافة إلى فلاتر وحقول جديدة لطُرق القراءة (list وget).

ربط حساب "نشاطي التجاري على Google"

أضفنا إمكانية ربط حسابات Merchant Center بحساب على "نشاطي التجاري على Google" باستخدام معرّف حساب "نشاطي التجاري على Google".

‫14 نيسان (أبريل) 2020

واجهات برمجة التطبيقات لتقارير التسوية

تمت إضافة خدمة جديدة للحصول على تقارير التسوية.

‫9 آذار (مارس) 2020

Local Inventory API

تمت إضافة خدمة جديدة لإرسال بيانات المخزون المتوفر في المتجر.

2 آذار (مارس) 2020

Pubsub notification settings API

تمت إضافة خدمة جديدة لإدارة إعدادات إشعارات Pub/Sub.

3 كانون الأول (ديسمبر) 2019

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

تمّت إضافة إمكانية استخدام خلاصات Content API التكميلية للحسابات المتعدّدة العملاء.

11 أيلول (سبتمبر) 2019

خدمة الطلبات

تمت إضافة إمكانية استلام الشحنات في الطلبات وميزات وضع الحماية ذات الصلة.

‫14 آب (أغسطس) 2019

خدمات جديدة

تمّت إضافة خدمتَي Returnpolicy وReturnaddress الجديدتَين لميزة "الشراء على Google".

خدمة الطلبات

مورد الطلب

حقل جديد

حقل quantityUndeliverable جديد

‫7 آب (أغسطس) 2019

خدمة الطلبات

مورد الطلب

حقول جديدة

تمت إضافة الحقلَين الجديدَين loyaltyInfo وinvoiceReceivingEmail إلى مورد "الطلب".

1 تموز (يوليو) 2019

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

تمّت إضافة إمكانية استخدام خلاصات Content API التكميلية في خدمة "المنتجات".

‫11 يونيو 2019

خدمة الطلبات

موارد الطلبات وطلبات الاختبار

إضافة تعديل السعر

تمت إضافة حقل lineItem[].adjustments جديد يحتوي على تعديل على السعر الأصلي لسلعة في السطر والضريبة الناتجة عن تطبيق العروض الترويجية.

‫14 شباط (فبراير) 2019

التغييرات التي تم إدخالها في هذا الإصدار

لم يعُد التشغيل التجريبي متاحًا

تمت إزالة المَعلمة dryRun من الإصدار 2.1. وينطبق ذلك على جميع طلبات البيانات من واجهة برمجة التطبيقات.

لم تعُد طرق التصحيح متاحة

لم تعُد الخدمات التالية تتيح استخدام طريقة patch:

  • Accounts
  • Accounttax
  • خلاصات البيانات
  • Liasettings
  • ShippingSettings

إزالة طرق HTTP BATCH

تمت إزالة جميع طرق HTTP BATCH من الإصدار 2.1. يمكنك استخدام customBatch كبديل. الخدمات المتأثرة هي:

  • Accounts
  • Accountstatuses
  • خلاصات البيانات
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • الترتيب
  • المنتجات
  • Productstatuses
  • ShippingSettings

خدمة الحسابات

تعديل

تمت إضافة الحقلَين businessInformation وgoogleMyBusinessLink في الطلب بعد الإطلاق الأوّلي للإصدار 2 من Content API. لهذا السبب، هناك إجراء وقائي يمنع التجّار من حذف المعلومات عن غير قصد في هذين الحقلين باستخدام update إذا لم يتم توفيرها.

في الإصدار 2، يجب أن يقدّم التجّار هذه الحقول بشكلٍ صريح مع نص فارغ ( {}) لحذفها. في الإصدار 2.1، يتم حذف الحقول إذا قدّمت نصًا أساسيًا فارغًا أو إذا لم تقدّمها.

مرجع الحساب

تغيير العلامة التجارية من AdWords إلى "إعلانات Google"

مع تغيير اسم AdWords إلى "إعلانات Google"، تم تغيير أسماء الحقول التالية ذات الصلة بـ AdWords:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
إزالة الحقول والقيم المتوقّفة نهائيًا

تمت إزالة الحقل reviewsUrl الذي تم إيقافه نهائيًا. بالإضافة إلى ذلك، تمت إزالة حالة الربط inactive من adsLinks وgoogleMyBusinessLink وyoutubeChannelLinks.

خدمة Accountstatuses

مورد AccountStatus

إزالة dataQualityIssues

تم استبدالها بـ itemLevelIssues.

Datafeed Service

مرجع خلاصة البيانات

إزالة الحقول التي تم إيقاف استخدامها نهائيًا

تمت إزالة الحقول contentLanguage وtargetCountry وintendedDestinations واستبدالها بالحقول country وlanguage وincludedDestinations وexcludedDestinations في targets.

إزالة تحديث حول مستودع المنتجات

تمت إزالة خلاصات من النوع product inventory update.

Inventory Service

تمت إزالة خدمة الإصدار 2 من inventory واستبدالها بميزتَين جديدتَين في الإصدار 2.1:

  • استخدِم الخلاصات التكميلية الجديدة لتعديل المنتجات جزئيًا.
  • استخدِم خدمة localinventory الجديدة للحصول على آخر المعلومات عن المنتجات المحلية.

خدمة الطلبات

CancelLineItem

تمت إزالة الحقول amount وamountPretax وamountTax من الطلب. يتم الآن احتساب المبلغ المسترد تلقائيًا.

CustomBatch

تمت إزالة CustomBatch من الإصدار 2.1.

InStoreRefundLineItem

تم استبدال الحقلَين amountPretax وamountTax بالحقلَين priceAmount وtaxAmount على التوالي. قد يكون الحقل priceAmount قبل الضريبة أو بعد الضريبة، وذلك حسب الموقع الجغرافي الذي تم فيه الطلب.

رد الأموال

تمت إزالة هذه الطريقة. يمكنك استخدام returnRefundLineItem كبديل.

ReturnLineItem

تمت إزالة هذه الطريقة. يمكنك استخدام returnRefundLineItem بدون تقديم مبلغ مسترد بدلاً من ذلك.

ReturnRefundLineItem

تم استبدال الحقلَين amountPretax وamountTax بالحقلَين priceAmount وtaxAmount على التوالي. قد يكون الحقل priceAmount قبل الضريبة أو بعد الضريبة، وذلك حسب الموقع الجغرافي الذي تم فيه الطلب.

ShipLineItem

تم نقل الحقول carrier وshipmentId وtrackingId في الطلب إلى shipmentInfos.

موارد الطلبات وطلبات الاختبار

شكل جديد للعروض الترويجية

يتوفّر تنسيق ترويجي جديد في الإصدار 2.1. لا يمكنك إنشاء طلبات تجريبية باستخدام عروض ترويجية.

إزالة الحقول التي تم إيقاف استخدامها نهائيًا

تمت إزالة الحقل paymentMethod، وأصبح الحقلان billingAddress وpredefinedBillingAddress من الحقول البارزة في Order وTestOrder على التوالي.

بالإضافة إلى ذلك، تمت إزالة customer.explicitMarketingPreference واستبدالها بـ customer.marketingRightsInfo في كل من Order وTestOrder.

تمت إزالة الحقل customer.email الذي تم إيقافه نهائيًا.

تم تغيير تنسيق الحقل promotions في المرجع Order.

Orderpayments Service

تمت إزالة هذه الخدمة من الإصدار 2.1.

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

ستتضمّن الاستجابة من insert السمات التالية فقط:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

لم يعُد يتم عرض التحذيرات والأخطاء غير المميتة في الرد. يتيح ذلك دمجًا أفضل مع قواعد الخلاصات وميزات أخرى متقدّمة لإدارة الخلاصات.

يحدث الآن تأخير لبضع دقائق قبل أن يتمكّن get أو list من استرداد منتج تم إدراجه.

لم يعُد من المضمون أن يكون معرّف العرض الترويجي الذي تم إرجاعه هو نفسه معرّف العرض الترويجي الذي تم إدخاله.

يتم الآن التحقّق من صحة الأسعار قبل إدراج المنتجات. يُسمح فقط باستخدام الأحرف التالية في سلسلة القيم: + و- و. والأرقام (0-9). ولم يعُد مسموحًا باستخدام الفواصل.

مرجع المنتج

تم استبدال CustomGroups بسمات مخصّصة متكرّرة

في السابق، كان يمكن تجميع السمات المخصّصة معًا عن طريق إضافة سمات مخصّصة ضمن المجموعة المخصّصة نفسها في الإصدار 2. أصبحت السمات المخصّصة الآن تكرارية في الإصدار 2.1، ما يزيل الحاجة إلى المجموعات المخصّصة.

تتضمّن السمات المخصّصة الآن حقل groupValues إضافيًا بالإضافة إلى الحقل الأصلي value، ويجب ضبط أحد الحقلين فقط، ما يعني أنّه لا يمكن ضبطهما في الوقت نفسه أو تركهما فارغَين.

بما أنّ التجّار قد ينتقلون بين الإصدار 2 والإصدار 2.1، من المحتمل أن تتضمّن المنتجات سمات مخصّصة متكرّرة لا يمكن تمثيلها في الإصدار 2 لأنّ المجموعات المخصّصة تتضمّن مستويَين كحدّ أقصى. في هذه الحالة، سيتم اقتطاع مجموعة السمات المخصّصة.

إزالة النوع والوحدة في customAttributes

في الإصدار 2.1، لن تحتوي السمات المخصّصة على type وunit. بدلاً من ذلك، يجب إلحاق الوحدات بـ value (إذا كانت متوفّرة)، ويجب رصد الأنواع تلقائيًا. على سبيل المثال، استخدِم "1.23 يورو" أو "5.6 سم" كقيمة value في الإصدار 2.1.

يحلّ ProductTypes محلّ productType وadditionalProductTypes

في السابق، كانت أنواع المنتجات مخزّنة في حقلَين، حيث كان النوع الأول في الحقل المفرد productType والباقي في الحقل المتكرّر additionalProductTypes. في الإصدار 2.1، تم استبدال الحقلَين بحقل واحد متكرّر productTypes.

تم استبدال سمة "الوجهات" بسمتَي includedDestinations وexcludedDestinations

تم إدخال الوجهات كقائمة من أزواج اسم الوجهة والنية في الإصدار 2 في الحقل المتكرّر destinations. تم استبدال هذا الحقل بحقلَين متكرّرَين هما: includedDestinations وexcludedDestinations. لا يلزم تضمين الوجهات المفعّلة تلقائيًا في includedDestinations.، وسيتطابق ذلك مع إعدادات إلغاء الوجهة في الخلاصات.

مع تغيير اسم AdWords إلى "إعلانات Google"، تم تغيير أسماء الحقول التالية ذات الصلة بـ AdWords:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
إزالة الحقول التي تم إيقاف استخدامها نهائيًا

تمت إزالة الحقول التالية التي تم إيقافها نهائيًا:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses Service

الحصول على القائمة

تمت إزالة السمة product، بالإضافة إلى المَعلمة includeAttributes. لاسترداد سمات المنتج التي تتوافق مع حالة معيّنة، استخدِم خدمة Products وقيمة الحقل الجديد productId.

قائمة

تمت إزالة المَعلمة includeInvalidInsertedItems. يتم الآن عرض جميع المنتجات بغض النظر عمّا إذا كانت صالحة، ما يعني أنّ list تتصرف الآن كما لو أنّ قيمة includeInvalidInsertedItems مضبوطة دائمًا على true.

مورد ProductStatus

DestinationsStatuses

تم استبدال الحقول intention وapprovalStatus وapprovalPending في destinationStatuses بالحقل status، وهو سلسلة يمكن أن تكون إحدى القيم approved أو disapproved أو pending.

إزالة dataQualityIssues

تم استبدالها بـ itemLevelIssues.