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

30 تشرين الأول (أكتوبر) 2024

في إطار إيقاف واجهات برمجة التطبيقات المتعلّقة بالتسوية، تم إيقاف الخدمات التالية نهائيًا: - settlementreports - settlementtranscations

إنّ إيقاف واجهات برمجة التطبيقات المتعلّقة بالتسوية مرتبط ببرنامج "الشراء على Google" وواجهات برمجة التطبيقات ذات الصلة بالطلبات الذي تم إيقافه سابقًا.

من المتوقّع أن تفشل طلبات الاتصال بالخدمات المذكورة أعلاه مع ظهور استجابة 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، ما يتيح للمستخدمين معرفة حالة مطابقة Pos Store مع متجر الملفات التجارية على 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

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

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

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

لمزيد من المعلومات، اطّلِع على أدلة إعداد التقارير

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

خدمة الترويج

إضافة 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

مرجع "الشراء على 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

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، وفلاتر وحقول جديدة لطرق القراءة (list وget).

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

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

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

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

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

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

Local inventory API

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

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

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

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

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
  • حالات الحساب
  • خلاصات البيانات
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • الترتيب
  • المنتجات
  • Productstatuses
  • إعدادات الشحن

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

تعديل

تم تقديم الحقلين 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:

خدمة الطلبات

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.

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

تمت إزالة هذه الخدمة من الإصدار 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 يورو" أو "5.6 سم" كقيمة لسمة value في الإصدار 2.1.

تحلّ سمة ProductTypes محلّ سمتَي productType وadditionalProductTypes.

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

تم استبدال سمة Destinations (الوجهات) بسمتي includedDestinations (الوجهات المُضمَّنة) و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.

إزالة dataqualityISSUEs

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