Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Le seguenti azioni sono supportate da Amazon Personalize Runtime:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

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

Restituisce un elenco di azioni consigliate in ordine decrescente per punteggio di previsione. Utilizza l'`GetActionRecommendations`API se disponi di una campagna personalizzata che distribuisce una versione della soluzione addestrata con una ricetta PERSONALIZED\$1ACTIONS. 

[Per ulteriori informazioni sulle ricette PERSONALIZED\$1ACTIONS, consulta le ricette PERSONALIZED\$1ACTIONS.](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html) [Per ulteriori informazioni su come ottenere consigli sulle azioni da intraprendere, consulta Ottenere consigli sulle azioni da intraprendere.](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html)

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per ottenere consigli sulle azioni da intraprendere. Questa campagna deve implementare una versione della soluzione addestrata con una ricetta PERSONALIZED\$1ACTIONS.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Quando utilizzate questo parametro, assicuratevi che la risorsa del filtro sia`ACTIVE`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
I valori da usare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere azioni, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere azioni, è possibile omettere il`filter-values`. In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta [Consigli di filtraggio e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
Il numero di risultati da restituire. Il predefinito è 5. Il massimo è 100.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0.  
Obbligatorio: no

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
L'ID utente dell'utente per cui fornire consigli sulle azioni.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
Un elenco di consigli sulle azioni ordinati in ordine decrescente in base al punteggio di previsione. L'elenco può contenere un massimo di 100 azioni. Per informazioni sui punteggi delle azioni, vedi [Come funziona il punteggio delle azioni consigliate](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Tipo: matrice di oggetti [PredictedAction](API_RS_PredictedAction.md)

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations) 

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

Riordina un elenco di elementi consigliati per un determinato utente. Il primo elemento dell'elenco è considerato quello con più probabilità di interesse per l'utente.

**Nota**  
La soluzione di supporto della campagna deve essere stata creata con una ricetta di tipo PERSONALIZED\$1RANKING.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetPersonalizedRanking_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetPersonalizedRanking_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per generare il ranking personalizzato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-context"></a>
I metadati contestuali da utilizzare per ricevere consigli. I metadati contestuali includono tutte le informazioni di interazione che potrebbero essere rilevanti per ottenere i consigli di un utente, come la posizione corrente dell'utente o il tipo di dispositivo.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 150 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 150.  
Modello di chiave:`[A-Za-z\d_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterArn"></a>
L'Amazon Resource Name (ARN) di un filtro che hai creato per includere o escludere articoli dai consigli per un determinato utente. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterValues"></a>
I valori da utilizzare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere elementi, puoi omettere `filter-values` .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-inputList"></a>
Un elenco di elementi (per`itemId`) da classificare. Se un elemento non è stato incluso nel set di dati di addestramento, l'elemento viene aggiunto alla fine dell'elenco riclassificato. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: sì

 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-metadataColumns"></a>
Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna, specifica le colonne di metadati del set di dati Items da includere nella classifica personalizzata. La chiave della mappa è `ITEMS` e il valore è un elenco di nomi di colonne dal set di dati Items. Il numero massimo di colonne che puoi fornire è 10.  
 Per informazioni sull'abilitazione dei metadati per una campagna, consulta [Attivazione dei metadati nei consigli per una](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) campagna.   
Tipo: mappatura da stringa a matrice di stringhe  
Voci sulla mappa: numero massimo di 1 elemento.  
Limiti di lunghezza della chiave: lunghezza massima di 256.  
Membri dell'array: numero massimo di 99 elementi.  
Vincoli di lunghezza: lunghezza massima di 150.  
Obbligatorio: no

 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-userId"></a>
L'utente per il quale desideri che la campagna fornisca un posizionamento personalizzato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: sì

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_RS_GetPersonalizedRanking_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-personalizedRanking"></a>
Un elenco di elementi in ordine di maggiore probabile interesse per l'utente. Il massimo è 500.  
Tipo: matrice di oggetti [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

## Errori
<a name="API_RS_GetPersonalizedRanking_Errors"></a>

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetPersonalizedRanking_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 

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

Restituisce un elenco di articoli consigliati. Per le campagne, è richiesto l'Amazon Resource Name (ARN) della campagna e l'input richiesto per l'utente e l'articolo dipende dal tipo di ricetta utilizzato per creare la soluzione a supporto della campagna, come segue:
+ USER\$1PERSONALIZATION: obbligatorio, non utilizzato `userId` `itemId`
+ RELATED\$1ITEMS: obbligatorio, non utilizzato `itemId` `userId`

**Nota**  
Le campagne supportate da una soluzione creata utilizzando una ricetta di tipo PERSONALIZED\$1RANKING utilizzano l'API. [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)

 Per i consiglieri, l'ARN del consulente è obbligatorio e l'elemento richiesto e l'input dell'utente dipendono dal caso d'uso (ricetta basata sul dominio) che supporta il programma di raccomandazione. [Per informazioni sui requisiti dei casi d'uso, vedi Scelta dei casi d'uso dei consiglieri.](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html) 

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetRecommendations_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetRecommendations_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per ricevere consigli.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [context](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-context"></a>
I metadati contestuali da utilizzare per ricevere consigli. I metadati contestuali includono tutte le informazioni di interazione che potrebbero essere rilevanti per ottenere i consigli di un utente, come la posizione corrente dell'utente o il tipo di dispositivo.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 150 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 150.  
Modello di chiave:`[A-Za-z\d_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterArn"></a>
L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Quando utilizzate questo parametro, assicuratevi che la risorsa del filtro sia`ACTIVE`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterValues"></a>
I valori da usare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere elementi, puoi omettere `filter-values` .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta [Filtrare consigli e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [itemId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-itemId"></a>
L'ID dell'articolo per cui fornire consigli.  
Obbligatorio per il tipo di `RELATED_ITEMS` ricetta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

 ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-metadataColumns"></a>
Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna o il programma di raccomandazione, specifica le colonne di metadati del set di dati Items da includere nei consigli sugli articoli. La chiave della mappa è `ITEMS` e il valore è un elenco di nomi di colonne dal set di dati Items. Il numero massimo di colonne che puoi fornire è 10.  
 Per informazioni sull'abilitazione dei metadati per una campagna, consulta [Attivazione dei metadati nei consigli per una](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) campagna. Per informazioni sull'abilitazione dei metadati per un programma di raccomandazione, consulta [Abilitazione dei metadati nei](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata) consigli per un consigliatore.   
Tipo: mappatura da stringa a matrice di stringhe  
Voci sulla mappa: numero massimo di 1 elemento.  
Limiti di lunghezza della chiave: lunghezza massima di 256.  
Membri dell'array: numero massimo di 99 elementi.  
Vincoli di lunghezza: lunghezza massima di 150.  
Obbligatorio: no

 ** [numResults](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-numResults"></a>
Il numero di risultati da restituire. Il valore predefinito è 25. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0.  
Obbligatorio: no

 ** [promotions](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-promotions"></a>
Le promozioni da applicare alla richiesta di raccomandazione. Una promozione definisce regole aziendali aggiuntive che si applicano a un sottoinsieme configurabile di articoli consigliati.  
Tipo: matrice di oggetti [Promotion](API_RS_Promotion.md)  
Membri dell'array: numero massimo di 1 elementi.  
Obbligatorio: no

 ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione da utilizzare per ricevere consigli. Fornisci un ARN di raccomandazione se hai creato un gruppo di set di dati di dominio con un programma di raccomandazione per un caso d'uso del dominio.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [userId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-userId"></a>
L'ID utente per cui fornire consigli.  
Obbligatorio per il tipo di `USER_PERSONALIZATION` ricetta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_RS_GetRecommendations_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-itemList"></a>
Un elenco di consigli ordinati in ordine decrescente per punteggio di previsione. L'elenco può contenere un massimo di 500 elementi.  
Tipo: matrice di oggetti [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

## Errori
<a name="API_RS_GetRecommendations_Errors"></a>

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetRecommendations_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations)