翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # GetPersonalizedRanking 特定のユーザーに推奨されるアイテムのリストを再ランク付けします。リストの最初のアイテムは、ユーザーが関心を持つ可能性が最も高いアイテムとみなされます。 **注記** キャンペーンにデプロイするソリューションが PERSONALIZED\$1RANKING タイプのレシピを使用して作成済みであることが必要です。 ## リクエストの構文 ``` POST /personalize-ranking HTTP/1.1 Content-type: application/json { "campaignArn": "string", "context": { "string" : "string" }, "filterArn": "string", "filterValues": { "string" : "string" }, "inputList": [ "string" ], "metadataColumns": { "string" : [ "string" ] }, "userId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) ** パーソナライズされたランキングの生成に使用するキャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) ** レコメンデーションを取得するときに使用するコンテキストメタデータ。コンテキストメタデータには、ユーザーの現在の場所やデバイスタイプなど、ユーザーのレコメンデーションを取得するときに関連する可能性のあるインタラクション情報が含まれます。タイプ: 文字列から文字列へのマップマップエントリ: アイテムの最大数は 150 です。キーの長さの制限: 最大長は 150 です。キーパターン: `[A-Za-z\d_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 特定のユーザーのレコメンデーションからアイテムを含めたり、アイテムを除外したりするために作成したフィルターの Amazon リソースネーム (ARN)。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) ** レコメンデーションをフィルタリングするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。 `INCLUDE` 要素を使用してアイテムを含めるフィルター式について、式で定義されているすべてのパラメータの値を指定する必要があります。`EXCLUDE` 要素を使用してアイテムを除外する式を含むフィルターについては、`filter-values` を省略できます。この場合、Amazon Personalize は、レコメンデーションをフィルタリングするために式のその部分を使用しません。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。タイプ: 文字列間のマッピングマップエントリ: アイテムの最大数は 25 です。キーの長さの制限: 最大長は 50 です。キーパターン: `[A-Za-z0-9_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) ** ランク付けするアイテムのリスト (`itemId` による)。アイテムがトレーニングデータセットに含まれていなかった場合、そのアイテムは再ランク付けされたリストの最後に追加されます。レコメンデーションにメタデータを含める場合、最大数は 50 です。それ以外の場合、最大数は 500 です。型: 文字列の配列長さの制約: 最大長は 256 です。必須: はい ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) ** キャンペーンを作成または更新したときにレコメンデーションのメタデータを有効にした場合は、アイテムデータセットのメタデータ列を指定して、パーソナライズしたランキングに含めるようにします。マップキーは `ITEMS` で、値はアイテムデータセットの列名のリストです。指定できる列の最大数は 10 です。キャンペーンのメタデータを有効にする方法については、「[Enabling metadata in recommendations for a campaign](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)」を参照してください。タイプ: 文字列マップの配列への文字列マップエントリ: アイテムの最大数は 1 です。キーの長さの制限: 最大長は 256 です。配列メンバー: 最大数は 99 アイテムです。長さの制限: 最大長は 1,024 です。必須: いいえ ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) ** キャンペーンによるパーソナライズされたランキングの提供先とするユーザー。タイプ: 文字列長さの制約: 最大長は 256 です。必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "personalizedRanking": [ { "itemId": "string", "metadata": { "string" : "string" }, "promotionName": "string", "reason": [ "string" ], "score": number } ], "recommendationId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) ** アイテムのリスト (ユーザーが関心を持つ可能性が最も高い順)。最大数は 500 です。型: [PredictedItem](API_RS_PredictedItem.md) オブジェクトの配列 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) ** レコメンデーションの ID。タイプ: 文字列 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースは存在しません。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking)