本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# GetActionRecommendations
<a name="API_RS_GetActionRecommendations"></a>

返回按预测分数以降序排列的建议操作列表。如果您的自定义市场活动部署了使用 PERSONALIZED\$1ACTIONS 配方训练的解决方案版本，请使用 `GetActionRecommendations` API。

有关 PERSONALIZED\$1ACTIONS 配方的更多信息，请参阅 [PERSONALIZED\$1ACTIONS 配方](https://docs.amazonaws.cn/personalize/latest/dg/nexts-best-action-recipes.html)。有关获取操作建议的更多信息，请参阅[获取操作建议](https://docs.amazonaws.cn/personalize/latest/dg/get-action-recommendations.html)。

## 请求语法
<a name="API_RS_GetActionRecommendations_RequestSyntax"></a>

```
POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}
```

## URI 请求参数
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

该请求不使用任何 URI 参数。

## 请求正文
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

请求接受采用 JSON 格式的以下数据。

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
用于获取操作建议的市场活动的 Amazon 资源名称 (ARN)。此市场活动必须部署使用 PERSONALIZED\$1ACTIONS 配方训练的解决方案版本。  
类型：字符串  
长度约束：最大长度为 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必需：否

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
要应用于返回建议的筛选器的 ARN。有关更多信息，请参阅[筛选建议](https://docs.amazonaws.cn/personalize/latest/dg/filter.html)。  
使用此参数时，确保筛选器资源为 `ACTIVE`。  
类型：字符串  
长度约束：最大长度为 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必需：否

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
筛选建议时要使用的值。对于筛选器表达式中的每个占位符参数，提供参数名称（大小写相符）作为键，提供筛选器值作为对应的值。用英文逗号分隔一个参数的多个值。  
对于使用 `INCLUDE` 元素来包含操作的筛选条件表达式，您必须为表达式中定义的所有参数提供值。对于带有使用 `EXCLUDE` 元素来排除操作的表达式的筛选条件，您可以省略 `filter-values`。在本例中，Amazon Personalize 未使用表达式的这一部分来筛选建议。  
有关更多信息，请参阅[筛选建议和用户细分](https://docs.amazonaws.cn/personalize/latest/dg/filter.html)。  
类型：字符串到字符串映射  
映射条目：最多 25 项。  
键长度限制：最大长度为 50。  
键模式：`[A-Za-z0-9_]+`  
值长度限制：最大长度为 1000。  
必需：否

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
要返回的结果数量。默认值为 5。最大值为 100。  
类型：整数  
有效范围：最小值为 0。  
必需：否

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
要为其提供操作建议的用户的用户 ID。  
类型：字符串  
长度约束：最大长度为 256。  
必需：否

## 响应语法
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## 响应元素
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
按预测分数降序排序的操作建议列表。列表中最多可以有 100 个操作。有关操作分数的信息，请参阅[操作建议评分的工作原理](https://docs.amazonaws.cn/personalize/latest/dg/how-action-recommendation-scoring-works.html)。  
类型：[PredictedAction](API_RS_PredictedAction.md) 对象数组

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
建议的 ID。  
类型：字符串

## 错误
<a name="API_RS_GetActionRecommendations_Errors"></a>

 ** InvalidInputException **   
为字段或参数提供有效值。  
HTTP 状态代码：400

 ** ResourceNotFoundException **   
指定的资源不存在。  
HTTP 状态代码：404

## 另请参阅
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：
+  [Amazon 命令行界面 V2](https://docs.amazonaws.cn/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于.NET 的 SDK V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于 C\$1\$1 的 SDK](https://docs.amazonaws.cn/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于 Go v2 的 SDK](https://docs.amazonaws.cn/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于 Java 的 SDK V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon JavaScript V3 版 SDK](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于 Kotlin 的 SDK](https://docs.amazonaws.cn/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于 PHP 的 SDK V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon Python 软件开发工具包](https://docs.amazonaws.cn/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [Amazon 适用于 Ruby V3 的 SDK](https://docs.amazonaws.cn/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations)