本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

識別項目的物件。

[GetRecommendations](API_RS_GetRecommendations.md) 和 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) APIs 會傳回 的清單`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)。  
類型：Double  
必要：否

## 另請參閱
<a name="API_RS_PredictedItem_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem)