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.

# Amazon Personalize Runtime
<a name="API_Operations_Amazon_Personalize_Runtime"></a>

Die folgenden Aktionen werden von Amazon Personalize Runtime unterstützt:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

# 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) 

# GetPersonalizedRanking
<a name="API_RS_GetPersonalizedRanking"></a>

Sortiert eine Liste empfohlener Artikel für den angegebenen Benutzer neu. Das erste Element in der Liste wird als das Element angesehen, das für den Benutzer am wahrscheinlichsten von Interesse ist.

**Anmerkung**  
Die der Kampagne zugrunde liegende Lösung muss mit einem Rezept vom Typ PERSONALIZED\$1RANKING.erstellt worden sein.

## Anforderungssyntax
<a name="API_RS_GetPersonalizedRanking_RequestSyntax"></a>

```
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-Anfrageparameter
<a name="API_RS_GetPersonalizedRanking_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-campaignArn"></a>
Der Amazon-Ressourcenname (ARN) der Kampagne, die für die Erstellung des personalisierten Rankings verwendet werden soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Ja

 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-context"></a>
Die kontextbezogenen Metadaten, die beim Abrufen von Empfehlungen verwendet werden sollen. Zu den kontextuellen Metadaten gehören alle Interaktionsinformationen, die für das Abrufen von Empfehlungen eines Benutzers relevant sein könnten, z. B. der aktuelle Standort oder der Gerätetyp des Benutzers.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Maximale Anzahl von 150 Elementen.  
Einschränkungen der Schlüssellänge: Maximale Länge von 150.  
Schlüssel-Muster: `[A-Za-z\d_]+`   
Längenbeschränkungen für Werte: Maximale Länge von 1000.  
Erforderlich: Nein

 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterArn"></a>
Der Amazon-Ressourcenname (ARN) eines Filters, den Sie erstellt haben, um Artikel für einen bestimmten Benutzer einzubeziehen oder Artikel von Empfehlungen auszuschließen. Weitere Informationen finden Sie unter [Filtern von Empfehlungen](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-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 Elemente 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 Artikel auszuschließen, können Sie das weglassen`filter-values`. In diesem Fall verwendet Amazon Personalize diesen Teil des Ausdrucks nicht, um Empfehlungen zu filtern.  
Weitere Informationen finden Sie unter [Filtern von Empfehlungen](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

 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-inputList"></a>
Eine Liste von Einträgen (nach`itemId`), denen eine Rangfolge zugewiesen werden soll. Wenn ein Element nicht im Trainingsdatensatz enthalten war, wird das Element an das Ende der neu eingestuften Liste angehängt. Wenn Sie Metadaten in Empfehlungen aufnehmen, ist der Höchstwert 50. Andernfalls ist der Höchstwert 500.  
Typ: Zeichenfolgen-Array  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Ja

 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-metadataColumns"></a>
Wenn Sie bei der Erstellung oder Aktualisierung der Kampagne Metadaten in Empfehlungen aktiviert haben, geben Sie Metadatenspalten aus Ihrem Artikeldatensatz an, die in das personalisierte Ranking aufgenommen werden sollen. Der Map-Schlüssel ist `ITEMS` und der Wert ist eine Liste von Spaltennamen aus Ihrem Artikel-Datensatz. Die maximale Anzahl von Spalten, die Sie angeben können, ist 10.  
 Informationen zum Aktivieren von Metadaten für eine Kampagne finden Sie unter [Aktivieren von Metadaten in Empfehlungen für eine Kampagne](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata).   
Typ: Zeichenfolge zu Array von Zeichenfolgen-Mapping  
Karteneinträge: Maximale Anzahl von 1 Element.  
Einschränkungen der Schlüssellänge: Die maximale Länge beträgt 256.  
Array-Mitglieder: Maximale Anzahl von 99 Elementen.  
Längenbeschränkungen: Die maximale Länge beträgt 150.  
Erforderlich: Nein

 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-userId"></a>
Der Benutzer, für den die Kampagne ein personalisiertes Ranking bereitstellen soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Ja

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

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

{
   "personalizedRanking": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Antwortelemente
<a name="API_RS_GetPersonalizedRanking_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.

 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-personalizedRanking"></a>
Eine Liste von Elementen in der Reihenfolge, in der sie für den Benutzer am wahrscheinlichsten von Interesse sind. Das Maximum ist 500.  
Typ: Array von [PredictedItem](API_RS_PredictedItem.md)-Objekten

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

## Fehler
<a name="API_RS_GetPersonalizedRanking_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_GetPersonalizedRanking_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/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 für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK für 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 für 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) 

# GetRecommendations
<a name="API_RS_GetRecommendations"></a>

Gibt eine Liste der empfohlenen Artikel zurück. Für Kampagnen ist der Amazon-Ressourcenname (ARN) der Kampagne erforderlich, und die erforderlichen Benutzer- und Artikeleingaben hängen von dem Rezepttyp ab, mit dem die Kampagne unterstützt wird, wie folgt erstellt wurde:
+ USER\$1PERSONALIZATION — `userId` erforderlich, wird nicht verwendet `itemId`
+ RELATED\$1ITEMS — erforderlich, wird nicht verwendet `itemId` `userId`

**Anmerkung**  
Kampagnen, die auf einer Lösung basieren, die mit einem Rezept vom Typ PERSONALIZED\$1RANKING erstellt wurde, verwenden die API. [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)

 Für Empfehlungsgeber ist der ARN des Empfehlungsgebers erforderlich, und die erforderlichen Artikel- und Benutzereingaben hängen vom Anwendungsfall (domänenbasiertes Rezept) ab, der den Empfehlungsgeber unterstützt. Informationen zu den Anforderungen für Anwendungsfälle finden Sie unter Anwendungsfälle für Empfehlungsgeber [auswählen](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). 

## Anforderungssyntax
<a name="API_RS_GetRecommendations_RequestSyntax"></a>

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

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "itemId": "string",
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "numResults": number,
   "promotions": [ 
      { 
         "filterArn": "string",
         "filterValues": { 
            "string" : "string" 
         },
         "name": "string",
         "percentPromotedItems": number
      }
   ],
   "recommenderArn": "string",
   "userId": "string"
}
```

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

Die Anforderung verwendet keine URI-Parameter.

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-campaignArn"></a>
Der Amazon-Ressourcenname (ARN) der Kampagne, die zum Abrufen von Empfehlungen verwendet werden soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [context](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-context"></a>
Die kontextuellen Metadaten, die beim Abrufen von Empfehlungen verwendet werden sollen. Zu den kontextuellen Metadaten gehören alle Interaktionsinformationen, die für das Abrufen von Empfehlungen eines Benutzers relevant sein könnten, z. B. der aktuelle Standort oder der Gerätetyp des Benutzers.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Maximale Anzahl von 150 Elementen.  
Einschränkungen der Schlüssellänge: Maximale Länge von 150.  
Schlüssel-Muster: `[A-Za-z\d_]+`   
Längenbeschränkungen für Werte: Maximale Länge von 1000.  
Erforderlich: Nein

 ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-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 aktiviert ist`ACTIVE`.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-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 Elemente 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 Artikel auszuschließen, können Sie das weglassen`filter-values`. In diesem Fall verwendet Amazon Personalize diesen Teil des Ausdrucks nicht, um Empfehlungen zu filtern.  
Weitere Informationen finden Sie unter [Filtern von Empfehlungen und](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) Benutzersegmenten.  
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

 ** [itemId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-itemId"></a>
Die Artikel-ID, für die Empfehlungen abgegeben werden sollen.  
Erforderlich für den `RELATED_ITEMS` Rezepttyp.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

 ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-metadataColumns"></a>
Wenn Sie bei der Erstellung oder Aktualisierung der Kampagne oder Empfehlung Metadaten in Empfehlungen aktiviert haben, geben Sie die Metadatenspalten aus Ihrem Artikel-Datensatz an, die in die Artikelempfehlungen aufgenommen werden sollen. Der Map-Schlüssel ist `ITEMS` und der Wert ist eine Liste von Spaltennamen aus Ihrem Artikel-Datensatz. Die maximale Anzahl von Spalten, die Sie angeben können, ist 10.  
 Informationen zum Aktivieren von Metadaten für eine Kampagne finden Sie unter [Aktivieren von Metadaten in Empfehlungen für eine Kampagne](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata). Informationen zum Aktivieren von Metadaten für einen Empfehlungsgeber finden Sie unter [Aktivieren von Metadaten in Empfehlungen für einen Empfehlungsgeber](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata).   
Typ: Zeichenfolge zu Array von Zeichenfolgen-Mapping  
Karteneinträge: Maximale Anzahl von 1 Element.  
Einschränkungen der Schlüssellänge: Die maximale Länge beträgt 256.  
Array-Mitglieder: Maximale Anzahl von 99 Elementen.  
Längenbeschränkungen: Die maximale Länge beträgt 150.  
Erforderlich: Nein

 ** [numResults](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-numResults"></a>
Die Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 25. Wenn Sie Metadaten in Empfehlungen einbeziehen, ist der Höchstwert 50. Andernfalls ist der Höchstwert 500.  
Typ: Ganzzahl  
Gültiger Bereich: Mindestwert 0.  
Erforderlich: Nein

 ** [promotions](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-promotions"></a>
Die Werbeaktionen, die für die Empfehlungsanfrage gelten sollen. Eine Werbeaktion definiert zusätzliche Geschäftsregeln, die für eine konfigurierbare Teilmenge empfohlener Artikel gelten.  
Typ: Array von [Promotion](API_RS_Promotion.md)-Objekten  
Array-Mitglieder: Maximale Anzahl von 1 Element.  
Erforderlich: Nein

 ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-recommenderArn"></a>
Der Amazon-Ressourcenname (ARN) des Empfehlungsgebers, der zum Abrufen von Empfehlungen verwendet werden soll. Geben Sie einen Empfehlungs-ARN an, wenn Sie eine Domain-Datensatzgruppe mit einem Empfehlungsgeber für einen Domain-Anwendungsfall erstellt haben.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [userId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-userId"></a>
Die Benutzer-ID, für die Empfehlungen gegeben werden sollen.  
Erforderlich für den `USER_PERSONALIZATION` Rezepttyp.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

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

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

{
   "itemList": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Antwortelemente
<a name="API_RS_GetRecommendations_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.

 ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-itemList"></a>
Eine Liste von Empfehlungen, sortiert in absteigender Reihenfolge nach dem Prognosewert. Die Liste kann maximal 500 Elemente enthalten.  
Typ: Array von [PredictedItem](API_RS_PredictedItem.md)-Objekten

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

## Fehler
<a name="API_RS_GetRecommendations_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_GetRecommendations_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/GetRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations)