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

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

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

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

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

8 آذار (مارس) 2024

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

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

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

19 شباط (فبراير) 2024

خدمة مصادر الإحالات الناجحة

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

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

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

15 آذار (مارس) 2024

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

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 الذي يتيح للمستخدمين معرفة حالة مطابقة متجر Pos مع المتجر في "الملف التجاري على 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 للسماح للتجّار بإيقاف عرض التسليم المحلي خلال يوم واحد أو أكثر عندما يكون لديهم خدمة شحن مضبوطة على "التسليم المحلي" في يوم واحد.

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

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

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

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

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

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

وجهة Cloud Retail

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

أضِف حقل المواقع الإضافية للبيع بالتجزئة في السحابة الإلكترونية. هذا حقل متكرّر تم تخصيصه للعملاء الذين يستخدمون وجهة Cloud Retail. عند استخدام هذا الحقل، سيكون متاحًا عند استخدام برنامج البيع بالتجزئة على السحابة الإلكترونية. سيتم ربط هذه السمة بحقل السمات في نموذج منتج Google Cloud Retail(https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.branches.products#Product).

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

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

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

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

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

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

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

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

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

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

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

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

مرجع الحساب

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

خدمة مصادر الإحالات الناجحة

تمت إضافة خدمة "مصادر الإحالات الناجحة" التي تتيح إدارة مصادر الإحالات الناجحة (جزء من قسم "إعدادات الإحالة الناجحة" في 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

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

تمت إضافة إمكانية استخدام "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

خدمة الترويج

جارٍ إضافة "الحصول على الترويج" إلى واجهة برمجة تطبيقات الترويج.

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

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

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

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

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

خدمة إعادة التسعير

نوع قاعدة إعادة التسعير

قيمة تعداد جديدة للحقل 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

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

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

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

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

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

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

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

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

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

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

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

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

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

واجهة برمجة تطبيقات إعدادات إشعارات Pubsub

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

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

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

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

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

خدمة الطلبات

تمت إضافة دعم لشحنات الاستلام في الطلبات ووظائف وضع الحماية المقابلة.

14 آب (أغسطس) 2019

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

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

خدمة الطلبات

طلب الموارد

حقل جديد

حقل "quantityUndeliverable" جديد

7 آب (أغسطس) 2019

خدمة الطلبات

طلب الموارد

حقول جديدة

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

1 يوليو 2019

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

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

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

خدمة الطلبات

موارد Order and TestOrder

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

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

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

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

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

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

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

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

  • Accounts
  • ضريبة الحساب
  • خلاصات البيانات
  • Liasettings
  • إعدادات الشحن

إزالة طرق HTTP BATCH

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

  • Accounts
  • حالات الحساب
  • خلاصات البيانات
  • حالات خلاصة البيانات
  • Liasettings
  • تقارير الطلبات
  • موقع اللاعب
  • المنتجات
  • حالات المنتج
  • إعدادات الشحن

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

تعديل

تم تقديم الحقلين businessInformation وgoogleMyBusinessLink في الطلب بعد الإطلاق الأوّلي للإصدار الثاني من 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

إزالة مشاكل dataQuality

تم استبدال هذه الأدوات بـ "itemLevelIssues".

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

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

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

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

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

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

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

تمت إزالة الخدمة ذات الإصدار 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.

موارد Order and TestOrder

التنسيق الجديد للعرض الترويجي

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

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

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

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

تمت إزالة الحقل المتوقّف customer.email.

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

خدمة دفعات الطلبات

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

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

سيحتوي الرد من insert على السمات التالية فقط:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

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

لم يعُد رقم تعريف العرض الذي يتم عرضه هو نفسه رقم تعريف العرض الإدخالي.

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

مورد منتجات

تم استبدال المجموعات المخصّصة بسمات مخصّصة متكررة

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

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

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

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

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

يحل ProductTypes محل productType وadditionalProductTypes.

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

تم استبدال سمة Destinations (الوجهات) بسمة التصفّح (الوجهات) والوجهات المستبعَدة (excludedDestinations)

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

بعد تغيير 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.

إزالة مشاكل dataQuality

تم استبدال هذه الأدوات بـ "itemLevelIssues".