Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Gibt eine Liste empfohlener Aktionen zurück, sortiert in absteigender Reihenfolge nach dem Prognosewert. Verwenden Sie die `GetActionRecommendations` API, wenn Sie eine benutzerdefinierte Kampagne haben, die eine Lösungsversion bereitstellt, die nach einem Rezept von PERSONALIZED\$1ACTIONS trainiert wurde. 

[Weitere Informationen über PERSONALIZED\$1ACTIONS-Rezepte finden Sie unter PERSONALIZED\$1ACTIONS-Rezepte.](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html) [Weitere Informationen zum Abrufen von Handlungsempfehlungen finden Sie unter Abrufen von Handlungsempfehlungen.](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html)

## Anforderungssyntax
<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"
}
```

## URI-Anfrageparameter
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
Der Amazon-Ressourcenname (ARN) der Kampagne, die verwendet werden soll, um Handlungsempfehlungen zu erhalten. Diese Kampagne muss eine Lösungsversion bereitstellen, die mit einem PERSONALIZED\$1ACTIONS-Rezept trainiert wurde.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
Der ARN des Filters, der auf die zurückgegebenen Empfehlungen angewendet werden soll. Weitere Informationen finden Sie unter [Filtern von Empfehlungen](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Wenn Sie diesen Parameter verwenden, stellen Sie sicher, dass die Filterressource `ACTIVE`  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
Die Werte, die beim Filtern von Empfehlungen verwendet werden sollen. Geben Sie für jeden Platzhalterparameter in Ihrem Filterausdruck den Parameternamen (bei entsprechender Groß- und Kleinschreibung) als Schlüssel und die Filterwerte als entsprechenden Wert an. Trennen Sie mehrere Werte für einen Parameter durch ein Komma.   
Für Filterausdrücke, die ein `INCLUDE` Element verwenden, um Aktionen einzuschließen, müssen Sie Werte für alle Parameter angeben, die im Ausdruck definiert sind. Bei Filtern mit Ausdrücken, die ein `EXCLUDE` Element verwenden, um Aktionen auszuschließen, können Sie das `filter-values` weglassen. In diesem Fall verwendet Amazon Personalize diesen Teil des Ausdrucks nicht zum Filtern von Empfehlungen.  
Weitere Informationen finden Sie unter [Filtern von Empfehlungen und Benutzersegmenten](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Maximale Anzahl von 25 Elementen.  
Einschränkungen der Schlüssellänge: Maximale Länge von 50.  
Schlüssel-Muster: `[A-Za-z0-9_]+`   
Längenbeschränkungen für Werte: Maximale Länge von 1000.  
Erforderlich: Nein

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
Die Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 5. Das Maximum ist 100.  
Typ: Ganzzahl  
Gültiger Bereich: Mindestwert 0.  
Erforderlich: Nein

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
Die Benutzer-ID des Benutzers, für den Handlungsempfehlungen gegeben werden sollen.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

## Antwortsyntax
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
Eine Liste von Handlungsempfehlungen, sortiert in absteigender Reihenfolge nach dem Prognosewert. Die Liste kann maximal 100 Aktionen enthalten. Informationen zu Maßnahmenwerten finden Sie unter [Funktionsweise der Bewertung von Aktionsempfehlungen](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Typ: Array von [PredictedAction](API_RS_PredictedAction.md)-Objekten

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
Die ID der Empfehlung.  
Typ: Zeichenfolge

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

 ** InvalidInputException **   
Geben Sie einen gültigen Wert für das Feld oder den Parameter an.  
HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP-Statuscode: 404

## Weitere Informationen finden Sie unter:
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle 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 für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK für 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 für 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)