3 مارس 2022

التغييرات الطارئة.

API التسويق

مجموعات المنتجات

تغيير على فلاتر البحث في الكتالوج

بدءًا من 3 مارس 2022، قمنا بتغيير طريقة عمل بعض الفلاتر لإنشاء مجموعات منتجات في الكتالوج لديك. وتؤثر هذه التغييرات على العناصر التي يتم إدخالها في مجموعة المنتجات عند إنشاء إحداها.

سيتغير سلوك عامل التشغيل وحقل اليوميات
في غضون 90 يومًا. في حالة وجود أي مجموعات للمنتجات في الكتالوج لديك تستخدم الفلاتر المتأثرة بعد 1 يونيو 2022، فقد تتغير العناصر الموجودة بها. وهذا يعني أنه يمكن عرض عناصر مختلفة في إعلاناتك أو متاجرك التي تستخدم هذه المجموعات. علاوة على ذلك، قد ترجع أي طلبات تستخدم الفلاتر مجموعة مختلفة من العناصر.

يمكن العثور على مزيد من المعلومات حول فلاتر مجموعة المنتجات هنا.

عوامل التشغيل التي يشملها التغيير

عامل التشغيل	التغيير
`contains` / `not_contains`	يجب أن يتطابق الاستعلام الآن مع كلمة كاملة، وليس مجرد جزء من كلمة. على سبيل المثال، سيقوم `name: {"contains": "red car"}` بإرجاع كل المنتجات التي تحتوي على كلمتين، مثل "red car" و"red fast car"، ولكن لن يُرجع "red carpet". حيث تُعد الكلمات الموصولة كلمات منفصلة. على سبيل المثال، إذا استعلمت عن `name: {"contains": "shirt"}`، فسيتطابق كل من "shirt" و"T-shirt". يجب أن تظهر كل كلمة في استعلامك ضمن الحقل الذي تحاول مطابقته، لكن لا يلزم أن تكون بترتيب متعاقب. على سبيل المثال، إذا استعلمت عن `name: {"contains": "jeans blue"}`، فإن عبارة "blue cropped jeans" ستتطابق، ولكن لن تتطابق كلمة "jeans" أو "blue" وحدها.
`lt`	لم يعد خيار الفلترة هذا متوفرًا لحقول `custom_label`.
`lte`	لم يعد خيار الفلترة هذا متوفرًا لحقول `custom_label`
`gt`	لم يعد خيار الفلترة هذا متوفرًا لحقول `custom_label`
`gte`	لم يعد خيار الفلترة هذا متوفرًا لحقول `custom_label`
`starts_with`	يتوفر حاليًا خيار الفلترة هذا لحقل فئة المنتج فقط. بالنسبة للحقول الأخرى، يجب استخدام الفلتر `contains`.

الحقول التي يشملها التغيير

الحقل	الوصف
`custom_label_0`	يمثل قيمة التسمية المخصصة لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية. يتم التعامل مع القيمة كسلسلة. لا تتوفر عوامل التشغيل الرقمية (`gt` و`gte` و`lt` و`lte`) في هذا الحقل. بدلاً من ذلك، يجب استخدام `custom_number_0 field`، الذي يدعم الأعداد الصحيحة.
`custom_label_1`	يمثل قيمة التسمية المخصصة لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية. يتم التعامل مع القيمة كسلسلة. لا تتوفر عوامل التشغيل الرقمية (`gt` و`gte` و`lt` و`lte`) في هذا الحقل. بدلاً من ذلك، يجب استخدام الحقل `custom_number_1`، الذي يدعم الأعداد الصحيحة.
`custom_label_2`	يمثل قيمة التسمية المخصصة لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية. يتم التعامل مع القيمة كسلسلة. لا تتوفر عوامل التشغيل الرقمية (`gt` و`gte` و`lt` و`lte`) في هذا الحقل. بدلاً من ذلك، يجب استخدام الحقل `custom_number_2`، الذي يدعم الأعداد الصحيحة.
`custom_label_3`	يمثل قيمة التسمية المخصصة لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية. يتم التعامل مع القيمة كسلسلة. لا تتوفر عوامل التشغيل الرقمية (`gt` و`gte` و`lt` و`lte`) في هذا الحقل. بدلاً من ذلك، يجب استخدام الحقل `custom_number_3`، الذي يدعم الأعداد الصحيحة.
`custom_label_4`	يمثل قيمة التسمية المخصصة لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية. يتم التعامل مع القيمة كسلسلة. لا تتوفر عوامل التشغيل الرقمية (`gt` و`gte` و`lt` و`lte`) في هذا الحقل. بدلاً من ذلك، يجب استخدام الحقل `custom_number_4`، الذي يدعم الأعداد الصحيحة.
`custom_number_0`	قيمة عدد صحيح مخصص لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية.
`custom_number_1`	قيمة عدد صحيح مخصص لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية.
`custom_number_2`	قيمة عدد صحيح مخصص لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية.
`custom_number_3`	قيمة عدد صحيح مخصص لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية.
`custom_number_4`	قيمة عدد صحيح مخصص لعنصر منتج أو فندق أو وجهة أو مركبة أو قائمة معروضات منزلية.

تقسيم الصفحات استنادًا إلى الإزاحة

يتم تقييد نقطة النهاية GET /{product-catalog-id}/products?filter=.....&offset=...&limit=...&bulk_pagination=false حاليًا عند 2000 نتيجة.

التغييرات الجديدة

نحن لا نفرض حاليًا أي تقييدات على حجم الإزاحة + التقييد. بدءًا من اليوم، عندما تكون القيمة bulk_pagination = false، لا يمكن أن تكون قيمة الإزاحة + التقييد أكبر من 2000. على سبيل المثال:

لن تكون العملية صالحة عندما تكون قيمة الإزاحة = 1000 وقيمة التقييد = 1500، حيث سيكون مجموع الإزاحة + التقييد = 2500
لن تكون العملية صالحة عندما تكون قيمة الإزاحة = 100 وقيمة التقييد = 1500، حيث سيكون مجموع الإزاحة + التقييد = 1600

لتقسيم صفحات الكتالوج بدون تقييدات، يجب استخدام bulk_pagination = true.