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

‫19 يوليو 2024

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

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

‫20 مايو 2024

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إيقاف برنامج "الشراء على 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

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

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

• 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 التي تتيح للمستخدمين معرفة حالة مطابقة متجر Pos Store مع حساب Google Business متجر الملفات الشخصية وتلميح لحلّها في حال حدوث مشكلة

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 المنتج الأمثل.

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 support.:

• 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.

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

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

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

8 ديسمبر 2021

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

مورد الحساب

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

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

25 أكتوبر 2021

خدمة الترويج

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

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

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

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

إضافة حقل warehouseName جديد في WarehouseBasedDeliveryTime الرجوع إليها مستودع من قِبل اسم المستودع.

4 أكتوبر 2021

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

مورد الحساب

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

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

خدمة الشراء على GooglePrograms

مرجع الشراء علىGoogleProgramStatus

تمت إضافة حقول جديدة في 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

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

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

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

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

خدمة الطلبات

مراجع الطلب والاختبار

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

تمت إضافة حقل 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

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

مورد حالة الحساب

إزالة dataqualityISSUEs

وحلَّ "itemLevelIssues" محل هذه النطاقات.

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

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

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

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

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

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

خدمة المخزون

لقد تمت إزالة الإصدار 2 من خدمة inventory واستبدالها بميزتَين جديدتَين في v2.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.

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

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

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

سيتضمّن الردّ من insert السمات التالية فقط:

• channel
• contentLanguage
• id
• offerId
• targetCountry

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

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

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

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

مورد المنتج

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

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

تم استبدال سمة "الوجهات" بسمة "includeDestinations" و"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" محل هذه النطاقات.