Applies one or more recommendations.

POST

/recommendations/apply

最后修改时间：2026-08-27 23:21:02

责任人：未设置

应用一个或多个推荐。

当应用 recommendationType 为 NEW_CAMPAIGN 或 NEW_VIDEO_CAMPAIGN 的推荐时，这将返回 HTTP 状态代码 ACCEPTED 以指示已接受处理。
然后您可以使用 POST /recommendations/list 检查这些推荐的状态。

如果推荐已成功应用，其状态将为 APPLY_SUCCESS。否则，状态将为 APPLY_FAILED。

授权资源类型：
DSP Rodeo Entity ID, DSP Advertiser Account ID

参数名：
Amazon-Ads-AccountId

参数位置：
header

需要以下权限之一：
["advertiser_campaign_edit","advertiser_campaign_view"]

请求参数

Header 参数

Body 参数application/vnd.applyRecommendationsRequest.v1+json必填

示例

{
    "recommendationIds": [
        "string"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/recommendations/apply' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Content-Type: application/vnd.applyRecommendationsRequest.v1+json' \
--data '{
    "recommendationIds": [
        "string"
    ]
}'

返回响应

🟢207

application/vnd.applyRecommendationsResponse.v1+json

多状态。

Bodyapplication/vnd.applyRecommendationsResponse.v1+json

示例

{}

🟠400请求有误

🟠429

🔴500服务器错误

修改于 2026-08-27 23:21:02

ListReachForecastTargetsV1

Retrieves a list of recommendations.