Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# GetActionRecommendations
<a name="API_RS_GetActionRecommendations"></a>

Renvoie une liste d'actions recommandées, triée par ordre décroissant par score de prédiction. Utilisez l'`GetActionRecommendations`API si vous avez une campagne personnalisée qui déploie une version de solution entraînée par une recette PERSONALIZED\$1ACTIONS. 

[Pour plus d'informations sur les recettes PERSONALIZED\$1ACTIONS, voir recettes PERSONALIZED\$1ACTIONS.](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html) Pour plus d'informations sur l'obtention de recommandations d'action, voir [Obtenir des recommandations d'action](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html).

## Syntaxe de la demande
<a name="API_RS_GetActionRecommendations_RequestSyntax"></a>

```
POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}
```

## Paramètres de demande URI
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
Le nom de ressource Amazon (ARN) de la campagne à utiliser pour obtenir des recommandations d'action. Cette campagne doit déployer une version de solution entraînée avec une recette PERSONALIZED\$1ACTIONS.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : non

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
L'ARN du filtre à appliquer aux recommandations renvoyées. Pour de plus amples informations, veuillez consulter [Filtrage des recommandations](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Lorsque vous utilisez ce paramètre, assurez-vous que la ressource de filtre est bien`ACTIVE`.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : non

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
Les valeurs à utiliser lors du filtrage des recommandations. Pour chaque paramètre d'espace réservé de votre expression de filtre, indiquez le nom du paramètre (le cas échéant) sous forme de clé et la ou les valeurs du filtre comme valeur correspondante. Séparez les valeurs multiples d'un paramètre par une virgule.   
Pour les expressions de filtre qui utilisent un `INCLUDE` élément pour inclure des actions, vous devez fournir des valeurs pour tous les paramètres définis dans l'expression. Pour les filtres contenant des expressions qui utilisent un `EXCLUDE` élément pour exclure des actions, vous pouvez omettre le`filter-values`. Dans ce cas, Amazon Personalize n'utilise pas cette partie de l'expression pour filtrer les recommandations.  
Pour plus d'informations, consultez la section [Recommandations de filtrage et segments d'utilisateurs](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre maximum de 25 éléments.  
Contraintes relatives à la longueur des clés : longueur maximale de 50.  
Modèle de clé :`[A-Za-z0-9_]+`   
Contraintes de longueur de valeur : longueur maximale de 1000.  
Obligatoire : non

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
Le nombre de résultats à renvoyer. La valeur par défaut est 5. Le maximum est de 100.  
Type : Integer  
Plage valide : Valeur minimum de 0.  
Obligatoire : non

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
ID utilisateur de l'utilisateur pour lequel fournir des recommandations d'action.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Eléments de réponse
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
Liste de recommandations d'action triées par ordre décroissant par score de prédiction. La liste peut contenir un maximum de 100 actions. Pour plus d'informations sur les scores d'action, voir [Fonctionnement de la notation des recommandations d'action](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Type : tableau d’objets [PredictedAction](API_RS_PredictedAction.md)

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
ID de la recommandation.  
Type : Chaîne

## Erreurs
<a name="API_RS_GetActionRecommendations_Errors"></a>

 ** InvalidInputException **   
Entrez une valeur valide pour le champ ou le paramètre.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
La ressource spécifiée n'existe pas.  
Code d’état HTTP :404

## Voir aussi
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations)