Get suggestion sponsored products for a recipe

استرجع جميع الأدوات أو الاقترانات أو الاقتراحات المدعومة المرتبطة بوصفة محددة. يتيح لك ذلك إثراء صفحة تفاصيل الوصفة بعمليات بيع إضافية مستهدفة وعالية الجودة، مثل أجهزة المطبخ أو اقتراحات المشروبات المتوافقة، والمصممة بدقة للطبق الذي يشاهده المستخدم. حالات الاستخدام: البيع الإضافي لأدوات المطبخ • تعرض وصفة «يخنة اللحم البقري» قدراً هولندياً من الحديد الزهر مدعوماً أو سكين طاهٍ من علامة تجارية شريكة. توسيع السلة بما يتجاوز الطعام. اقترانات النبيذ والمشروبات • قسم «مثالي مع هذا الطبق» في صفحة الوصفة، يضم نبيذاً أو بيرة حرفية أو مشروبات غازية مدعومة. المطاعم — اقتراحات مكملة • تقترح القائمة الرقمية نبيذاً متوافقاً أو حلوى مثالية للطبق المحدد. بيع إضافي في سياقه. نمط الحياة والتقديم • اقتراحات مدعومة لأدوات المائدة والمناديل والديكورات ذات الطابع الخاص، مثل العشاء الرومانسي أو حفلات الشواء الصيفية.

GET
/recipes/{recipeId}/sponsored-products/suggestions
Recipes
لا يتطلب أرصدة

الاستجابة

200
application/json
object[]

SuggestionSponsoredProductArray

object[]

SuggestionSponsoredProduct

اقتراح وصفة مرتبط بمنتج مدعوم

object

recipeToolId?

المعرّف الفريد لإدخال هذا الاقتراح

integer<int32>

recipeId?

معرّف الوصفة التي تنتمي إليها هذه الأداة

integer<int32>

name?

اسم العرض للأداة

string | null

priority?

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

integer<int16>

productId?

معرّف المنتج المدعوم

integer<int32>

shopProductId?

المعرّف الخاص بالمتجر للمنتج

string | null

productName?

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

string | null

brand?

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

string | null

ean?

الرمز الشريطي EAN للمنتج

string | null

format?

صيغة تغليف المنتج

string | null

weightGrams?

وزن المنتج بالغرام

number<double> | null
401
application/json
object

غير مصرّح به

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

محظور

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

غير مقبول

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

كيان غير قابل للمعالجة

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

طلبات كثيرة جداً (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

خطأ داخلي في الخادم

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

بوابة غير صالحة (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

انتهت مهلة البوابة (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string