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