Get ingredient sponsored products for a recipe

特定のレシピの材料に明示的に紐付けられた、スポンサー商品をすべて取得します。単一のレシピを対象にすることで、ユーザーがその料理を表示しているときに、どのブランドのSKUをネイティブに配置すべきかを即座に特定できます。タイミングを正確に合わせたリテールメディア掲載に最適なツールです。 利用例: コンテキストに応じた商品掲載 • ユーザーが「Classic Tiramisu」のレシピを表示 → 材料一覧の隣に「Brand Y Mascarpone」がスポンサー付きのおすすめとして表示されます。購入意欲が最高潮に達したタイミングで、高いコンバージョンが期待できます。 レストラン — サプライヤーとの提携 • レストランがデジタルメニューで、レシピの材料の隣にサプライヤーの商品を表示します。サプライヤーから広告収益を得られます。 ワンクリックで「レシピを購入」 • バックオフィスで設定したスポンサーSKUを使って「すべてカートに追加」ボタンを実現します。レシピに合った収益性の高いカートを作成できます。

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
クレジットは不要です
APIキーを取得料金を見る

Get a recipe

GET /recipes/{recipeId}

Get suggestion sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/suggestions

レスポンス

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

スポンサー商品にリンクされたレシピ食材

object

recipeIngredientId

この食材エントリの一意識別子

integer<int32>

recipeId

この食材が属するレシピの識別子

integer<int32>

name

食材の表示名

string

quantity?

使用する食材の量

number<double> | null

measureUnitId?

数量の計量単位識別子。GET /definitions/measure-unitsで解決できます

integer<int32> | null

unitQuantity

スポンサー商品の単位数量

integer<int32>

priority

この商品の食材に対する推薦順位。最も低い値が最適な一致を示し、順位は1から始まります。formatScoreと同様に、優先度が高くなるほどスコアが上がることはなく、スコアのない商品は最後になります。要求された言語のデータがない商品は応答から除外されるため、順位の値が飛ぶ場合があります。

integer<int16>

formatScore?

0.01から100までの形式適合性スコア。購入する量のうち、レシピが実際に使用する割合です。100はパックの容量と必要量が完全に一致することを示し、50は必要量の2倍を購入することを示します。同じスコアの商品は形式の適合性が同等であるため、優先度を使って選択します。ただし0.01の場合は尺度が飽和しており、パックが大きすぎることだけを示します。適合性を評価できない場合はヌルです。商品重量が不明、食材の量にグラム換算値がない（適量など）、またはこのフィールドが追加される前の関連付けで、まだ再計算されていない場合が該当します。容量は1ミリリットル=1グラムとして扱います。

number<double> | null

productId

スポンサー商品識別子

integer<int32>

shopProductId?

商品の店舗固有識別子

string | null

productName

スポンサー商品の名前

string

brand

スポンサー商品のブランド

string

ean?

商品のEANバーコード

string | null

format?

商品の包装形式

string | null

weightGrams?

商品の重量（グラム）

number<double> | null

imageUrl?

商品の画像URL

string | 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

Get a recipe

GET /recipes/{recipeId}

Get suggestion sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/suggestions