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

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

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

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

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

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 للخدمة Recommendations.

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

وجهة Cloud Retail

المواقع الإضافية في Cloud Retail

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

22 أيار (مايو) 2023

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

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

11 نيسان (أبريل) 2023

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

تلبية الطلبات محليًا

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

3 نيسان (أبريل)

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

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

20 شباط (فبراير) 2023

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

مرجع الحساب

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

خدمة 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

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

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

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

• تقارير "الأكثر مبيعًا" باستخدام جدولَي BestSellersProductClusterView وBestSellersBrandView
• تقرير "مكانة السعر في المنافسة" باستخدام جدول PriceCompetitivenessProductView
• تقرير "معلومات مفصّلة عن الأسعار" باستخدام جدول PriceInsightsProductView

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

7 تشرين الثاني (نوفمبر) 2022

خدمة خلاصات البيانات

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

14 أيلول (سبتمبر) 2022

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

9 آب (أغسطس) 2022

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

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

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

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

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

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

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

8 كانون الأول (ديسمبر) 2021

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

مرجع الحساب

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

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

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

خدمة الترويج

إضافة Get Promotion إلى Promotion API

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

Shipping Settings API

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

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

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

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

مرجع الحساب

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

13 أيلول (سبتمبر) 2021

خدمة BuyOnGooglePrograms

مرجع BuyOnGoogleProgramStatus

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

طريقة جديدة لتعديل 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 جديد لاستبعاد العروض من الإعلانات في بلدان معيّنة

مرجع حالات المنتجات

حقول 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

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

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

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

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

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

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

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

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

Local inventory API

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

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

Pubsub notification settings API

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

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

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

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

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

خدمة الطلبات

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

14 آب (أغسطس) 2019

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

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

خدمة الطلبات

مورد الطلب

حقل جديد

حقل quantityUndeliverable جديد

7 آب (أغسطس) 2019

خدمة الطلبات

مورد الطلب

الحقول الجديدة

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

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

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

إتاحة خلاصات Content API التكميلية التي تمت إضافتها في خدمة "المنتجات"

11 حزيران (يونيو) 2019

خدمة الطلبات

مراجع Order وTestOrder

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

تمت إضافة حقل 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 في الطلب بعد الإطلاق الأولي لإصدار Content API 2. ولهذا السبب، هناك تدابير وقائية تمنع التجّار من حذف المعلومات في هذين الحقلين عن طريق الخطأ باستخدام 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.

خدمة خلاصة البيانات

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

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

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

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

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

خدمة المستودع

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

• استخدِم الخلاصات التكميلية الجديدة لإجراء تعديلات جزئية على المنتجات.
• استخدِم خدمة localinventory الجديدة لتعديل المنتجات داخل المتجر.

خدمة الطلبات

CancelLineItem

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

CustomBatch

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

InStoreRefundLineItem

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

ردّ الأموال

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

ReturnLineItem

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

ReturnRefundLineItem

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

ShipLineItem

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

مراجع Order وTestOrder

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

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

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

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

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

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

تم تغيير تنسيق الحقل promotions في المورد Order.

خدمة Orderpayments

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

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

لن تحتوي الإجابة الواردة من insert إلا على السمات التالية:

• channel
• contentLanguage
• id
• offerId
• targetCountry

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

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

لم يعُد من المؤكد أن يكون معرّف العرض الذي تم إرجاعه مطابقًا لمعرّف العرض الذي تم إدخاله.

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

مرجع المنتج

تم استبدال CustomGroups بـ customAttributes المتكرّرة

في السابق، كان يمكن تجميع السمات المخصّصة معًا عن طريق إضافة سمات مخصّصة ضمن المجموعة المخصّصة نفسها في الإصدار 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.

تم استبدال سمة Destinations (الوجهات) بسمتي includedDestinations (الوجهات المُضمَّنة) وexcludedDestinations (الوجهات المُستبعَدة).

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

إعادة تسمية الحقول ذات الصلة بخدمة AdWords

مع تحوُّل AdWords إلى "إعلانات Google"، تمت إعادة تسمية الحقول التالية المتعلقة بAdWords:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

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

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

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

خدمة Productstatuses

الحصول على البيانات وعرضها

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

قائمة

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

مورد ProductStatus

DestinationsStatuses

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

إزالة dataQualityIssues

حلّت هذه الإصدارات محلّ itemLevelIssues.