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

# 使用即時建議取得項目中繼資料
<a name="getting-recommendations-with-metadata"></a>

 如果您將行銷活動或建議者設定為傳回建議項目的中繼資料，您可以指定要包含在 [GetRecommendations](API_RS_GetRecommendations.md) API 操作中的資料欄。或者，您可以在使用 Amazon Personalize 主控台測試行銷活動時指定資料欄。

 如需啟用行銷活動中繼資料的詳細資訊，請參閱 [建議中的項目中繼資料](campaigns.md#create-campaign-return-metadata)。如需啟用建議者中繼資料的詳細資訊，請參閱 [在 Amazon Personalize 中的網域建議程式建議中啟用中繼資料](create-recommender-return-metadata.md)。

下列程式碼範例示範如何指定要包含在 AWS CLI 或 AWS SDKs中的中繼資料欄。若要使用 Amazon Personalize 主控台執行此操作，您可以在測試行銷活動時指定資料欄。如需詳細資訊，請參閱[取得項目建議 （主控台）](getting-real-time-item-recommendations.md#get-real-time-recommendations-console)。

**Topics**
+ [包含項目中繼資料與建議 (AWS CLI)](#getting-recommendations-with-metadata-cli)
+ [包含項目中繼資料與建議AWS SDKs)](#getting-recommendations-with-metadata-sdk)

## 包含項目中繼資料與建議 (AWS CLI)
<a name="getting-recommendations-with-metadata-cli"></a>

如果您在行銷活動或建議者的建議中啟用中繼資料，您可以指定要包含在回應中的項目資料集中繼資料欄。下列程式碼範例示範如何在建議請求中指定中繼資料資料欄。

```
aws personalize-runtime get-recommendations \
--campaign-arn campaign arn \
--user-id User ID \
--num-results 10 \
--metadata-columns "{\"ITEMS\": ["\"columnNameA"\","\"columnNameB"\"]}"
```

## 包含項目中繼資料與建議AWS SDKs)
<a name="getting-recommendations-with-metadata-sdk"></a>

如果您在行銷活動或建議者的建議中啟用中繼資料，您可以指定要包含在回應中的項目資料集中繼資料欄。下列程式碼範例示範如何在建議請求中指定中繼資料資料欄。

```
import boto3

personalizeRt = boto3.client('personalize-runtime')

response = personalizeRt.get_recommendations(
  campaignArn = 'Campaign ARN',
  userId = 'User ID',
  numResults = 10
  metadataColumns = {
    "ITEMS": ['columnNameA','columnNameB']
  }
)

print("Recommended items")
for item in response['itemList']:
  print(item['itemId'])
  print(item['metadata'])
```