翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # GetActionRecommendations 予測スコアで降順にソートされたレコメンデーションアクションのリストを返します。PERSONALIZED\$1ACTIONS レシピでトレーニングされたソリューションバージョンをデプロイするカスタムキャンペーンがある場合は、`GetActionRecommendations` API を使用してください。 PERSONALIZED\$1ACTIONS レシピの詳細については、「[PERSONALIZED\$1ACTIONS recipes](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html)」を参照してください。アクションレコメンデーションの取得については、「[Getting action recommendations](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html)」を参照してください。 ## リクエストの構文 ``` POST /action-recommendations HTTP/1.1 Content-type: application/json { "campaignArn": "string", "filterArn": "string", "filterValues": { "string" : "string" }, "numResults": number, "userId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) ** アクションレコメンデーションの取得に使用するキャンペーンの Amazon リソースネーム (ARN)。このキャンペーンでは、PERSONALIZED\$1ACTIONS レシピでトレーニングされたソリューションバージョンをデプロイする必要があります。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) ** 返されたレコメンデーションに適用するフィルターの ARN。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。このパラメータを使用するときは、フィルターのリソースが `ACTIVE` であることを確認してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterValues](#API_RS_GetActionRecommendations_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 です。必須: いいえ ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) ** 返される結果の数。デフォルトは 5 です。最大は 100 です。タイプ: 整数値の範囲: 最小値は 0 です。必須: いいえ ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) ** アクションレコメンデーションを提供するユーザーのユーザー ID。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "actionList": [ { "actionId": "string", "score": number } ], "recommendationId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) ** 予測スコアで降順にソートされたアクションレコメンデーションのリスト。リストには最大 100 個のアクションを含めることができます。アクションスコアの詳細については、「[How action recommendation scoring works](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)」を参照してください。型: [PredictedAction](API_RS_PredictedAction.md) オブジェクトの配列 ** [recommendationId](#API_RS_GetActionRecommendations_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/GetActionRecommendations) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations)