翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リアルタイムレコメンデーションを使用したアイテムメタデータの取得
<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 SDK に含めるメタデータ列を指定する方法を示しています。Amazon Personalize コンソールを使用してこれを行うには、キャンペーンをテストする際に列を指定します。詳細については、「[アイテムレコメンデーションの取得 (コンソール)](getting-real-time-item-recommendations.md#get-real-time-recommendations-console)」を参照してください。

**Topics**
+ [レコメンデーションへのアイテムメタデータの組み込み (AWS CLI)](#getting-recommendations-with-metadata-cli)
+ [レコメンデーションへのアイテムメタデータの組み込み (AWS SDK)](#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 SDK)
<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'])
```