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

# PredictedItem
<a name="API_RS_PredictedItem"></a>

标识物品的对象。

[GetRecommendations](API_RS_GetRecommendations.md) 和 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API 会返回 `PredictedItem` 的列表。

## 目录
<a name="API_RS_PredictedItem_Contents"></a>

 ** itemId **   <a name="personalize-Type-RS_PredictedItem-itemId"></a>
推荐的物品 ID。  
类型：字符串  
长度约束：最大长度为 256。  
必需：否

 ** metadata **   <a name="personalize-Type-RS_PredictedItem-metadata"></a>
有关物品数据集中的物品的元数据。  
类型：字符串到字符串映射  
键长度限制：最大长度为 150。  
值长度限制：最大长度为 20000。  
必需：否

 ** promotionName **   <a name="personalize-Type-RS_PredictedItem-promotionName"></a>
包含预测物品的推广名称。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必需：否

 ** reason **   <a name="personalize-Type-RS_PredictedItem-reason"></a>
如果您使用 User-Personalization-v2，则会有一份理由清单，说明为什么在推荐中包括该物品。可能的原因包括：  
+ 推广物品 - 表示您在推荐请求中应用的推广活动中包括该物品。
+ 浏览 - 表示该物品包括在浏览中。使用浏览时，推荐包括的物品具有更少的交互数据或用户相关性。有关浏览的更多信息，请参阅[浏览](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration)。
+  热门物品 - 表示该物品作为占位符热门物品包括在内。如果您使用筛选条件，那么根据筛选条件删除的推荐数量，Amazon Personalize 可能会添加占位符物品以满足推荐请求的 `numResults`。这些物品是基于交互数据的热门物品，符合您的筛选条件。它们没有针对用户的相关性评分。
类型：字符串数组  
长度约束：最大长度为 256。  
必需：否

 ** score **   <a name="personalize-Type-RS_PredictedItem-score"></a>
模型对物品将成为下一个用户选择的确定性的数字表示。有关评分逻辑的更多信息，请参阅[建议分数](getting-recommendations.md#how-scores-work)。  
类型：双精度  
必需：否

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

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem)